OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Fundamentals

Agenten-Arbeitsbereich

Der Workspace ist das Zuhause des Agenten: das Arbeitsverzeichnis, das für Datei-Tools und den Workspace-Kontext verwendet wird. Halten Sie ihn privat und behandeln Sie ihn als Gedächtnis.

Dies ist getrennt von ~/.openclaw/, wo Konfiguration, Anmeldedaten und Sitzungen gespeichert werden.

Standardspeicherort

  • Standard: ~/.openclaw/workspace
  • Wenn OPENCLAW_PROFILE gesetzt und nicht "default" ist, wird ~/.openclaw/workspace-<profile> zum Standard.
  • Wenn OPENCLAW_WORKSPACE_DIR gesetzt ist, überschreibt es beide vorstehenden Einstellungen.
  • Nicht standardmäßige Agenten (agents.list[]) ohne expliziten Workspace werden zu <state-dir>/workspace-<agentId> aufgelöst, nicht zum gemeinsamen Standard-Workspace.

Überschreiben Sie dies in ~/.openclaw/openclaw.json:

json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

Agentenspezifische Überschreibung: agents.list[].workspace.

openclaw onboard, openclaw configure oder openclaw setup erstellen den Workspace und legen die Bootstrap-Dateien an, wenn sie fehlen.

Wenn Sie die Workspace-Dateien bereits selbst verwalten, deaktivieren Sie die Erstellung von Bootstrap-Dateien:

json5
{ agents: { defaults: { skipBootstrap: true } } }

Zusätzliche Workspace-Ordner

Ältere Installationen haben möglicherweise ~/openclaw erstellt. Mehrere Workspace-Verzeichnisse können zu verwirrenden Abweichungen bei Authentifizierung oder Zustand führen, da jeweils nur ein Workspace aktiv ist.

Übersicht der Workspace-Dateien

Standarddateien, die OpenClaw im Workspace erwartet:

AGENTS.md – Betriebsanweisungen

Betriebsanweisungen für den Agenten und zur Verwendung des Gedächtnisses. Wird zu Beginn jeder Sitzung geladen. Ein guter Ort für Regeln, Prioritäten und Details zum gewünschten Verhalten.

SOUL.md – Persönlichkeit und Ton

Persönlichkeit, Ton und Grenzen. Wird in jeder Sitzung geladen. Leitfaden: Leitfaden zur Persönlichkeit in SOUL.md.

USER.md – Informationen zum Benutzer

Wer der Benutzer ist und wie er angesprochen werden soll. Wird in jeder Sitzung geladen.

IDENTITY.md – Name, Ausstrahlung, Emoji

Name, Ausstrahlung und Emoji des Agenten. Wird während des Bootstrap-Rituals erstellt oder aktualisiert.

TOOLS.md – lokale Tool-Konventionen

Hinweise zu Ihren lokalen Tools und Konventionen. Steuert nicht die Verfügbarkeit von Tools, sondern dient nur als Orientierung.

HEARTBEAT.md – Heartbeat-Checkliste

Optionale kurze Checkliste für Heartbeat-Ausführungen. Halten Sie sie kurz, um unnötigen Tokenverbrauch zu vermeiden.

BOOT.md – Startcheckliste

Optionale Startcheckliste, die bei einem Neustart des Gateway automatisch ausgeführt wird (wenn interne Hooks aktiviert sind). Halten Sie sie kurz; verwenden Sie das Nachrichten-Tool für ausgehende Nachrichten.

BOOTSTRAP.md – Ritual bei der ersten Ausführung

Einmaliges Ritual bei der ersten Ausführung. Wird nur für einen völlig neuen Workspace erstellt. Löschen Sie die Datei, nachdem das Ritual abgeschlossen ist.

memory/YYYY-MM-DD.md – tägliches Gedächtnisprotokoll

Tägliches Gedächtnisprotokoll (eine Datei pro Tag). Es wird empfohlen, beim Sitzungsstart die Einträge von heute und gestern zu lesen.

MEMORY.md – kuratiertes Langzeitgedächtnis (optional)

Kuratiertes Langzeitgedächtnis: dauerhafte Fakten, Präferenzen, Entscheidungen und kurze Zusammenfassungen. Bewahren Sie detaillierte Protokolle in memory/YYYY-MM-DD.md auf, damit Gedächtnis-Tools sie bei Bedarf abrufen können, ohne sie in jeden Prompt einzufügen. Laden Sie MEMORY.md nur in der privaten Hauptsitzung (nicht in gemeinsamen oder Gruppenkontexten). Siehe Gedächtnis für den Arbeitsablauf und die automatische Speicherung des Gedächtnisses.

skills/ – Workspace-Skills (optional)

Workspace-spezifische Skills. Der Skill-Speicherort mit der höchsten Priorität für diesen Workspace, noch vor Projekt-Agenten-Skills, persönlichen Agenten-Skills, verwalteten Skills, mitgelieferten Skills und skills.load.extraDirs, wenn Namen kollidieren.

canvas/ – Canvas-UI-Dateien (optional)

Canvas-UI-Dateien für Node-Anzeigen (zum Beispiel canvas/index.html).

Was sich NICHT im Workspace befindet

Diese Elemente befinden sich unter ~/.openclaw/ und sollten NICHT in das Workspace-Repository eingecheckt werden:

  • ~/.openclaw/openclaw.json (Konfiguration)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (Modell-Authentifizierungsprofile: OAuth + API-Schlüssel)
  • ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (Sitzungszeilen, Transkripte und agentenspezifischer Laufzeitzustand)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (agentenspezifisches Codex-Laufzeitkonto, Konfiguration, Skills, Plugins und nativer Thread-Zustand)
  • ~/.openclaw/credentials/ (Kanal-/Provider-Zustand sowie ältere OAuth-Importdaten)
  • ~/.openclaw/agents/<agentId>/sessions/ (Quellen für ältere Migrationen und Archiv-/Support-Artefakte)
  • ~/.openclaw/skills/ (verwaltete Skills)

Wenn Sie Sitzungen oder Konfigurationen migrieren müssen, kopieren Sie sie separat und halten Sie sie von der Versionsverwaltung fern.

Git-Sicherung (empfohlen, privat)

Behandeln Sie den Workspace als privates Gedächtnis. Legen Sie ihn in einem privaten Git-Repository ab, damit er gesichert und wiederherstellbar ist.

Führen Sie diese Schritte auf dem Computer aus, auf dem der Gateway läuft (dort befindet sich der Workspace).

  • Repository initialisieren

    Wenn Git installiert ist, werden völlig neue Workspaces automatisch initialisiert. Falls dieser Workspace noch kein Repository ist, führen Sie Folgendes aus:

    bash
    cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

  • Privates Remote-Repository hinzufügen

    GitHub-Weboberfläche

    1. Erstellen Sie auf GitHub ein neues privates Repository.
    2. Initialisieren Sie es nicht mit einer README (dies vermeidet Merge-Konflikte).
    3. Kopieren Sie die HTTPS-Remote-URL.
    4. Fügen Sie das Remote-Repository hinzu und übertragen Sie die Änderungen:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

    bash
    gh auth logingh repo create openclaw-workspace --private --source . --remote origin --push

    GitLab-Weboberfläche

    1. Erstellen Sie auf GitLab ein neues privates Repository.
    2. Initialisieren Sie es nicht mit einer README (dies vermeidet Merge-Konflikte).
    3. Kopieren Sie die HTTPS-Remote-URL.
    4. Fügen Sie das Remote-Repository hinzu und übertragen Sie die Änderungen:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • Laufende Aktualisierungen

    bash
    git statusgit add .git commit -m "Update memory"git push

    • Keine Geheimnisse einchecken

    Vorschlag für eine .gitignore-Ausgangsdatei:

    gitignore
    .DS_Store.env**/*.key**/*.pem**/secrets*

    Workspace auf einen neuen Computer verschieben

  • Repository klonen

    Klonen Sie das Repository in den gewünschten Pfad (standardmäßig ~/.openclaw/workspace).

  • Konfiguration aktualisieren

    Setzen Sie agents.defaults.workspace in ~/.openclaw/openclaw.json auf diesen Pfad.

  • Fehlende Dateien anlegen

    Führen Sie openclaw setup --workspace <path> aus, um fehlende Dateien anzulegen.

  • Sitzungen kopieren (optional)

    Wenn Sie Sitzungen benötigen, kopieren Sie ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite separat vom alten Computer. Kopieren Sie ~/.openclaw/agents/<agentId>/sessions/ nur, wenn Sie auch Eingaben für ältere Migrationen oder Archiv-/Support-Artefakte benötigen.

    • Erweiterte Hinweise

    • Beim Multi-Agent-Routing können über agents.list[].workspace unterschiedliche Workspaces pro Agent verwendet werden. Informationen zur Routing-Konfiguration finden Sie unter Kanal-Routing.
    • Wenn agents.defaults.sandbox aktiviert ist, können Nicht-Hauptsitzungen sitzungsspezifische Sandbox-Workspaces unter agents.defaults.sandbox.workspaceRoot verwenden.

    Verwandte Themen

    Was this useful?
    On this page

    On this page