Tentei de tudo. Servidores AWS, configurações remotas, chaves de API erradas, modelos errados. Gastei cerca de US$ 800 só em tokens da API da Anthropic. Testei o Kimi. Testei o Opus. Tinha 8 agentes rodando no Telegram ao mesmo tempo com cérebros diferentes e o contexto sempre se perdia. Cada um esquecia o que o outro estava fazendo. Cometi todos os erros possíveis.
Este é agora o melhor e mais simples jeito de fazer um agente de IA funcionar. Tão útil que até sua mãe usaria um.
Se você sabe copiar e colar, você e sua mãe conseguem fazer isso.
O que você realmente precisa antes de começar
Providencie tudo isso antes de mexer no Terminal ou no OpenClaw (não se preocupe se você ainda nem sabe o que é isso). Abra as abas. Cadastre-se nos serviços. Copie suas chaves em um lugar seguro ou nas suas anotações, prontas para copiar e colar. Acredite em mim – ter tudo organizado economiza uma hora de xingamentos para a tela.
A máquina – seu futuro bot
Qualquer coisa com que você se sinta confortável dentro do seu orçamento. Você só precisa de especificações mínimas – 2 GB de RAM, alguns núcleos de CPU (de novo, coisas de nerd, mas hardware básico e barato), 20 GB de armazenamento no mínimo. Qualquer computador que fique ligado. Um notebook velho etc. – mas, claro, neste caso, Mac Minis.
Pessoalmente? Comprei um M4 Mac Mini novinho. E ele fica do lado da minha TV e funciona 24 horas por dia, 7 dias por semana. Sem monitor, sem teclado. Esse é o Momo.
As quatro contas que você precisa
Conta Claude Pro/Max – este é o cérebro. Você pode começar com o Claude Pro (US$ 20/mês), mas vai ficar sem tokens rápido. Eu uso o Claude Max (US$ 90/mês), que te dá Claude, Claude Code e um monte de uso. Muito mais barato do que pagar por uso pelo console da Anthropic. Mais sobre isso daqui a pouco se parecer algo estranho.
Brave Search (gratuito) – permite que seu agente pesquise na web. Cadastre-se em brave.com/search/api. Leva dois minutos. Copie a chave que eles te derem.
Groq (gratuito) – dá ouvidos ao seu agente. Ele transcreve mensagens de voz para que você possa falar com ele em vez de digitar. Sinceramente, é um divisor de águas quando você está fora de casa. Mas um aviso rápido: o suporte a memorandos de voz do Discord foi adicionado em uma atualização recente, e o áudio do Telegram já vem integrado no OpenClaw automaticamente. Então, se este artigo estiver desatualizado, talvez você nem precise mais do Groq!
Telegram – você precisará criar um bot pelo BotFather. Gratuito. Leva dois minutos e vamos explicar isso mais tarde, se precisar de ajuda.
Quatro contas. Esse é o essencial. Todo o resto vem depois.
O erro que custa centenas de dólares para as pessoas
Muita gente se cadastra no console da Anthropic e começa a pagar por uso. Não façam isso.
O Claude Pro/Max te dá uma taxa mensal fixa com muito mais valor. Você quer o token da sua conta Claude – não uma chave do console da Anthropic. Vou explicar exatamente onde encontrá-lo durante a configuração.
Eu cometi esse erro exato. Gastei cerca de US$ 800 no total testando Kimi, Opus, vários agentes, tudo por uso. A jogada é a assinatura do Claude. Sempre.
A configuração real
Passo 1 – organize-se
Antes de abrir qualquer coisa, tenha todas as quatro chaves prontas. Token do Claude, chave do Brave, chave do Groq, token do bot do Telegram. Anote-as ou mantenha-as em um aplicativo de notas. Você vai precisar de todas durante a configuração, e é chato ter que ficar procurando no meio do processo.
Uma observação para quem precisa pegar o token do Claude, o que provavelmente inclui todo mundo neste estágio – então precisamos instalar o Claude no seu Mac Mini rapidinho. Para fazer isso, basta abrir o Terminal (na pasta Aplicativos > Utilitários > Terminal) e digitar:
1curl -fsSL https://claude.ai/install.sh | bash
Isso deve começar a funcionar e abrir uma tela de verificação/login. Neste ponto, o Claude estará instalado. Agora? Feche o Terminal e abra uma nova janela. Em seguida, digite:
1claude setup-token
Isso vai rodar umas animações legais, mas o mais importante: mostrará sua Chave de Token do Claude. É MUITO importante que você copie e cole isso em algum lugar, como seu aplicativo de notas, porque é muito comum que o token seja copiado com um 'espaço' no meio. Você PRECISA remover esse espaço para evitar erros.
Passo 2 – instalar o Homebrew
Simples de novo. Em uma nova janela do Terminal, cole isto:
1brew install node
Passo 3 – instalar o OpenClaw
Mais uma vez, após instalar o Homebrew/Node.js, você pode simplesmente colar o comando de instalação do OpenClaw no Terminal.
1npm install -g openclaw
Agora, vamos entrar na parte emocionante.
Passo 4 – integração!
Quando você iniciar a integração do OpenClaw, responda 'sim' ao Aviso Legal. Um lembrete rápido: para controlar as opções, você precisa:
*Pressione a Barra de Espaço para selecionar
Pressione Enter para avançar
Use as setas do teclado para selecionar ou mover para cima/baixo/esquerda/direita*
Bom, daqui em diante, escolha Início Rápido, e agora é hora de se integrar.
Isso te guia por todo o processo. Agora vem a parte que exige atenção: ele perguntará qual modelo você quer usar – você selecionará ANTHROPIC – e então aparecerão mais 3 opções – você selecionará a primeira opção TOKEN ANTHROPIC e NÃO a API da Anthropic. ok, acho que deixei isso bem claro, kkk.
Cole o token do Claude que salvamos anteriormente – novamente, verifique se não há espaços!
Passo 5 – conectar o Telegram
Em seguida, você verá uma lista de configurações de comunicação – com todo tipo de opção. Por hoje, vamos manter a simplicidade. Selecione Telegram. Será solicitado que você forneça sua chave de API – se você já a tiver pronta desde a introdução, pule para o próximo passo. Se não tiver, é rápido.
Abra o Telegram, procure por @BotFather, envie a mensagem /newbot. Escolha um nome e um nome de usuário (o nome de usuário deve terminar com "bot", conforme as instruções). O BotFather te dará seu token de API. Copie-o. Agora cole-o de volta no Terminal durante a integração do OpenClaw. Esta foi uma explicação rápida porque é fácil de seguir quando você usa o BotFather – ele já te diz a maior parte disso!
Se quiser saber o que o Momo e eu usamos – é o Discord – mas vou escrever o porquê em outro artigo em breve e como é importante escolher habilidades em vez de agentes e por que o Discord é perfeito para isso.
Passo 6 – suas primeiras habilidades
Em seguida, você será solicitado a configurar suas primeiras habilidades – então responda sim e vamos nessa. Você pode usar npm ou bun aqui, mas, para fins deste exemplo com um Mac Mini, pressione selecionar e continue com 'npm'.
Forneça uma legenda (opcional)
Em seguida, você verá uma longa lista de habilidades – vamos apenas selecionar 'pular por agora' nelas, não precisamos desse barulho agora. Forneça uma legenda (opcional) e, finalmente, ele perguntará se você deseja instalar 6 habilidades para lugares do Google e mais – apenas responda 'não' a todas, sendo a última delas elevenlabs.
Novamente, mais barulho, apenas pule.
Forneça uma legenda (opcional)
Última parte agora: será perguntado sobre a ativação de hooks. Aqui, selecione todos os três, usando as setas e a barra de espaço novamente – e pressione Enter. Estes são necessários para você começar! Depois disso, seu gateway deve iniciar, você verá o Terminal fazendo sua mágica e estará pronto para o passo final...
Passo 7 – hora de nascer
Forneça uma legenda (opcional) Chegou a hora de seu bot nascer! Aqui, selecione 'hatch' no TUI, que irá acordar seu bot pela primeira vez dentro do aplicativo Terminal. Se você receber um erro HTTPS aqui, verifique se há espaços no seu token do Claude. Essa é quase sempre a causa. Correção simples – cole-o novamente sem espaços extras. Talvez seja necessário reiniciar a integração.
Passo 8 – diga olá e finalize a configuração do Telegram
Então, você teve o famoso 'Acorde, amigo' e seu novo bot está perguntando qual é o nome dele e o seu nome! Normalmente, eu envio algo assim e mando ele direto para o Telegram conversar:
"Ei, seu nome é [insiraonomeaqui], meu nome é [seunome], vamos continuar esta conversa no Telegram. Aqui está minha chave de pareamento [coleachaveaqui]."
Agora, se você abrir a conversa do seu bot no Telegram (clique no link que o @BotFather enviou!), ele pedirá uma chave de pareamento. Digite-a na mensagem do TUI. O Telegram deve estar conectado e seu bot responderá por lá.
Esse é o seu momento "p*ta merda". Aproveite. Você agora tem um bot OpenClaw.
Passo Final e Rápido Adicional – adicione Brave, Groq e QMD.
Quase pronto. Agora, basta conversar com seu bot recém-nascido e dizer a ele para 'configurar o Brave Search – aqui está minha chave de API' e simplesmente cole sua chave do Brave Search.
Em seguida, sua chave do Groq com o mesmo tipo de mensagem. Seu agente agora pode pesquisar na web e entender mensagens de voz, e ele faz o trabalho duro de instalar para você!
Agora, termine instalando a habilidade QMD – antes de começar a carregar seu agente com conversas e tarefas. Quando você a instala no meio do caminho, seu agente tem dificuldade em acompanhar e muitas vezes redefine ou esquece os logs de chat. Poupe-se da dor de cabeça. Instale-a desde o início e simplesmente peça a ele para 'instalar a habilidade QMD' – ele fará isso para você.
Agora? Vamos em frente.
Torne-o seu – esta é a parte que realmente importa!
A maioria das pessoas pula isso e depois se pergunta por que seu agente parece um robô de atendimento ao cliente. O OpenClaw usa três arquivos que definem quem é seu agente:
SOUL.md – a personalidade do seu agente. Como ele fala. O que importa para ele. Seu estilo.
USER.md – informações sobre você. Seu nome, seu trabalho, suas preferências, seus hábitos estranhos.
MEMORY.md – memória de longo prazo. Seu agente atualiza isso ao longo do tempo para lembrar de coisas entre as conversas.
Você poderia escrever tudo isso sozinho. Ou poderia fazer o que eu fiz. Deixe seu agente te entrevistar. Assim que seu agente responder no Telegram, envie algo como:
"Você acabou de ficar online pela primeira vez. Quero que você me faça perguntas para me conhecer – meu nome, o que eu faço, meus objetivos, como quero que você fale comigo, quais ferramentas uso diariamente, com o que preciso de ajuda. Faça uma pergunta de cada vez. Depois, use minhas respostas para preencher SOUL.md e USER.md."
Seu agente fará de 10 a 15 perguntas.
Responda com honestidade.
Conte a ele sua situação real – seu trabalho, seus projetos paralelos, sua agenda, o quão casual você quer que ele seja.
Dica de ouro – responda com um áudio. É muito mais rápido e você dará respostas mais naturais do que digitando. Ao final disso, seu agente terá o contexto adequado. Ele saberá quem você é. Ele se lembrará. Essa é a diferença entre um chatbot e algo que realmente parece ser seu.
Habilidades vs. agentes – é aqui que as pessoas desperdiçam dinheiro
Aqui é onde a maioria das pessoas erra. E eu sei porque errei aqui também. Você verá configurações online com cinco agentes, dez agentes, um "cérebro de colmeia" com agentes conversando com agentes. Parece o Jarvis. Parece o futuro. Também é caro, confuso e, honestamente, na maioria das vezes, bobagem. Fique ligado em um artigo de acompanhamento sobre como configurar habilidades e obter o máximo do seu bot OpenClaw. Para finalizar – Todos os erros que cometi para que você não precise cometê-los 1. Paguei por uso em vez de Claude Max. Gastei cerca de US$ 800 tentando a API da Anthropic, Kimi, Opus, executando vários agentes por uso. Pegue a assinatura. Use o token. Só isso. 2. Executei 8 agentes no Telegram ao mesmo tempo. Cérebros diferentes, contextos diferentes, perdendo o fio da meada constantemente. Um agente com habilidades adequadas vence um bando de agentes confusos todas as vezes. 3. Gastei centenas de dólares em servidores AWS. Configurações remotas, configurações complicadas. Um Mac Mini do lado da sua TV faz o mesmo trabalho com menos complicação. 4. Deixei meus arquivos de contexto vazios por uma semana. Me perguntei por que meu agente parecia um call center. Preenchi SOUL.md e USER.md. Diferença da noite para o dia. 5. Instalei o QMD no meio do caminho. O agente ficava redefinindo e perdendo logs de chat. Instale-o desde o início. 6. Ignorei mensagens de voz. Configurei o Groq no primeiro dia. Falar com seu agente enquanto você está em movimento é uma experiência completamente diferente. Meu agente transcreve áudios enquanto estou na rua e eu o uso dez vezes mais do que digitar. 7. Havia um espaço no meu token do Claude. Recebi um erro HTTPS que me confundiu por uma hora. Verifique se há espaços no final. Correção simples. Se você gostou disso, me siga. Compartilhe. Salve nos favoritos. O que ajudar. Sou novo em escrever artigos e estou muito orgulhoso de que este é o meu primeiro. Perguntas? Deixe-as abaixo. Ficarei feliz em ajudar. Se quiser se aprofundar ainda mais ou aprender algumas habilidades avançadas, dê uma olhada no meu amigo @oliverhenry. Ele tem alguns artigos brilhantes sobre como levar tudo ao próximo nível.
Um abraço, @jordymaui
