OpenClaw System Prompts verstehen und anpassen

Kennst du das? Du startest einen AI-Agenten, aber er verhält sich nicht so, wie du es erwartest. Oft liegt das an aufgeblähten System-Prompts, die den Kontext fluten und die eigentliche Aufgabe in den Hintergrund drängen. Manchmal fehlen auch einfach wichtige Infos über die Arbeitsumgebung oder lokale Tools, was zu unnötigen Rückfragen führt.

OpenClaw löst das anders. Statt auf Standard-Prompts zu setzen, baut es für jeden Run einen kompakten, maßgeschneiderten System-Prompt zusammen. So weiß dein Agent immer genau, wo er ist, welche Tools er hat und was er darf.

Voraussetzungen

• Eine aktive OpenClaw-Installation.
• Zugriff auf die Konfigurationsdatei (für agents.defaults).
• Markdown-Dateien im Workspace (z. B. AGENTS.md, SOUL.md).

Schnellstart

OpenClaw nutzt eigene System-Prompts, die nicht auf dem p-coding-agent Default basieren. Hier ist der schnellste Weg, um den Prompt zu verstehen und zu optimieren:

1. Dateien im Workspace hinterlegen: OpenClaw injiziert automatisch wichtige Dateien als “Project Context”. Erstelle dazu einfach folgende Dateien in deinem Workspace (agents.defaults.workspace):
   • AGENTS.md
   • SOUL.md
   • TOOLS.md
   • IDENTITY.md
2. Kontext prüfen: Nutze den Befehl /context list oder /context detail, um zu sehen, wie viel Platz die injizierten Dateien und Tool-Schemas verbrauchen.
3. Zeit und Region einstellen: Damit der Agent zeitliche Zusammenhänge versteht, konfiguriere deine Zeitzone in der Config:

   "agents.defaults.userTimezone": "Europe/Berlin",
   "agents.defaults.timeFormat": "24"

4. Agent-Update: Wenn du Änderungen an der Konfiguration vornimmst, führe config.apply oder update.run aus, um die Umgebung zu aktualisieren.

Fehlerbehebung

• Agent kennt die exakte Uhrzeit nicht: Der System-Prompt enthält aus Cache-Gründen nur die Zeitzone. Wenn der Agent die genaue Uhrzeit benötigt, sollte er session_status aufrufen.
• Dateien werden im Prompt abgeschnitten: Große Dateien werden automatisch gekürzt. Den Grenzwert steuerst du über agents.defaults.bootstrapMaxChars (Standard: 20000).
• Skills werden nicht angezeigt: Skills erscheinen nur im Prompt, wenn sie “eligible” sind. Der Agent sieht dann eine Liste und muss die entsprechende SKILL.md per read laden:

  <available_skills>
    <skill>
      <name>...</name>
      <description>...</description>
      <location>...</location>
    </skill>
  </available_skills>

• Fehlende Berechtigungen: Safety-Guardrails im Prompt sind beratend. Für echte Zugriffskontrolle musst du Tool-Policies, Sandboxing oder Channel-Allowlists nutzen.

AI Setup Assistant

Nächste Schritte

• Context
• Date & Time