O que é um Agente OpenClaw

Um agente OpenClaw é um assistente de IA que roda em uma máquina virtual dedicada e pode ser acessado por múltiplos canais de comunicação simultaneamente.

Arquitetura

Cada agente é composto por:

• Gateway — o processo central que gerencia conexões, sessões e roteamento
• Pi — o agente de IA que processa mensagens e executa ferramentas (tools)
• Channels — conexões com WhatsApp, Telegram, Discord, etc.

Como funciona

1. Uma mensagem chega por um canal (ex: WhatsApp)
2. O Gateway recebe e encaminha para o agente Pi
3. Pi processa, usa ferramentas se necessário, e gera a resposta
4. O Gateway envia a resposta de volta pelo canal original

Capacidades

Tools (Ferramentas)

O agente pode executar ações como navegar na web, executar comandos, manipular arquivos e mais.

Sessões

Cada conversa é isolada em uma sessão. Chats diretos são agrupados; grupos são isolados automaticamente.

Memória

O agente mantém contexto entre mensagens da mesma sessão e pode compactar conversas longas para preservar informações essenciais.

Multi-canal

Um único agente atende todos os canais conectados, mantendo sessões separadas por remetente.

Gerenciado pelo SuperSquad

No SuperSquad, você não precisa configurar nada disso manualmente. O wizard de criação cuida de:

• Configurar o system prompt e modelo
• Provisionar a VM com OpenClaw instalado
• Conectar os canais desejados
• Iniciar o Gateway automaticamente

Avaliação de objetivos com tools

Quando a observabilidade está ativa, o sistema avalia conversas com base nos objetivos do agente.

As sugestões de melhoria geradas automaticamente guardam, no registro da sugestão, a lista de conversas relacionadas (IDs das threads avaliadas que originaram aquela sugestão). Na tela de observabilidade você pode abrir esse vínculo e ir ao ChatCenter para revisar o contexto de cada conversa.

Para objetivos que dependem de ações operacionais (por exemplo, registrar memória, notificar, consultar serviço externo), a avaliação considera:

• chamada de ferramenta (tool-*);
• estado da execução (sucesso, parcial, erro);
• resultado retornado pela ferramenta.

Isso reduz casos em que o agente apenas confirma verbalmente uma ação sem ter executado a tool correspondente.

Recomendação sem evidência

• Quando a conversa não tiver material suficiente para embasar fraquezas/recomendações acionáveis, o sistema pode retornar weaknesses: [] e recommendations: [].
• Textos genéricos de espera (ex.: "Aguardar mais interações") não devem virar sugestão de melhoria e devem ser descartados.

Conversas Problematicas na Observabilidade

Na aba de observabilidade do agente, a lista de conversas problematicas foi aprimorada para facilitar diagnostico e ação:

• Exibe data com fallback (Data indisponivel) quando houver dado invalido.
• Mostra mais contexto por item: nome da thread, nome do contato e internalUID.
• Inclui pesquisa na lista para localizar rapidamente conversas por termo.
• Exibe o percentual de conversas problematicas em relacao ao total de threads.
• Todos os contadores relevantes exibem tooltip explicativo.

Em telas menores, o layout da observabilidade se adapta para manter legibilidade e evitar quebra visual.