Como criar um agente de IA: Hermes, Claude Code, Codex, Grok Bot e outros, passo a passo

Resumo: um agente de IA é um modelo (Claude, GPT, Grok, Gemini) rodando dentro de um programa que dá a ele ferramentas: ler e escrever arquivos, rodar comandos, navegar, lembrar de você, trabalhar em horário marcado e responder no Telegram ou no WhatsApp. Esse programa se chama harness. Para montar o seu, você escolhe um harness e conecta um login de modelo: a assinatura que já paga, uma chave de API ou uma conta no OpenRouter.

Transparência: a NMC é feita com Hermes, Claude Code e Grok Bot, que estão nesta lista.

Qual escolher

• Quero um assistente no Telegram ou no WhatsApp que roda 24 horas, com memória e tarefas agendadas: Hermes Agent. OpenClaw é a alternativa mais parecida.
• Já pago Claude Pro ou Max e quero programar ou automatizar coisas no computador: Claude Code.
• Já pago ChatGPT Plus ou Pro: Codex.
• Não quero instalar nada no terminal e tenho (ou topo pagar) o plano Premium da X Subscription: Grok Bot. Ele roda num computador na nuvem e continua trabalhando com o notebook fechado.
• Quero algo mínimo, que funcione com qualquer modelo: Pi ou OpenCode.
• Quero ver vários agentes (Claude Code, Codex, Grok e outros) numa tela só, com acesso pelo celular: OpenBot.
• Quero começar de graça: Antigravity CLI, do Google, com uma conta Google comum. O OpenCode também tem modelos gratuitos.

Comparação rápida

Antes de começar

Terminal. Quase todos os harnesses se instalam colando um comando no terminal. No Mac, abra o app Terminal (Cmd+Espaço, digite "Terminal"). No Windows, abra o PowerShell pelo menu Iniciar (vários também rodam no WSL2, um Linux dentro do Windows). Depois de instalar, feche e abra o terminal para o comando novo ser reconhecido.

Node ou Python. Os instaladores oficiais de Hermes, Claude Code, Codex, Pi e OpenClaw já baixam o que precisam. Você só precisa do Node.js instalado se escolher instalar pelo npm (Codex, Pi, OpenCode, OpenClaw) ou se for usar o WhatsApp no Hermes (Node 18 ou mais novo). Baixe em nodejs.org.

Um login de modelo. O harness é o corpo; o modelo é o cérebro, e alguém paga por ele:

• Assinatura (Claude Pro/Max, ChatGPT Plus/Pro, X Subscription): valor fixo por mês, com a mesma conta do chat. É o mais previsível: se acabar o limite, o agente para até renovar, e a conta não cresce. Em geral, cada empresa libera a assinatura só nos próprios programas; as exceções estão em cada seção.
• Chave de API: você cria uma chave no painel do fornecedor e paga por uso. Funciona em qualquer harness, mas um agente faz muitas chamadas por tarefa e a conta sobe rápido. Ponha um limite de gasto no painel antes.
• OpenRouter: uma conta com créditos pré-pagos e uma chave para centenas de modelos de várias empresas. Bom para testar modelos e controlar gasto com limite por chave (seção "OpenRouter em 5 minutos", abaixo).

Três regras desde o primeiro dia:

1. Nunca cole uma chave de API em chat, e-mail, print ou repositório. Ela é uma senha que gasta dinheiro.
2. Comece numa pasta de teste (por exemplo ~/agente-teste) com cópias de arquivos, não na sua pasta de documentos inteira.
3. Leia o que o agente pede para executar antes de aprovar, pelo menos nas primeiras semanas.

Hermes Agent

O Hermes Agent é um agente open source (MIT) da Nous Research que roda no seu computador ou num servidor e conversa pelo terminal, por um app de desktop ou por mais de 20 plataformas de mensagem (Telegram, WhatsApp, Discord, Slack, Signal e outras). Guarda memória entre conversas, cria skills (procedimentos reaproveitáveis) a partir do que aprende e roda tarefas agendadas que entregam o resultado no seu chat.

Prós

• Feito para ficar ligado: o mesmo agente atende no Telegram, no WhatsApp e no terminal.
• Aceita quase todo login: Nous Portal, ChatGPT, SuperGrok ou X Premium+, Claude Max com créditos extras, chaves de API, OpenRouter e modelos locais.
• Memória persistente, skills e agendamento em linguagem natural.
• Gratuito; importa configurações do Claude Code, Codex, OpenClaw ou Cursor.

Contras

• Muitas opções; a primeira configuração leva mais tempo que a de um app pronto.
• Para responder 24 horas, precisa de uma máquina sempre ligada.
• O WhatsApp usa uma ponte não oficial, com risco de restrição da conta.
• Com Claude, a assinatura só vale no Max e consome apenas créditos extras pagos à parte.

Preço

O Hermes é gratuito; o custo é o do modelo. O caminho mais simples é o Nous Portal, da própria Nous: Free (US$ 0, só modelos gratuitos), Plus (US$ 20/mês), Super (US$ 100/mês) e Ultra (US$ 200/mês). Os pagos incluem uso do Hermes com limites diários, semanais e mensais, ferramentas como busca na web e um agente hospedado na nuvem.

Como instalar

1. A forma mais fácil no Mac (Apple Silicon) e no Windows é o app de desktop: baixe o pacote no site do Hermes, abra e siga as telas.
2. Para instalar só a versão de terminal no Mac, Linux ou WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

3. No Windows, sem o app, abra o PowerShell e rode:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

4. Recarregue o terminal e abra o Hermes:

source ~/.zshrc   # ou: source ~/.bashrc
hermes

5. Se algo der errado, rode hermes doctor, que diagnostica a instalação.

Como autenticar

Rode o assistente de configuração. Ele oferece três modos: Quick Setup (login no Nous Portal, sem chaves), Full Setup (você escolhe provedor e ferramentas) e Blank Slate (o mínimo possível).

hermes setup

Depois, para trocar de provedor ou modelo a qualquer momento:

hermes model

Os caminhos mais comuns:

• Nous Portal (o mais simples):
  1. Rode hermes setup --portal.
  2. Faça login no navegador e escolha o modelo.
• Assinatura do ChatGPT (Plus, Pro):
  1. Rode hermes model.
  2. Escolha ChatGPT or Codex Subscription e confirme o código no navegador.
• Claude (Anthropic):
  1. Com plano Max e créditos de uso extra comprados: hermes model, escolha Anthropic e faça login. O Hermes consome só os créditos extras, nunca o uso incluído no Max.
  2. Com plano Pro: o login não funciona. Use uma chave de API do Console da Anthropic, cobrada por uso: hermes config set ANTHROPIC_API_KEY sk-ant-... e depois hermes model.
• SuperGrok ou X Premium+:
  1. Rode hermes model e escolha xAI Grok OAuth (SuperGrok / X Premium+).
  2. Aprove no navegador. Se o login funcionar mas as respostas derem erro 403, a xAI está bloqueando seu nível de assinatura; use uma chave XAI_API_KEY.
• OpenRouter:
  1. Crie a chave (veja a seção do OpenRouter).
  2. Rode hermes config set OPENROUTER_API_KEY sk-or-... e escolha o modelo com hermes model.

Segredos ficam em ~/.hermes/.env e configurações em ~/.hermes/config.yaml; use hermes config set, que põe cada valor no arquivo certo.

Primeiro teste

Abra o Hermes dentro da pasta de teste e peça:

cd ~/agente-teste
hermes

"Liste os arquivos desta pasta, agrupe os PDFs por ano no nome ou na data de modificação e me mostre o plano antes de mover qualquer coisa."

Depois teste a memória: "Lembre que meus relatórios saem toda segunda"; numa conversa nova, pergunte quando eles saem.

Hermes no Telegram

O Telegram é o canal mais fácil e estável. No app de desktop ou no painel (hermes dashboard), em Messaging → Telegram, o botão Create with QR cria o bot e configura tudo. O passo a passo manual:

1. No Telegram, abra o @BotFather e envie /newbot.
2. Escolha um nome de exibição (qualquer um) e um nome de usuário que termine em bot, por exemplo meu_hermes_bot.
3. O BotFather responde com um token parecido com 123456789:ABCdef.... Guarde como senha. Se vazar, gere outro com /revoke no BotFather.
4. Descubra seu ID numérico: mande uma mensagem para o @userinfobot. O ID é um número, não o seu @usuário.
5. No terminal, rode o assistente e escolha Telegram. Ele pede o token e os IDs permitidos:

hermes gateway setup

6. Se preferir configurar à mão, coloque no ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789    # vários IDs separados por vírgula

7. Inicie o gateway (o processo que conecta o Hermes às plataformas):

hermes gateway

8. Mande "oi" para o seu bot. Ele deve responder em segundos.
9. No chat com o bot, envie /sethome. Esse vira o canal onde chegam os resultados das tarefas agendadas.

A lista de permitidos impede estranhos de usar seu agente (e seu computador). Só os IDs em TELEGRAM_ALLOWED_USERS são atendidos. Quem estiver fora recebe um código de pareamento de 8 caracteres, que só vale se você aprovar no terminal:

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

Hermes no WhatsApp

O Hermes se conecta ao WhatsApp por uma ponte embutida (biblioteca Baileys) que imita o WhatsApp Web, não pela API oficial da Meta. A documentação avisa que há um risco pequeno de restrição da conta: use um número dedicado ao bot, não mande mensagens em massa e não inicie conversas com quem não falou com ele antes. Para uso comercial, o Hermes também suporta a API oficial WhatsApp Business Cloud, que exige conta Meta Business e endereço público.

Você precisa de Node.js 18 ou mais novo e de um celular com WhatsApp. Há dois modos: bot (um número separado, o recomendado) e self-chat (você manda mensagem para você mesmo no seu número, bom para testar).

1. Se for usar o modo bot, consiga um segundo número (um chip pré-pago serve) e registre-o no WhatsApp de um celular.
2. No terminal, rode o assistente:

hermes whatsapp

3. Escolha o modo (bot ou self-chat). O assistente instala o que falta e mostra um QR code no terminal.
4. No celular com o número do bot, abra o WhatsApp, vá em Configurações → Dispositivos conectados → Conectar um dispositivo e aponte a câmera para o QR. Se o QR sair embaralhado, aumente a janela do terminal (pelo menos 60 colunas). Ele expira em uns 20 segundos; se expirar, rode o comando de novo.
5. Configure quem pode falar com o bot no ~/.hermes/.env. Número com código do país, sem + e sem espaços:

WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                        # ou self-chat
WHATSAPP_ALLOWED_USERS=5511999998888     # vários números separados por vírgula

6. Para o bot ficar em silêncio com desconhecidos (em vez de mandar código de pareamento), o que costuma ser melhor num número privado:

hermes config set whatsapp.unauthorized_dm_behavior ignore

7. Inicie o gateway. Ele reconecta sozinho usando a sessão salva:

hermes gateway

Grupos ficam bloqueados até você liberar grupos específicos (veja a página do WhatsApp). Nunca use WHATSAPP_ALLOWED_USERS=*, que libera qualquer pessoa. A pasta ~/.hermes/platforms/whatsapp/session guarda a sessão da conta: trate como senha. Se suspeitar de algo, desconecte o dispositivo em Dispositivos conectados no celular.

Deixar o Hermes ligado 24 horas

Rodar hermes gateway no terminal funciona enquanto a janela estiver aberta. Para o agente sobreviver a reinícios, instale o gateway como serviço:

hermes gateway install    # Mac: launchd; Linux: serviço do usuário; Windows: tarefa agendada no login
hermes gateway start
hermes gateway status

• Mac: logs em ~/.hermes/logs/gateway.log. Se trocar a versão do Node, rode hermes gateway install de novo.
• Linux e VPS: para seguir rodando depois que você sai da sessão, ative uma vez sudo loginctl enable-linger $USER.
• Windows: vira uma tarefa agendada que inicia no login.

A máquina precisa ficar ligada e conectada: um computador velho em casa ou um servidor pequeno na nuvem resolvem. Atualize com hermes update.

Skills e tarefas agendadas

Skills são arquivos de instrução que ensinam uma tarefa ao Hermes. Ele vem com dezenas, cria novas quando resolve algo difícil, e você pode instalar outras:

hermes skills search planilha
hermes skills install dono/repositorio/caminho-da-skill

Tarefas agendadas podem ser criadas na conversa ("todo dia às 8h, me mande um resumo das notícias de IA aqui no Telegram"), com o comando /cron dentro do chat ou pelo terminal:

hermes cron create "every 1d at 08:00" "Resuma as 5 notícias de IA mais importantes das últimas 24 horas, com links"
hermes cron list

As tarefas rodam dentro do gateway, então ele precisa estar ligado.

Atenção

• O Hermes pede aprovação antes de comandos perigosos. O modo padrão é smart (um modelo auxiliar aprova o que é claramente seguro e pergunta o resto). Para aprovar tudo manualmente: hermes config set approvals.mode manual. Evite --yolo e /yolo, que desligam as perguntas.
• Tarefas agendadas bloqueiam comandos perigosos por padrão (não há quem aprove). Deixe assim.
• Para rodar no computador do dia a dia, leia o guia Running Hermes on a Personal or Work Machine.

Claude Code

O Claude Code é o agente da Anthropic. Roda no terminal (e no VS Code, JetBrains e app de desktop), lê e edita arquivos da pasta em que você abre, executa comandos e usa os modelos Claude. Serve para muito além de código: organizar arquivos, montar planilhas, analisar documentos.

Prós

• Usa a assinatura Claude Pro ou Max, sem chave de API.
• Modos de permissão claros, incluindo um que só planeja.
• Instruções permanentes por projeto num arquivo CLAUDE.md.

Contras

• Só modelos Claude: a Anthropic não dá suporte a modelos de outras empresas nele.
• O plano gratuito não inclui; os limites do Pro acabam rápido em tarefas longas.
• Sem integração nativa com WhatsApp ou Telegram.

Preço

Segundo a página de preços: Pro custa US$ 20/mês (US$ 17/mês no plano anual), Max começa em US$ 100/mês (5x ou 20x o uso do Pro), e o Team custa US$ 25 por pessoa/mês (US$ 20 no anual). Pela API, cobrado por uso, o Sonnet 4.6 custa US$ 3 por milhão de tokens de entrada e US$ 15 de saída; o Opus 4.8, US$ 5 e US$ 25.

Como instalar

1. Mac, Linux ou WSL:

curl -fsSL https://claude.ai/install.sh | bash

2. Windows (PowerShell, sem precisar de administrador):

irm https://claude.ai/install.ps1 | iex

3. Alternativas: brew install --cask claude-code no Mac ou winget install Anthropic.ClaudeCode no Windows. Essas duas não se atualizam sozinhas; o instalador oficial, sim.
4. No Windows, instale também o Git for Windows, recomendado pela Anthropic para o Claude Code usar o terminal Bash.
5. Abra um terminal novo e confira:

claude --version
claude doctor

Como autenticar

• Assinatura (Pro, Max, Team):
  1. Entre na pasta do projeto e rode claude.
  2. O navegador abre; faça login com sua conta do claude.ai.
  3. Se o navegador mostrar um código em vez de voltar sozinho, cole no terminal.
• Chave de API (Console da Anthropic):
  1. Crie uma chave em console.anthropic.com.
  2. Defina a variável e abra o Claude Code; ele pergunta se deve usar a chave:

export ANTHROPIC_API_KEY=sk-ant-...
claude

• OpenRouter (documentado pelo OpenRouter, usando o mecanismo de gateway que a Anthropic documenta):
  1. Se já tinha feito login com conta Anthropic, abra o Claude Code e rode /logout.
  2. Defina as variáveis (de preferência no seu ~/.zshrc, com a chave antes):

export OPENROUTER_API_KEY="sk-or-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""   # precisa ficar vazio

3. Abra claude e rode /status. A linha de autenticação deve mostrar ANTHROPIC_AUTH_TOKEN. Nesse modo o uso sai dos créditos do OpenRouter, não da sua assinatura. O guia completo está no OpenRouter.

Para sair e trocar de conta, use /logout dentro do Claude Code.

Primeiro teste

cd ~/agente-teste
claude --permission-mode plan

"Organize os PDFs desta pasta em subpastas por ano, com base na data do arquivo. Mostre o plano primeiro."

No modo plan ele só lê e propõe; nada muda até você aprovar. Depois rode /init para criar um CLAUDE.md com as regras do projeto, lido em toda sessão.

Atenção

• Modos (troque com Shift+Tab): manual (pergunta antes de quase tudo), acceptEdits, plan, auto (um segundo modelo revisa cada ação no seu lugar), dontAsk e bypassPermissions (tudo liberado).
• Nas versões recentes, o terminal começa em auto. Para revisar cada passo no início: claude --permission-mode manual.
• Use --dangerously-skip-permissions (o modo bypassPermissions) só dentro de container ou máquina virtual, como a própria documentação diz.
• Se você definir uma chave de API ou um gateway, os pedidos saem da conta dessa chave, não da assinatura, e podem gerar cobrança.

Codex

O Codex é o agente da OpenAI. A versão de terminal (Codex CLI) é open source, roda no seu computador e edita arquivos e executa comandos dentro de uma sandbox. Também existe como extensão de IDE, app e na web.

Prós

• Usa a assinatura do ChatGPT (Plus, Pro, Business, Edu, Enterprise).
• Sandbox ligada por padrão: escreve só na pasta do projeto e pede antes de acessar a internet.
• Open source; configuração em ~/.codex/config.toml e instruções do projeto em AGENTS.md.

Contras

• Pensado para programação; tarefas fora de código funcionam, mas não é o foco.
• Nos planos Free e Go, a página de preços lista o Codex só no app de desktop e sujeito a liberação gradual; o CLI aparece a partir do Plus.

Preço

Segundo a página de preços do Codex: Free (US$ 0) e Go (US$ 8/mês) com acesso limitado no app de desktop; Plus (US$ 20/mês) com Codex no terminal, na IDE, na web e no iOS; Pro em US$ 100, US$ 200 ou US$ 500/mês; Business a US$ 25 por pessoa/mês (US$ 20 no anual, mínimo de 2 pessoas). Com chave de API, paga-se por uso.

Como instalar

1. Mac ou Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

2. Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

3. Alternativas: npm install -g @openai/codex (precisa de Node) ou brew install --cask codex.

Como autenticar

• Assinatura do ChatGPT:
  1. Rode codex e escolha Sign in with ChatGPT.
  2. Faça login no navegador. Num servidor sem navegador, use codex login --device-auth.
• Chave de API da OpenAI:
  1. Crie a chave em platform.openai.com/api-keys.
  2. Passe a chave para o login:

export OPENAI_API_KEY=sk-...
printenv OPENAI_API_KEY | codex login --with-api-key
codex login status

• OpenRouter: o caminho documentado pelo OpenRouter é o Ori, uma ferramenta que abre o Codex já conectado à sua conta:

curl -fsSL https://openrouter.ai/labs/ori/install.sh | bash
ori login
ori codex

Para outros provedores, o Codex aceita provedores personalizados na seção model_providers do config.toml (veja a configuração avançada).

Primeiro teste

cd ~/agente-teste
codex

"Crie um arquivo resumo.md com uma linha por arquivo desta pasta: nome, tipo e uma frase sobre o conteúdo."

Atenção

• O preset padrão (Auto) age dentro da pasta do projeto e pede aprovação para mexer fora dela ou acessar a rede.
• Para só planejar sem alterar nada: codex --sandbox read-only --ask-for-approval on-request, ou /permissions na sessão.
• --yolo (--dangerously-bypass-approvals-and-sandbox) tira a sandbox e as aprovações; a OpenAI não recomenda. Use só dentro de container.

Grok Bot

O Grok Bot é o agente da xAI. Cada Bot trabalha num computador na nuvem, com navegador, arquivos e terminal, e você conversa com ele pelo app de desktop ou pelo celular. Você cria Bots com funções diferentes, eles guardam memória, usam sites e apps por você e continuam trabalhando com o notebook fechado.

Prós

• Nada de terminal: instala como app comum, inclusive no celular.
• Roda na nuvem: rotinas funcionam com seu computador desligado.
• Skills e rotinas criadas pedindo na conversa.
• Senhas por formulário seguro (Vault), sem expor ao modelo; revisão automática de ações (Auto Review) ligada por padrão.

Contras

• Não dá para escolher o modelo. O Grok Bot escolhe a cada tarefa entre modelos próprios e de terceiros, e não mostra qual usou.
• Não aceita chave de API nem OpenRouter: só funciona com os planos da xAI ou do Cursor.
• Todos os seus Bots compartilham o mesmo computador na nuvem, com os mesmos arquivos e logins.
• Guarda dados na nuvem: contas no Privacy Mode (Legacy) precisam mudar para o Privacy Mode antes de usar.

Preço

Na X Subscription, que reúne Grok, Cursor e X: o Grok Bot está incluído nos planos Premium (US$ 30/mês ou US$ 300/ano), Super (US$ 100/mês) e Ultra (US$ 200/mês). O plano Plus (US$ 8/mês) não inclui. O uso sai de um limite semanal compartilhado com o Grok e o Cursor. Quem já tem SuperGrok, SuperGrok Plus, SuperGrok Heavy, X Premium+ ou um plano pago individual do Cursor também tem acesso. Preços atualizados em x.ai/pricing.

Como instalar

1. Baixe o app em x.ai/bot (Mac, Windows e Linux). No celular, instale o Grok Bot pela App Store (iOS 18+) ou Google Play (Android 9+).
2. Abra o app. Ele se atualiza sozinho.

Como autenticar

1. Na tela inicial, clique em Sign in e termine o login no navegador. O Grok Bot usa uma conta do Cursor; não há login separado.
2. Se o seu acesso vem de SuperGrok ou X Premium+, vincule quando o app pedir, ou no desktop em Settings → Usage & Billing → Get Access with Grok. No celular, use Link Grok Account e depois Finished Linking? Refresh My Status.
3. Com assento num plano Grok Business, escolha Sign in with Grok no navegador.

Primeiro teste

O app cria seu primeiro Bot, chamado Grok Bot. Dê a ele uma função na primeira mensagem e peça para lembrar. Depois anexe um documento e peça:

"Resuma este documento em cinco tópicos. Liste numa seção separada todas as datas, decisões e perguntas em aberto, citando a seção de cada uma. Não altere o arquivo."

Quando um processo funcionar bem, peça: "Salve o que acabamos de fazer como uma skill chamada Resumo semanal". Para agendar: "Toda segunda às 8h, rode a skill Resumo semanal e poste o resultado aqui". Confira o horário salvo em When to run na rotina.

Também dá para marcar @bot num post no X para mandar uma tarefa ao seu Bot principal (exige conta X ligada à conta Grok; funciona no Brasil).

Grok Build: o agente de terminal da xAI

Para programar no terminal, a xAI tem o Grok Build (comando grok):

curl -fsSL https://x.ai/cli/install.sh | bash

No Windows: irm https://x.ai/cli/install.ps1 | iex. Na primeira vez, grok abre o navegador para login (num servidor, grok login --device-auth), ou use export XAI_API_KEY="xai-...". Aceita outros modelos em ~/.grok/config.toml. Permissões: Ask (padrão), Auto e Always-approve. Quais planos incluem o Grok Build, confira em x.ai/pricing.

Atenção

• O Auto Review aprova ou barra cada ação e mostra um cartão quando precisa de você. Mantenha ligado e diga no pedido onde parar ("não envie nada sem me mostrar").
• Tudo no computador na nuvem fica disponível para todos os seus Bots.
• Nunca mande senhas no chat; use o Vault.

Pi

O Pi é um agente de terminal mínimo criado por Mario Zechner, hoje mantido pela Earendil Works (repositório). Vem com o essencial (ler, editar, rodar comandos) e você acrescenta o resto com extensões, skills, templates de prompt e temas. Não tem subagentes nem modo de planejamento, de propósito: peça ao próprio Pi para construir ou instale um pacote.

Prós

• Leve e fácil de entender.
• Dezenas de provedores: assinatura nos que suportam, chave de API, OpenRouter e modelos locais.
• Extensível com pacotes via npm ou git; open source (MIT).

Contras

• Não pede aprovação antes de cada ação e não tem sandbox própria. Tudo roda com as permissões do seu usuário.
• Menos recursos prontos; você monta o que precisa.

Preço

Gratuito. Você paga o modelo, pela assinatura ou pela chave que conectar. O catálogo de modelos mostra preços por modelo.

Como instalar

1. Mac ou Linux:

curl -fsSL https://pi.dev/install.sh | sh

2. Windows:

powershell -c "irm https://pi.dev/install.ps1 | iex"

3. Alternativa com npm (Node 22.19 ou mais novo): npm install -g --ignore-scripts @earendil-works/pi-coding-agent. Atualize com pi update.

Como autenticar

• Assinatura ou chave, pelo menu:
  1. Abra pi na pasta de trabalho.
  2. Digite /login, escolha o provedor e siga o fluxo (login no navegador ou colar a chave).
  3. Escolha o modelo com /model.
• Chave por variável de ambiente: export ANTHROPIC_API_KEY=..., export OPENAI_API_KEY=... ou a variável do provedor, e depois pi.
• OpenRouter: /login openrouter ou export OPENROUTER_API_KEY=sk-or-.... O Pi lista só os modelos que a sua chave pode usar, com os preços.

As credenciais ficam em auth.json; não compartilhe esse arquivo.

Primeiro teste

"Resuma @notas-reuniao.md e salve os itens de ação em itens-de-acao.md." (Digite @ para buscar um arquivo pelo nome.)

Atenção

• A documentação do Pi recomenda rodar dentro de um container ou máquina virtual para trabalho não supervisionado ou em pastas de terceiros.
• Use controle de versão ou backup da pasta antes de deixar o Pi editar.
• O Pi pergunta antes de carregar extensões e configurações de uma pasta nova (project trust), mas isso não limita o que as ferramentas fazem depois.

OpenBot

O OpenBot é um app de desktop que reúne vários agentes numa interface de chat. Cada agente tem conversa e pasta próprias e pode ser Claude Code, Codex, Grok (via Grok Build), OpenCode, Gemini, Cursor, Cline ou um agente personalizado via ACP (protocolo aberto para conectar agentes). Eles trocam mensagens, dividem tarefas em canais e usam um navegador embutido; dá para acompanhar pelo celular.

Prós

• Usa os planos que você já paga: cada agente entra com o login oficial dele.
• Vários agentes na mesma tela, com fila e delegação entre eles.
• Baixa e atualiza os agentes; pode rodar como servidor numa VPS; interface em português.

Contras

• Prévia de desenvolvimento: os agentes rodam com acesso total (danger-full-access) e sem pedir aprovação (approvalPolicy: never) depois do consentimento inicial.
• Licença PolyForm Noncommercial: o código é aberto para ler, mas não é software livre e não pode ser usado comercialmente sem outra licença.

Preço

Download gratuito; os modelos são cobrados pelas assinaturas ou chaves de cada agente. Para uso em empresa, leia a licença.

Como instalar

1. Mac (macOS 13 ou mais novo): baixe o OpenBot-*-arm64.dmg (ou x64 para Mac Intel) em GitHub Releases e arraste para Aplicativos.
2. Windows 10 ou mais novo (x64): baixe e rode o OpenBot-*-x64.exe. Confira o checksum se o SmartScreen avisar.
3. Linux: baixe o .AppImage, dê permissão e rode:

chmod +x OpenBot-*.AppImage
./OpenBot-*.AppImage

Como autenticar

1. No primeiro uso, escolha os agentes que quer usar. O OpenBot oferece Download para cada um.
2. Faça o login de cada agente como faria nele: conta Claude para o Claude Code, ChatGPT para o Codex, grok login ou XAI_API_KEY para o Grok, plano Google AI Pro ou Ultra para o Gemini.
3. O OpenCode funciona sem conta nos modelos marcados como Free.
4. Para OpenRouter ou modelos locais (Ollama, LM Studio), o OpenBot aceita endpoints compatíveis com OpenAI; o endereço do OpenRouter é https://openrouter.ai/api/v1.

Primeiro teste

Crie um agente Claude Code e um Codex na mesma pasta de teste. Peça ao primeiro: "Proponha uma organização para os arquivos desta pasta e mande para o outro agente revisar".

Atenção

• Como os agentes rodam sem aprovação, use só pastas de teste e tarefas em que confia, e mantenha backup.
• Não rode a versão Linux com --no-sandbox, como avisa o próprio projeto.

OpenClaw

O OpenClaw é um assistente open source (MIT) que roda no seu computador e atende nos canais que você já usa: WhatsApp, Telegram, Discord, Slack, iMessage e mais de 20 outros, com apps para Mac, Windows, Linux, iOS e Android. É o concorrente mais direto do Hermes.

• Prós: reaproveita um login existente do Claude Code ou do Codex ou uma chave de API; muitos canais; grande ecossistema de plugins.
• Contras: as ferramentas rodam direto no computador na sessão principal, a menos que você configure sandbox; exige Node 24 ou 26 se instalar pelo npm.
• Preço: gratuito; você paga o modelo.
• Instalar (Mac/Linux):

curl -fsSL https://openclaw.ai/install.sh | bash

No Windows (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex. O instalador abre a configuração guiada; para rodá-la de novo e deixar o serviço ligado em segundo plano: openclaw onboard --install-daemon.

• Autenticar: escolha Quick start e ele detecta o login do Claude Code ou do Codex, ou uma chave. Com OpenRouter: openclaw onboard --auth-choice openrouter-api-key.
• Atenção: desconhecidos que mandam mensagem recebem pedido de pareamento; aprove só quem você conhece com openclaw pairing approve <canal> <código>. Leia o guia de segurança antes de conectar outras pessoas.

Antigravity CLI (antigo Gemini CLI)

O Gemini CLI, que era a opção gratuita do Google, deixou de atender contas gratuitas e assinantes do Google AI Pro e Ultra em 18 de junho de 2026 e hoje é só para empresas com Gemini Code Assist (anúncio do Google). O substituto para uso pessoal é o Antigravity CLI, comando agy.

• Prós: gratuito com uma conta Google comum; mantém skills, hooks, subagentes e extensões (agora plugins) do Gemini CLI.
• Contras: só os modelos que o Google oferece (terceiros só no Ultra); limite semanal no plano gratuito.
• Preço: Individual US$ 0/mês com limite semanal; Google AI Pro e Ultra dão limites maiores (preços).
• Instalar (Mac/Linux):

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy --version

No Windows, use os instaladores da página de download.

• Autenticar: rode agy; o navegador abre para login com a conta Google (Free, Pro ou Ultra). Com chave do Google AI Studio: coloque "modelProvider": "gemini" em ~/.gemini/antigravity-cli/settings.json e defina GEMINI_API_KEY. Só a variável, sem essa linha, não tem efeito.
• Atenção: na primeira vez ele pergunta se você confia na pasta; abra numa pasta de teste.

OpenCode

O OpenCode é um agente open source (MIT) de terminal, com app de desktop em beta, que funciona com mais de 75 provedores e com modelos locais.

• Prós: aceita login do ChatGPT Plus/Pro e do GitHub Copilot sem configuração extra; OpenRouter e chaves de API em um comando; tem modelos gratuitos.
• Contras: as permissões padrão são abertas (a maioria das ações roda sem perguntar); o próprio OpenCode avisa que a Anthropic proíbe usar Claude Pro/Max nele por plugin, então para Claude use chave de API.
• Preço: gratuito com os modelos free; o plano OpenCode Go custa US$ 10/mês e o Go Plus, US$ 40/mês (opencode.ai/go).
• Instalar:

curl -fsSL https://opencode.ai/v2/install | bash
# ou: npm i -g @opencode/cli@latest
# ou: brew install anomalyco/tap/opencode-v2

No Windows, use o npm ou o app de desktop em opencode.ai/download.

• Autenticar: abra opencode, digite /connect e escolha o provedor: OpenAI (opção ChatGPT Plus/Pro), Anthropic (chave do Console), OpenRouter (chave) e outros. Escolha o modelo com /models.
• Atenção: para ele perguntar antes de agir, crie um opencode.json na pasta com:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": "ask"
}

Evite opencode --auto fora de pastas de teste.

OpenRouter em 5 minutos

O OpenRouter vende acesso a centenas de modelos (Claude, GPT, Gemini, Grok, DeepSeek, Qwen e outros) com uma conta e uma chave. Você compra créditos e cada pedido desconta o preço do modelo usado, o mesmo do fornecedor; o OpenRouter cobra uma taxa na compra de créditos (FAQ).

1. Crie a conta em openrouter.ai.
2. Compre créditos na página Credits. Comece com pouco.
3. Crie uma chave em Keys e, na criação, defina um limite de crédito para ela, com renovação diária, semanal ou mensal. Ao bater o limite, a chave para de funcionar até renovar: é o seu freio contra um agente que entra em loop.
4. Use uma chave por ferramenta. Se uma vazar, você revoga só ela.
5. Configure na ferramenta:

O Ori, do próprio OpenRouter, abre o agente que você já usa (Claude Code, Codex, Grok Build, Hermes, OpenCode, Pi e outros) conectado à sua conta. No PowerShell, instale com irm https://openrouter.ai/labs/ori/install.ps1 | iex.

Modelos com o sufixo :free são gratuitos, com limites próprios: bons para testar, fracos para tarefas longas.

Segurança: o mínimo

• Comece com aprovação ligada. Manual ou plan no Claude Code, read-only ou o preset Auto no Codex, approvals.mode manual no Hermes, Ask no Grok Build, "permission": "ask" no OpenCode. Afrouxe só depois de entender o que o agente faz.
• Isole o agente. Pasta de teste no começo; para uso contínuo, um usuário separado no computador, um container ou uma máquina dedicada. Pi e OpenBot não pedem aprovação por padrão: use em ambiente isolado.
• Nunca entregue acesso de administrador ou chaves de produção. Nada de sudo liberado, senha do banco ou chave da conta da empresa. Crie chaves com limite de gasto e permissões mínimas.
• Lista de permitidos em todo bot de mensagem. No Hermes, TELEGRAM_ALLOWED_USERS e WHATSAPP_ALLOWED_USERS; no OpenClaw, pareamento. Quem fala com o bot comanda seu computador.
• Cuidado com conteúdo de fora. Um site, e-mail ou PDF pode esconder instruções para o agente; não deixe ele agir sozinho sobre conteúdo de terceiros tendo acesso a coisas importantes.
• Fique de olho em atualizações automáticas. Claude Code, Grok Bot e OpenBot se atualizam sozinhos e o comportamento pode mudar; leia as notas de versão do que roda sem supervisão.
• Revise o que ele executou. Use controle de versão (git) ou backup nas pastas em que o agente trabalha, e confira os comandos e alterações no fim de cada tarefa.

Perguntas frequentes

Precisa saber programar?

Não. Basta abrir o terminal, colar um comando e editar um arquivo de texto. Grok Bot e OpenBot nem isso: instalam como apps. O resto é conversa em português.

Dá para fazer de graça?

Dá, com limites: Antigravity CLI com conta Google, modelos gratuitos do OpenCode, e Hermes, Pi ou OpenClaw com modelos :free do OpenRouter ou o plano Free do Nous Portal. Para trabalho sério, conte com uma assinatura de US$ 20/mês ou crédito de API.

Qual a diferença entre o ChatGPT e um agente?

O chat no navegador conversa e, no máximo, roda código numa caixa fechada. Um agente num harness trabalha no seu computador (ou num computador na nuvem só seu): abre arquivos, roda programas, navega, lembra de você, executa tarefas agendadas e responde no Telegram ou no WhatsApp. Ele faz o trabalho, em vez de explicar como fazer.

Posso usar minha assinatura em vez de chave de API?

Na ferramenta da própria empresa, sim: Claude Pro/Max no Claude Code, ChatGPT no Codex, X Subscription ou SuperGrok no Grok Bot. Em ferramentas de terceiros depende: o Hermes aceita ChatGPT e SuperGrok, e Claude só no Max com créditos extras; o OpenCode aceita ChatGPT Plus/Pro e Copilot; o OpenBot usa o login oficial de cada agente. Segundo a documentação do OpenCode, a Anthropic proíbe usar Claude Pro/Max em ferramentas de terceiros por plugin; nesses casos, use chave de API.

Roda no Windows?

Sim. Hermes, Claude Code, Codex, Pi, OpenClaw e Grok Build têm instalador para PowerShell; Grok Bot, OpenBot e o app do Hermes são apps de Windows. Se der problema, o WSL2 é o caminho mais testado.

É seguro deixar um agente no WhatsApp?

Com cuidados, sim. A integração do Hermes usa uma ponte não oficial e pode causar restrição da conta: use um número separado, nunca o principal. Ative a lista de permitidos, mantenha grupos bloqueados e a aprovação de comandos perigosos ligada. Para empresas, a API oficial WhatsApp Business Cloud evita o risco de bloqueio.

Próximos passos

• Agentes de IA disponíveis no Brasil: o que cada agente pronto faz e quanto custa.
• Skills: como ensinar tarefas ao seu agente: o próximo passo depois de instalar.
• Casos reais de agentes por área: como outras pessoas estão usando.