Apresentação e documentação do ClaudeClaw V3, bot que conecta o…

INEMA

temos agora a versao V4

crie um bot no botfather e nele rode /chatid

O que é

ClaudeClaw -- um bot que conecta o CLI do Claude Code ao Telegram. Não é um wrapper de chatbot; ele executa o claude real na sua máquina e manda o resultado pelo Telegram.

Pré-requisitos

│ Requisito │ Como obter │

│ Node.js 20+ │ node --version / nodejs.org │

│ Git │ git --version │

│ Claude Code CLI │ npm i -g @anthropic-ai/claude-code │

│ Conta Claude │ claude login (free, Pro ou Max) │

│ Telegram │ Criar um bot via @BotFather e pegar o token │

Chaves/Tokens necessários

Obrigatório:
- TELEGRAM_BOT_TOKEN -- do @BotFather
- ALLOWED_CHAT_ID -- seu chat ID no Telegram (o bot te diz com /chatid)

Opcional (conforme features que quiser usar):
- ANTHROPIC_API_KEY -- se quiser billing pay-per-token ao invés do auth local
- GROQ_API_KEY -- transcrição de áudio (Whisper via Groq)
- ELEVENLABS_API_KEY + ELEVENLABS_VOICE_ID -- TTS (text-to-speech)
- GOOGLE_API_KEY -- análise de vídeo via Gemini
- SLACK_USER_TOKEN -- integração Slack
- DASHBOARD_TOKEN -- dashboard web de monitoramento
- Google OAuth credentials -- para skills de Gmail e Calendar

Como rodar

1. Instalar dependências⌗

npm install

2. Copiar e preencher o .env⌗

cp .env.example .env

editar o .env com pelo menos TELEGRAM_BOT_TOKEN⌗

3. Modo dev (com hot reload)⌗

npm run dev

4. Ou build + start em produção⌗

npm run build
npm start

Tem também um setup interativo: npm run setup que guia a configuração.

Outros comandos úteis

npm test -- testes
npm run status -- verifica status do bot
npm run agent:create -- criar agentes customizados
npm run agent:start -- rodar como agente

Stack

TypeScript, grammy (Telegram), Hono (dashboard web), better-sqlite3 (DB local), Claude Agent SDK, suporte a voz (Groq/ElevenLabs), WhatsApp bridge opcional.

ClaudeClaw V3 — Resumo⌗

O ClaudeClaw V3 é uma grande atualização que transforma o sistema em um ambiente multiagente conectado ao Telegram.

Principais novidades:

1. Sistema multiagente

Em vez de um único assistente, agora existem vários agentes especializados:
Comms (comunicação e inbox)
Content (ideias e produção de conteúdo)
Ops (operações e automações)
Research (pesquisa)
Cada agente tem:
seu próprio bot do Telegram
seu próprio contexto
seu próprio CLAUDE.md
suas próprias tarefas agendadas (cron jobs)

2. Memória compartilhada (“Hive Mind”)

Todos os agentes compartilham um repositório de memória central.
Um agente pode consultar o que outro agente fez.
Isso evita sistemas complexos de comunicação entre agentes e reduz muito o custo de tokens.

3. Integração com Obsidian

Cada agente carrega automaticamente pastas relevantes do Obsidian como contexto.
Isso melhora muito a memória e organização de conhecimento.

4. Dashboard de controle

Um painel acessível por link seguro (Cloudflare Tunnel) mostra:
uso de tokens
conversas recentes
estado da memória
tarefas dos agentes
Funciona como um centro de comando do sistema.

5. Automação com cron jobs

Um agente pode criar tarefas automáticas.
Exemplo: tirar foto de um calendário de coleta de lixo e o agente cria 26 lembretes automáticos.

6. Novos comandos no Telegram

/dashboard → abre o painel
/model → troca entre modelos (Haiku, Sonnet, Opus)
/stop → interrompe tarefa
/new chat e /respin → reinicia contexto mantendo informações importantes.

7. Envio de arquivos

O agente pode enviar PDFs, imagens e arquivos direto no Telegram.

8. Integração com Google

Novo uso do Google Workspace CLI para acessar:
Gmail
Google Calendar
outros serviços Google.

Ideia principal⌗

O sistema foi projetado para criar uma “mente coletiva de agentes especializados”, permitindo trabalhar em paralelo e organizar tarefas complexas com mais eficiência.

ClaudeClaw V3 – Multi-agentes, Mente Coletiva, Painel de Controle + Obsidian 💎🦞

A maior atualização até agora: o ClaudeClaw agora executa vários agentes especializados no Telegram, cada um com sua própria janela de contexto, tarefas cron e inteligência. (continuação do post sobre a versão 2 aqui: Análise detalhada do ClaudeClaw V2).

Em vez de um único assistente sobrecarregado, agora tenho quatro agentes dedicados rodando em paralelo:

→ Comunicações (caixa de entrada, respostas, contatos)
→ Conteúdo (ideias para YouTube, pesquisa)
→ Operações (agendamentos, tarefas cron, manutenção)
→ Pesquisa (análises profundas, estudos detalhados)

Cada um herda todas as habilidades e infraestrutura globais, mas possui:

seu próprio CLAUDE.md
seu próprio bot no Telegram
sua própria sessão

→ Criar um novo agente leva apenas alguns minutos — basta criar um bot no BotFather, colar o token e dizer ao Claude Code em que ele será especializado.

🧠 Mente coletiva⌗

O que conecta tudo é uma memória compartilhada:

→ Um repositório de memória compartilhada que qualquer agente pode acessar para ver o que os outros estão fazendo.
→ Perguntei ao meu agente de comunicações o que a equipe de operações estava fazendo e ele me retornou exatamente a última tarefa executada, sem nenhuma configuração manual.
→ Muito mais barato que sistemas de equipes de agentes, que antes me custavam centenas de tokens apenas para testar.

🖥️ Painel de controle⌗

Um novo dashboard via Cloudflare Tunnel cria uma central de comando acessível de qualquer lugar.

Ele mostra:

→ custos de tokens
→ pré-visualizações de conversas
→ status de degradação da memória
→ tarefas pendentes de todos os agentes

→ Basta digitar /dashboard no Telegram e receber um link seguro para abrir em qualquer dispositivo.

⚙️ Outras novidades⌗

→ Envio de arquivos (PDFs, imagens e textos diretamente no Telegram)
→ Comando /model para alternar entre Haiku, Sonnet e Opus instantaneamente (obrigado Roland pela dica)
→ Google Workspace CLI substitui minhas integrações personalizadas de Gmail/Calendário por uma configuração pronta e mais limpa
→ Obsidian injeta automaticamente o contexto da pasta relevante quando cada agente inicia

💡 Dica⌗

Você pode usar todos os agentes especializados em Haiku para economizar tokens e manter o agente principal (ClaudeClaw) em Sonnet ou Opus para tarefas mais pesadas.

🔗 https://github.com/earlyaidopters/claudeclaw

Se você já tiver sua própria versão rodando, basta pedir ao Claude Code para buscar as últimas mudanças do repositório e aplicar as que fizerem sentido para você.

Relatórios de bugs e pedidos de novas funcionalidades devem ser feitos nesse tópico.

O sistema está melhorando todos os dias, pois é usado diariamente.

CLAUDECLAW V3

chatgpt.com ↗