Arquitetura do Clawdbot

Visão Geral da Arquitetura do Clawdbot

O Clawdbot segue uma arquitetura Gateway-Agent que separa as responsabilidades entre o transporte de mensagens e o processamento de IA. Este design permite escalabilidade, confiabilidade e suporte multicanal.

Componentes do Sistema

Camada de Gateway

O Gateway do Clawdbot é o coordenador central:

Camada de Agentes

Os agentes do Clawdbot lidam com o processamento de IA:

Fluxo de Mensagens

Fluxo de Entrada

Provider → Gateway → Router → Agent → Runtime

1. Provedor recebe mensagem
2. Gateway normaliza formato
3. Roteador seleciona agente de destino
4. Agente processa mensagem
5. Runtime gera resposta

Fluxo de Saída

Runtime → Agent → Gateway → Provider → User

1. Runtime gera resposta
2. Agente formata mensagem
3. Gateway roteia para provedor
4. Provedor entrega mensagem

API WebSocket

Conexão

const ws = new WebSocket('ws://localhost:3010');

ws.on('open', () => {
  ws.send(JSON.stringify({
    type: 'auth',
    token: 'your-token'
  }));
});

Tipos de Mensagens

Gerenciamento de Estado

Estado da Sessão

O Clawdbot mantém estado em múltiplos níveis:

Global State
  └── Agent State
        └── Session State
              └── Message State

Persistência de Estado

Escalabilidade

Escalonamento Horizontal

O Clawdbot suporta escalonamento horizontal:

• Múltiplas instâncias de Gateway atrás de balanceador de carga
• Armazenamento de sessão compartilhado para consistência
• Processamento de mensagens sem estado

Limites de Recursos

Modelo de Segurança

Autenticação

• Autenticação por chave API
• Autenticação WebSocket baseada em token
• Credenciais por provedor

Autorização

• Permissões a nível de ferramenta
• Isolamento a nível de agente
• Controle de acesso a nível de sessão

Próximos Passos

• Gateway do Clawdbot - Configuração do Gateway
• Conceitos do Clawdbot - Conceitos principais
• Ferramentas do Clawdbot - Configuração de ferramentas