OpenClaw Agent Runtime Guide

Jeder, der schon mal versucht hat, einen AI Agent in einen bestehenden Workflow zu integrieren, kennt das Problem: Der Kontext geht verloren, die Anweisungen sind überall verstreut und am Ende macht der Agent doch, was er will. Ein strukturierter Workspace und eine klar definierte Runtime sind entscheidend, damit deine Tools und Befehle zuverlässig funktionieren.

OpenClaw nutzt eine eingebettete Agent Runtime, die von pi-mono abgeleitet ist. Hier erfährst du, wie du alles richtig aufsetzt.

Voraussetzungen

Bevor du startest, stelle sicher, dass du folgende Punkte aus der Dokumentation bereit hast:

• Ein definiertes Verzeichnis für den Workspace (agents.defaults.workspace).
• Die Konfiguration channels.whatsapp.allowFrom (dringend empfohlen).
• Zugriff auf die Konfigurationsdatei openclaw.json.

Schnellstart

In fünf Minuten zum laufenden Agent:

1. Setup ausführen: Nutze den Befehl openclaw setup. Das erstellt die Datei ~/.openclaw/openclaw.json und initialisiert die Workspace-Dateien.
2. Workspace prüfen: Dein Agent nutzt ausschließlich das in agents.defaults.workspace definierte Verzeichnis als Working Directory (cwd).
3. Bootstrap-Dateien bearbeiten: Erstelle oder editiere die Dateien AGENTS.md und SOUL.md in deinem Workspace, um die Identität und die Regeln deines Agents festzulegen.
4. Minimal-Konfiguration: Stelle sicher, dass dein Workspace-Pfad in der Config hinterlegt ist.

Workspace und Bootstrap-Dateien

Der Workspace ist der einzige Ort, an dem dein Agent arbeitet. OpenClaw injiziert beim Start einer Session den Inhalt spezieller Markdown-Dateien direkt in den Kontext.

Diese Dateien kannst du im Workspace anlegen:

• AGENTS.md: Arbeitsanweisungen und “Gedächtnis”.
• SOUL.md: Persönlichkeit und Grenzen.
• TOOLS.md: Deine Notizen zur Tool-Nutzung.
• IDENTITY.md: Name und Emoji des Agents.
• USER.md: Dein Profil.

Falls du einen bereits vorbereiteten Workspace nutzt und keine automatischen Bootstrap-Dateien wünschst, kannst du das so deaktivieren:

{ agent: { skipBootstrap: true } }

Skills und Tools

OpenClaw lädt Skills aus drei Quellen. Wenn Namen kollidieren, gewinnt immer der Workspace:

1. Bundled: Mit der Installation geliefert.
2. Managed/local: In ~/.openclaw/skills.
3. Workspace: In <workspace>/skills.

Die Core-Tools für Dateizugriffe (read/exec/edit/write) sind immer verfügbar. Beachte, dass TOOLS.md nicht bestimmt, welche Tools existieren, sondern dem Agent lediglich Anweisungen gibt, wie er sie verwenden soll.

Steering und Streaming

Wenn du Nachrichten sendest, während der Agent noch arbeitet, entscheidet der queue Modus über das Verhalten:

• steer: Nachrichten werden sofort injiziert. Die Queue wird nach jedem Tool-Call geprüft. Falls eine Nachricht wartet, werden restliche Tool-Calls übersprungen und der Agent reagiert direkt auf deinen neuen Input.
• followup / collect: Nachrichten werden gehalten, bis der aktuelle Turn beendet ist.

Das Block Streaming ist standardmäßig deaktiviert (agents.defaults.blockStreamingDefault: "off"). Wenn du es aktivierst, sendet OpenClaw fertige Textblöcke, sobald diese generiert wurden.

Model Refs richtig formatieren

Modell-Referenzen in der Config werden am ersten / getrennt. So adressierst du Modelle korrekt:

• Verwende das Format provider/model.
• Bei OpenRouter-Modellen, die selbst ein / enthalten, muss der Provider davor stehen: openrouter/moonshotai/kimi-k2.
• Ohne / wird das Modell dem Default-Provider zugeordnet.

Fehlerbehebung

• Fehlende Dateien: Wenn eine Bootstrap-Datei fehlt, fügt OpenClaw einen “missing file” Marker ein. Nutze openclaw setup, um Standard-Templates zu erstellen.
• BOOTSTRAP.md wird nicht erstellt: Diese Datei wird nur erzeugt, wenn der Workspace komplett neu ist. Wenn du sie nach dem ersten Start löschst, erscheint sie nicht erneut.
• Tool-Fehler bei Steering: Im steer Modus werden übersprungene Tool-Calls mit der Meldung “Skipped due to queued user message” markiert. Das ist ein erwartetes Verhalten, um auf deinen neuen Input zu reagieren.

Hast du Fragen zum Setup? Nutze den AI Setup Assistant.

What’s Next: Group Chats 🦞