Clawdbot Architektur

Clawdbot Architektur Überblick

Clawdbot folgt einer Gateway-Agent-Architektur, die die Verantwortlichkeiten zwischen Nachrichtentransport und KI-Verarbeitung trennt. Dieses Design ermöglicht Skalierbarkeit, Zuverlässigkeit und Multi-Channel-Unterstützung.

Systemkomponenten

Gateway-Schicht

Das Clawdbot Gateway ist der zentrale Koordinator:

Agenten-Schicht

Clawdbot-Agenten übernehmen die KI-Verarbeitung:

Nachrichtenfluss

Eingehender Fluss

Provider → Gateway → Router → Agent → Runtime

1. Provider empfängt Nachricht
2. Gateway normalisiert das Format
3. Router wählt den Zielagenten
4. Agent verarbeitet die Nachricht
5. Runtime generiert Antwort

Ausgehender Fluss

Runtime → Agent → Gateway → Provider → User

1. Runtime generiert Antwort
2. Agent formatiert Nachricht
3. Gateway leitet an Provider weiter
4. Provider liefert Nachricht

WebSocket API

Verbindung

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

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

Nachrichtentypen

Zustandsverwaltung

Sitzungszustand

Clawdbot verwaltet den Zustand auf mehreren Ebenen:

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

Zustandspersistenz

Skalierbarkeit

Horizontale Skalierung

Clawdbot unterstützt horizontale Skalierung:

• Mehrere Gateway-Instanzen hinter Load Balancer
• Gemeinsamer Sitzungsspeicher für Konsistenz
• Zustandslose Nachrichtenverarbeitung

Ressourcenlimits

Sicherheitsmodell

Authentifizierung

• API-Schlüssel-Authentifizierung
• Token-basierte WebSocket-Authentifizierung
• Provider-spezifische Anmeldedaten

Autorisierung

• Tool-Level-Berechtigungen
• Agenten-Level-Isolation
• Sitzungs-Level-Zugriffskontrolle

Nächste Schritte

• Clawdbot Gateway - Gateway-Konfiguration
• Clawdbot Konzepte - Kernkonzepte
• Clawdbot Tools - Tool-Konfiguration