OpenClaw Architektur-Überblick

源码版本v2026.6.11

In einem Satz

OpenClaw ist ein persönlicherKI-Assistent aus residentem Gateway (gateway) + Multi-Kanal-Anbindung + Agent-Hauptschleife (agent loop): Das Gateway empfängt Nachrichten → reicht sie an den Agenten weiter → der Agent ruft in einer Schleife Modell und Werkzeuge auf → das Ergebnis wird über das Gateway an die Kanäle zurückgeliefert. Alle Fähigkeiten (Werkzeuge/Fertigkeiten/Plugins/Provider/MCP/Kanäle) sind austauschbare Registry-basierte Registrierungen.

Schichten

Jede Schicht in einem Satz

• Start und Einstieg: openclaw.mjs prüft die Node-Version und leitet an src/entry.ts weiter; src/cli/run-main.ts verteilt dann die Unterkommandos.
• Gateway-Schicht: startGatewayServer ist der residente Prozess, empfängt über die RPC-Methodentabelle Anfragen und broadcastet Agent-Ereignisse an WebSocket-Clients.
• Agent-Hauptschleife: Die while(true) im embedded-agent-runner treibt jede Conversationsrunde an; ein einzelner Attempt (attempt) erledigt den LLM-Aufruf und das Paaren von tool_use/tool_result.
• Fähigkeitsschicht: Werkzeuge sind als Map registriert, Fertigkeiten sind Markdown-Anleitungen, die das Modell selbst liest, Plugins werden über Verzeichniskonventionen entdeckt, Provider pro Anbieter getrennt, MCP brückt bidirektional.
• Kanalschicht: 22 Kanäle (WhatsApp/Telegram/Slack...) werden über Registry + Loader + Plugin registriert, das Gateway koordiniert einheitlich.
• Konfigurationssystem: openclaw.json ist der einzige Konfigurationseinstieg; ein Zod-Schema übernimmt die Laufzeit-Validierung.
• Gedächtnis und Kontext: Die Context Engine abstrahiert die Komprimierungsvereinbarung; Gedächtnisdateien liegen im Workspace-Root.
• Zeitplanung und Erweiterung: Cron läuft Jobs in einer isolierten Agent-Sitzung, Tasks persistieren über SQLite, ACP brückt IDEs.
• Bereitstellung: Das Gateway ist ein residenter Prozess; der Daemon verpackt ihn als Systemdienst, oder er läuft in Docker/Fly.

Schichtmotivation

Warum diese Trennung? OpenClaw entkoppelt vollständig: „Woher kommen Nachrichten" (Kanäle), „Wie verarbeitenen" (Agent-Schleife), „Welche Fähigkeiten" (Werkzeuge/Fertigkeiten/Plugins/Provider), „Wie persistieren" (Konfiguration/Gedächtnis/Zeitplanung), „Wie starten" (Bereitstellung). So berührt ein Kanalwechsel nicht die Agent-Logik, ein Modellwechsel nicht die Werkzeuge, eine Plugin-Erweiterung nicht den Kern. Das Gateway ist der einzige Knotenpunkt; alle schichtübergreifenden Koordinationen laufen über es.

Häufige Missverständnisse

• „OpenClaw ist ein Chat-Bot" — Nicht ganz. Ein Bot ist nur eine Seite der Kanalschicht; das Gateway ist der Produktkern, die Agent-Schleife das Gehirn.
• „Werkzeuge und Fertigkeiten sind dasselbe" — Falsch. Werkzeuge sind aufrufbare Funktionen; Fertigkeiten sind Markdown-Anleitungen, bei denen das Modell selbst entscheidet, wann es sie liest und was es danach tut.
• „MCP ist nur ein Client" — OpenClaw ist gleichzeitig MCP-Server (exponiert eigene Fähigkeiten nach außen) und Client (konsumiert externe MCP-Server).

Empfohlene Lesereihenfolge

Zuerst Start und Einstieg, dann Gateway-Kern und Agent-Hauptschleife, anschließend in der Reihenfolge Fähigkeitsschicht → Kanalschicht → Konfigurationssystem → Gedächtnis → Zeitplanung → Bereitstellung.

Vergleichende offizielle Ressourcen: OpenClaw-Website · Offizielle Doku · DeepWiki.