Agentes de Codificação via Telegram: Do Zero a um Agente que Responde

Pare de ler e comece a fazer.

Ao final deste guia, você terá um tópico no Telegram onde um agente de codificação responde às suas mensagens. Este agente controlará um painel tmux na sua própria máquina.

Este é o objetivo principal. Você ainda não precisa de memória, monitores ou servidores de ferramentas. Você só precisa fazer o agente responder a você.

⏱️ Tempo Necessário: 30–45 minutos.

🛠️ Pré-requisitos

Antes de começar, certifique-se de ter estes itens prontos:

  • Uma máquina com tmux e acesso ao shell.
  • Um agente de codificação funcional (como OpenCode ou Claude Code) já rodando em um painel tmux.
  • O alvo tmux exato para o seu agente (exemplo: mybox:1.1).
  • O comando exato para iniciar o seu agente.
  • O runtime OpenClaw instalado.
  • Uma conta no Telegram e o aplicativo Telegram.

📦 Versões Necessárias

Não pule estas etapas. Versões incorretas causam falhas silenciosas.

• Node.js: 24.11.1 • Gerenciador de Pacotes: pnpm 11.2.2 • OpenClaw: Fixe em um commit específico.

🚀 Caminho de Configuração Rápida

Você pode usar estes scripts para lidar com a configuração local:

  1. Baixe os scripts: curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh

  2. Execute a configuração com o seu token de bot: OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. Verifique a configuração: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Configuração do Telegram

Siga estes passos no seu aplicativo Telegram:

  • Crie um bot via @BotFather e salve o token.
  • Crie um novo grupo e adicione o seu bot.
  • Torne o bot um Administrador. Isso permite que ele veja suas mensagens.
  • Ative "Tópicos" nas configurações do grupo.
  • Crie um tópico para o seu projeto.
  • Envie uma mensagem nesse tópico para gerar um Topic ID nos seus logs.

⚙️ Conectando Tudo

O gateway utiliza uma configuração JSON em ~/.openclaw/openclaw.json.

Use a Fase 1 para encontrar seu Chat ID e Topic ID enviando uma mensagem e verificando os logs do gateway.

Use a Fase 2 para restringir o grupo. Altere a política para "allowlist" e adicione apenas o seu ID de usuário numérico do Telegram. Mapeie seu Topic ID para o seu Agent ID específico.

📝 O Contrato do Agente

Crie um arquivo AGENTS.md no workspace do seu agente. Este arquivo diz ao agente como se comportar. Você deve definir:

  • Como ler o painel (tmux capture-pane).
  • Como escrever no painel (tmux send-keys).
  • Como lidar com comandos específicos como "status", "send" ou "restart".

✅ O Teste de Prontidão

Você só terá terminado quando passar por estas cinco verificações:

  1. O bot responde no seu tópico do Telegram.
  2. Seu prompt chega ao painel tmux.
  3. O agente de codificação começa a trabalhar no prompt.
  4. Um arquivo de log prova que o agente processou seu tópico.
  5. O grupo está bloqueado apenas para o seu ID de usuário.

Fonte: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi