OpenClaw als KI-Agent
Die Schleife, die eine Nachricht in Aktionen verwandelt, und was sie umgibt
Dass OpenClaw ein KI-Agent genannt wird, liegt an dem, was zwischen einer Nachricht und einer Antwort passiert. Die Dokumentation beschreibt es als serialisierten Lauf pro Sitzung: Annahme, Kontextaufbau, Modellinferenz, Tool-Ausführung, Streaming und Persistenz, wobei der Tool-Schritt der Teil ist, den ein Chatbot nicht hat. Um die Schleife herum sitzen ein Gateway, dem jede Messaging-Oberfläche gehört, Nodes, die Geräte beisteuern, Sub-Agenten, die im Hintergrund laufen, und Zeitpläne, die Läufe von selbst starten. Hier ist die Schleife, wie die Architekturseiten sie beschreiben, was zusammengestellt wird, bevor das Modell spricht, die Bausteine darum herum und die Hooks, mit denen Sie ihr Verhalten ändern können.
Die Agent-Schleife ist der serialisierte Lauf pro Sitzung, der eine Nachricht in Aktionen und eine Antwort verwandelt: Annahme, Kontextaufbau, Modellinferenz, Tool-Ausführung, Streaming, Persistenz.
Die Schleife
- Eine Agent-Anfrage validiert ihre Parameter, löst die Sitzung auf, speichert die Sitzungsmetadaten dauerhaft und gibt sofort eine Lauf-ID zurück; ein separater Warte-Aufruf blockiert, bis der Lebenszyklus des Laufs endet.
- Der Lauf ermittelt das Modell und seine Thinking-Standardwerte, lädt den Skills-Snapshot, baut die Sitzung auf, abonniert Laufzeitereignisse, streamt Deltas von Assistent und Tools und setzt das Timeout des Laufs durch.
- Läufe werden pro Sitzungsschlüssel serialisiert, optional zusätzlich über eine globale Lane, sodass keine Race Conditions zwischen Tools und Sitzungen auftreten können; ein dauerhafter Schreibanspruch sichert jeden Schreibvorgang ins Transkript ab, und ein abgelöster Lauf kann keine veralteten Daten festschreiben.
Was zusammengestellt wird, bevor das Modell spricht
Der Workspace wird aufgelöst und angelegt, und ein Lauf in der Sandbox kann auf ein Sandbox-Stammverzeichnis umgeleitet werden. Skills werden geladen oder aus einem Snapshot wiederverwendet und in die Umgebung und den Prompt eingefügt. Bootstrap-Kontextdateien kommen in den System-Prompt, der aus dem Basis-Prompt von OpenClaw, dem Skills-Prompt, dem Bootstrap-Kontext und Überschreibungen pro Lauf gebaut wird, wobei die Grenzen des Modells und die Reserve für die Kompaktierung eingehalten werden. Messaging-Kanäle wählen einen Queue-Modus, der die Sitzungs-Lane speist; deshalb lenkt eine zweite Nachricht während eines Laufs diesen um oder folgt ihm nach, statt mit ihm zu kollidieren.
Rund um die Schleife
- Das Gateway: ein einziger langlebiger Prozess, dem alle Messaging-Oberflächen gehören und der eine typisierte WebSocket-API bereitstellt; die macOS-App, die CLI, die Web-Oberfläche und Automatisierungen verbinden sich als Clients.
- Nodes: macOS-, iOS-, Android- und Headless-Hosts verbinden sich über denselben WebSocket mit der Node-Rolle und stellen Befehle wie Kamera, Bildschirm und Standort bereit; die Kopplung erfolgt pro Gerät.
- Sub-Agenten und Zeitpläne: Hintergrundläufe, die aus einem Lauf gestartet werden, sowie Cron- oder Heartbeat-Läufe durchlaufen alle dieselbe Schleife und dieselbe Richtlinie.
Mehr zum Prozess, dem die Kanäle gehören, finden Sie unter das OpenClaw-Gateway erklärt, dazu, was ein gekoppeltes Gerät beisteuert, unter OpenClaw-Nodes und Remote Hands und zu den Hintergrundläufen unter OpenClaw-Sub-Agenten.
Hooks und die Grenze
Im Prozess leben zwei Hook-Systeme: interne Skripte für Befehls- und Lebenszyklusereignisse und typisierte Plugin-Hooks innerhalb der Schleife, vor der Auflösung des Modells, vor dem Aufbau des Prompts, vor der Antwort, nach dem Lauf, rund um Tool-Aufrufe und als Beobachter rund um die Kompaktierung. Webhooks sind davon getrennt: Sie nehmen externe Anfragen entgegen, die Arbeit auslösen, statt Ereignisse der Schleife zu abonnieren. Die Grenze ist dieselbe, die die Sicherheitsseiten ziehen: Der Tool-Schritt macht das Ganze zu einem Agenten, und die Tool-Richtlinie, Skills, die beschreiben statt auszuführen, sowie die Hinweise zu Prompt Injection sorgen dafür, dass ein Agent, der das offene Web liest, nicht von ihm gesteuert wird.
Auf Diali
Auf Diali ist die Schleife derselbe Code, den die Dokumentation beschreibt; was sich ändert, ist, wer das Gateway darum herum betreibt und wer wach ist, wenn ein geplanter Lauf fehlschlägt. Eine Einführung in einfacher Sprache finden Sie unter Was ist OpenClaw, und der Assistent ist gehostetes OpenClaw auf Diali.
- Annahme, Kontext, Inferenz, Tools, Streaming, Persistenz, eine Sitzung nach der anderen.
- Gateway, Nodes, Sub-Agenten und Zeitpläne speisen alle dieselbe Schleife.
- Hooks verändern die Schleife; Richtlinie und Sandboxing begrenzen sie.
Genug gelesen, bauen Sie selbst einen
Richten Sie einen Agenten ein, wählen Sie einen Kanal und lassen Sie ihn in der App arbeiten, die Sie ohnehin geöffnet haben.
