Kernkonzepte zum Verständnis der Clawdbot KI-Assistenten-Architektur, Sitzungen, Multi-Agent-Routing und Nachrichtenverarbeitung.

Clawdbot Konzepte Überblick

Das Verständnis der Kernkonzepte von Clawdbot hilft Ihnen, Ihren KI-Assistenten effektiv zu konfigurieren und zu nutzen. Dieser Abschnitt behandelt die grundlegenden Bausteine von Clawdbot.

Schlüsselkonzepte

Gateway-Architektur

Das Gateway ist der zentrale Daemon, der:

Alle Messaging-Provider-Verbindungen aufrechterhält
Eine typisierte WebSocket-API bereitstellt
Agent-Runtime und Sitzungen verwaltet
Nachrichtenrouting übernimmt

Mehr über die Gateway-Architektur erfahren

Sitzungen

Clawdbot behandelt eine Direktchat-Sitzung pro Agent als primär:

Direktchats werden zu agent:<agentId>:<mainKey> zusammengefasst
Gruppen-/Kanalchats erhalten eigene Schlüssel
Der Sitzungszustand gehört dem Gateway

Multi-Agent-Routing

Führen Sie mehrere isolierte Agenten mit separaten:

Arbeitsbereichen (Dateien, Persona-Regeln)
Zustandsverzeichnissen
Sitzungsspeichern
Authentifizierungsprofilen aus

Agent-Runtime

Der Agent-Runtime übernimmt:

Nachrichtenverarbeitung
Tool-Ausführung
Kontextverwaltung
Antwortgenerierung

Sitzungsverwaltung

DM-Bereichsoptionen

Bereich	Beschreibung
`main` (Standard)	Alle DMs teilen die Hauptsitzung
`per-peer`	Isolation nach Absender-ID über Kanäle
`per-channel-peer`	Isolation nach Kanal + Absender
`per-account-channel-peer`	Isolation nach Konto + Kanal + Absender

Sitzungsschlüssel

Quelle	Schlüsselformat
Direktchats	`agent:<agentId>:<mainKey>`
Gruppenchats	`agent:<agentId>:<channel>:group:<id>`
Cron-Jobs	`cron:<job.id>`
Webhooks	`hook:<uuid>`

Sitzungslebenszyklus

Sitzungen werden bis zum Ablauf wiederverwendet
Täglicher Reset standardmäßig um 4:00 Uhr Ortszeit
Optionaler Leerlauf-Reset über idleMinutes

Multi-Agent-Einrichtung

Was ist ein Agent?

Ein Agent ist ein vollständig abgegrenztes Gehirn mit:

Arbeitsbereich: Dateien, AGENTS.md, SOUL.md, Persona-Regeln
Zustandsverzeichnis: Authentifizierungsprofile, Modellregistrierung
Sitzungsspeicher: Chat-Verlauf + Routing-Zustand
Skills: Pro Agent über den skills/-Ordner des Arbeitsbereichs

Einzelagent-Modus (Standard)

agentId ist standardmäßig main
Sitzungen werden als agent:main:<mainKey> identifiziert
Arbeitsbereich unter ~/.clawdbot/workspace

Agenten hinzufügen

# Neuen Agenten hinzufügen
clawdbot agents add work

# Agenten mit Bindings auflisten
clawdbot agents list --bindings

Routing-Regeln

Nachrichten werden über Bindings an Agenten geroutet:

{
  "bindings": [
    {
      "agentId": "alex",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "dm", "id": "+15551230001" }
      }
    }
  ]
}

Nachrichtenverarbeitung

Streaming und Chunking

Clawdbot unterstützt Streaming-Antworten:

Teilweise Nachrichtenaktualisierungen
Tippindikatoren
Chunked Delivery für lange Antworten

Retry-Richtlinie

Fehlgeschlagene Nachrichten werden mit folgenden Optionen wiederholt:

Exponentieller Backoff
Konfigurierbare Retry-Limits
Fehlerbehandlung

Wo der Zustand gespeichert wird

Element	Speicherort
Konfiguration	`~/.clawdbot/clawdbot.json`
Sitzungen	`~/.clawdbot/agents/<agentId>/sessions/`
Transkripte	`~/.clawdbot/agents/<agentId>/sessions/<SessionId>.jsonl`
Auth-Profile	`~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`

Nächste Schritte

Clawdbot Gateway - Gateway-Konfiguration
Clawdbot Tools - Tool-Konfiguration
Clawdbot Kanäle - Kanal-Einrichtung

Clawdbot Konzepte

On this page