OpenClaw: o gateway multi-canal open-source que construímos para nossos próprios agentes
Lições da construção do OpenClaw — gateway open-source para agentes Claude em WhatsApp, Telegram, Instagram, Discord, com Harness Stack aplicado em nível de gateway.
Em produção interna SkilLab + 2 escritórios em conversa de deploy.
TypeScript · Node.js · Anthropic SDK · Evolution API · OpenRouter
O problema
Construir um agente Claude que responde no WhatsApp, Telegram, Instagram e Discord exige plumbing repetido para cada canal: webhook, formatação de mensagem, contexto de conversa, fila de processamento. Cada implementação acaba reinventando a mesma roda.
A solução
OpenClaw é um gateway que abstrai a parte de canal e expõe uma API unificada: você escreve a lógica do agente uma vez, e o gateway lida com o roteamento para WhatsApp via Evolution API, Telegram via Bot API, Instagram via Graph API, e Discord via gateway nativo.
Features-chave
- Sessão por usuário com persistência configurável (memória curta, memória longa, ephemeral).
- Anti-loop e detecção de emoções negativas (frustração, desespero) com circuit breaker integrado ao Harness Evolution System (HES).
- Roteamento entre múltiplos modelos: primary OpenRouter, fallbacks DeepSeek e Gemini.
- Cron scheduler integrado para jobs agendados via Telegram/WhatsApp.
- Plugin architecture: cada novo canal é um plugin de 200-300 linhas.
O que aprendemos
1. Constraint layer (Harness Stack #2) por canal vence policy global. WhatsApp tem capacidade maior de blast radius do que Telegram interno do time. Construímos policy de constraint indexado por canal, não global por agente.
2. Failure corpus por canal é load-bearing. Cada canal tem padrões próprios de falha (Evolution API perde mensagem em rate limit; Telegram trunca em 4096 chars; Discord engasga em embed mal formado). Versionar corpus por canal separa “bug do gateway” de “bug do agente”.
3. Open-source ganha confiança rápido em mercados regulados. Escritórios contábeis e jurídicos preferem rodar o gateway em VPS próprio do que delegar dado a SaaS cloud third-party. O caminho open + self-hosted abre conversas que SaaS fechado não abre.
Quem usa
- Operação interna SkilLab (atendimento via WhatsApp, controle do VPS via Telegram).
- Em conversa com 2 escritórios brasileiros que querem rodar agente próprio em infraestrutura própria.
Como contribuir / usar
Repo público. Issue para discussões. Para deploy assistido em VPS, conversamos.