Eu tentei de tudo. Servidores AWS, configurações remotas, chaves de API erradas, modelos errados. Queimei cerca de US$ 800 só em tokens da API da Anthropic. Tentei Kimi. Tentei 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.
Esta é agora a melhor e mais simples forma de fazer um agente de IA funcionar. Tão útil que até a 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
Resolva 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. Crie as contas. Copie suas chaves em um lugar seguro ou nas suas anotações, prontas para copiar e colar. Confie em mim — ter tudo alinhado 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 laptop velho, etc. — mas, claro, neste caso, Mac Minis.
Pessoalmente? Comprei um Mac Mini M4 novo. 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 rapidinho. Estou no Claude Max (US$ 90/mês), que me 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 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 dão.
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, para ser honesto!
Telegram — você precisará criar um bot através do BotFather. Gratuito. Leva dois minutos e vamos explicar isso mais adiante, se precisar de ajuda.
Quatro contas. Esse é o núcleo. 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ça isso.
O Claude Pro/Max te dá uma taxa mensal fixa com muito mais valor. Você quer o token da sua conta do Claude — não uma chave do console da Anthropic. Vou explicar exatamente onde encontrar isso durante a configuração.
Eu cometi esse mesmo erro. Gastei cerca de US$ 800 no total tentando Kimi, Opus, vários agentes, todos por uso. A jogada certa é 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 elas durante a configuração, e é irritante ter que ficar procurando no meio do processo.
Um aviso para quem precisa pegar o token do Claude, que provavelmente é todo mundo a esta altura — então precisamos instalar o Claude no seu Mac Mini rapidinho. Para fazer isso, basta abrir o Terminal (Aplicativos — pasta Utilitários — app Terminal) e digitar:
1curl -fsSL https://claude.ai/install.sh | bash
Isso deve começar e abrir uma verificação/login. Neste ponto, você terá o Claude instalado. Agora? Feche o Terminal, abra uma nova janela novamente. E agora digite:
1claude setup-token
Isso vai rodar alguns visuais divertidos, 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 ser copiado com um 'espaço' no token. Você PRECISA remover esse espaço para evitar erros.
Passo 2 — instalar o Homebrew
Simples de novo, 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 à parte emocionante.
Passo 4 — integração!
Quando você iniciar a integração do OpenClaw, aperte 'sim' no Aviso Legal. Um lembrete rápido: para controlar as opções, você precisa:
*Aperte a Barra de Espaço para selecionar
Aperte Enter para avançar
Use as setas do teclado para selecionar ou mover para cima/baixo/esquerda/direita*
Bem, daqui em diante, aperte Início Rápido, e agora é hora de se integrar.
Isso te guia por tudo. Agora, esta é a parte que fica específica — ele vai perguntar qual modelo você quer usar — você vai selecionar ANTHROPIC — e então mais 3 opções aparecerão — você vai 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ço!
Passo 5 — conectando o Telegram
Em seguida, você verá uma lista de configuração de comunicações — contendo todos os tipos de opções — por hoje, vamos manter a simplicidade. Selecione Telegram. Será solicitado que você apresente sua chave de API — se você a tiver pronta desde a nossa introdução, pule para o próximo passo. Se não a tiver, é rapidinho.
Abra o Telegram, procure por @BotFather, envie uma 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 dá 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 ao usar o BotFather — ele te diz a maior parte disso de qualquer forma!
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 skills em vez de agentes e por que o Discord é perfeito para isso.
Passo 6 — suas primeiras skills
Em seguida, você será solicitado a configurar suas primeiras skills — então aperte sim e vamos nessa. Você pode usar npm ou bun aqui, mas para fins deste exemplo com um Mac Mini — aperte selecionar e continue com 'npm'.
Forneça uma legenda (opcional)
Em seguida — você verá uma longa lista de skills — vamos apenas apertar 'pular por agora' nelas, não precisamos desse barulho agora. Forneça uma legenda (opcional) e, finalmente — ele vai perguntar se você quer instalar 6 skills para lugares do Google e mais — apenas aperte 'não' em todas elas, sendo a última a elevenlabs.
Novamente, mais barulho, apenas pule.
Forneça uma legenda (opcional)
Última parte agora — você será perguntado sobre ativar hooks. Aqui — selecione todos os três, usando as setas e a barra de espaço novamente — e aperte 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 chocar
Forneça uma legenda (opcional) Chegou a hora, do seu bot nascer! Aqui, selecione hatch no TUI, que vai acordar seu bot pela primeira vez dentro do aplicativo Terminal. Se você receber um erro HTTPS aqui, verifique seu token do Claude em busca de espaços. Essa é quase sempre a causa. Correção simples — apenas cole novamente sem espaços à direita. 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 bebê bot está perguntando qual é o nome dele e o seu nome! Normalmente, eu envio algo assim e os mando direto para o Telegram para conversar:
"Ei, seu nome é [insiraonomebot], 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 pede uma chave de pareamento. Digite isso na mensagem do TUI. O Telegram deve estar conectado e seu bot responderá lá.
Esse é o seu momento "p*ta que pariu". Aproveite. Você agora tem um bot OpenClaw.
Passo Final e Rápido Adicional — adicione Brave, Groq e QMD.
Quase pronto. Agora, apenas converse com seu bot recém-nascido e diga a ele para 'configurar o Brave Search — aqui está minha chave de API e simplesmente cole sua chave do Brave Search.
Depois, 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 skill QMD — antes de começar a carregar seu agente com conversas e tarefas. Quando você a instala no meio do caminho, seu agente luta para acompanhar e muitas vezes reinicia ou esquece os registros de chat. Livre-se dessa dor de cabeça. Instale-a desde o início e simplesmente peça para 'instalar a skill QMD' — ele fará isso para você.
Agora? Vamos em frente.
Faça 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. OpenClaw usa três arquivos que definem quem é seu agente:
SOUL.md - a personalidade do seu agente. Como ele fala. Com o que ele se importa. 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 que se lembre das coisas entre as conversas.
Você poderia escrever tudo isso sozinho. Ou você poderia fazer o que eu fiz. Deixe seu agente entrevistar você. Quando 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-as uma de cada vez. Depois, use minhas respostas para preencher SOUL.md e USER.md."
Seu agente faz de 10 a 15 perguntas.
Responda honestamente.
Conte sua situação real — seu trabalho, seus projetos paralelos, sua agenda, o quão informal você quer que 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á contexto adequado. Ele saberá quem você é. Ele se lembrará. Esta é a diferença entre um chatbot e algo que realmente parece seu.
Skills 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 skills e extrair o máximo do seu bot OpenClaw. Para finalizar — Todos os erros que cometi para que você não precise 1. Pagou por uso em vez de Claude Max. Queimou cerca de US$ 800 tentando a API da Anthropic, Kimi, Opus, rodando vários agentes por uso. Pegue a assinatura. Use o token. É só isso. 2. Rodou 8 agentes no Telegram ao mesmo tempo. Cérebros diferentes, contextos diferentes, perdendo o controle constantemente. Um agente com skills adequadas vence um esquadrão de confusos todas as vezes. 3. Gastou centenas em servidores AWS. Configurações remotas, configurações complicadas. Um Mac Mini ao lado da sua TV faz o mesmo trabalho com menos complicação. 4. Deixou seus arquivos de contexto vazios por uma semana. Se perguntou por que seu agente parecia um call center. Preencheu SOUL.md e USER.md. Diferença do dia para a noite. 5. Instalou QMD no meio do caminho. Agente ficava reiniciando e perdendo registros de chat. Instale desde o início. 6. Ignorou mensagens de voz. Configure o Groq no primeiro dia. Conversar com seu agente enquanto você está em movimento é uma experiência completamente diferente. Meu agente transcreve áudios enquanto estou em movimento e eu uso isso dez vezes mais do que digitar. 7. Tinha um espaço no token do Claude. Recebeu um erro HTTPS que me confundiu por uma hora. Verifique espaços à direita. Correção simples. Se você gostou, 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. Feliz em ajudar. Se quiser ir ainda mais fundo ou aprender algumas skills avançadas, dê uma olhada no meu amigo @oliverhenry. Ele tem alguns artigos brilhantes sobre como levar tudo ao próximo nível.
Valeu, @jordymaui
