Zum Hauptinhalt springen
Der Arbeitsbereich ist das Zuhause des Agenten. Er ist das einzige Arbeitsverzeichnis, das für Datei-Tools und für Arbeitsbereichskontext 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.
Der Arbeitsbereich ist das standardmäßige cwd, keine harte Sandbox. Tools lösen relative Pfade relativ zum Arbeitsbereich auf, absolute Pfade können jedoch weiterhin andere Stellen auf dem Host erreichen, sofern Sandboxing nicht aktiviert ist. Wenn Sie Isolierung benötigen, verwenden Sie agents.defaults.sandbox (und/oder eine Sandbox-Konfiguration pro Agent).Wenn Sandboxing aktiviert ist und workspaceAccess nicht "rw" ist, arbeiten Tools in einem Sandbox-Arbeitsbereich unter ~/.openclaw/sandboxes, nicht in Ihrem Host-Arbeitsbereich.

​
Standardspeicherort

  • Standard: ~/.openclaw/workspace
  • Wenn OPENCLAW_PROFILE gesetzt ist und nicht "default" ist, wird der Standard zu ~/.openclaw/workspace-<profile>.
  • Überschreiben in ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure oder openclaw setup erstellt den Arbeitsbereich und legt die Bootstrap-Dateien an, wenn sie fehlen.
Sandbox-Seed-Kopien akzeptieren nur reguläre Dateien innerhalb des Arbeitsbereichs; Symlink-/Hardlink-Aliase, die außerhalb des Quellarbeitsbereichs aufgelöst werden, werden ignoriert.
Wenn Sie die Arbeitsbereichsdateien bereits selbst verwalten, können Sie die Erstellung von Bootstrap-Dateien deaktivieren: 
{ agents: { defaults: { skipBootstrap: true } } }

​
Zusätzliche Arbeitsbereichsordner

Ältere Installationen haben möglicherweise ~/openclaw erstellt. Mehrere Arbeitsbereichsverzeichnisse parallel vorzuhalten, kann zu verwirrenden Authentifizierungs- oder Zustandsabweichungen führen, da immer nur ein Arbeitsbereich aktiv ist.
Empfehlung: Verwenden Sie einen einzigen aktiven Arbeitsbereich. Wenn Sie die zusätzlichen Ordner nicht mehr verwenden, archivieren Sie sie oder verschieben Sie sie in den Papierkorb (zum Beispiel trash ~/openclaw). Wenn Sie absichtlich mehrere Arbeitsbereiche behalten, stellen Sie sicher, dass agents.defaults.workspace auf den aktiven verweist.openclaw doctor warnt, wenn zusätzliche Arbeitsbereichsverzeichnisse erkannt werden.

​
Dateizuordnung des Arbeitsbereichs

Dies sind die Standarddateien, die OpenClaw im Arbeitsbereich erwartet:
Betriebsanweisungen für den Agenten und wie er Gedächtnis verwenden soll. Wird zu Beginn jeder Sitzung geladen. Ein guter Ort für Regeln, Prioritäten und Details zum Verhalten.
Persona, Ton und Grenzen. Wird in jeder Sitzung geladen. Anleitung: SOUL.md-Persönlichkeitsleitfaden.
Wer der Benutzer ist und wie er angesprochen werden soll. Wird in jeder Sitzung geladen.
Name, Stimmung und Emoji des Agenten. Wird während des Bootstrap-Rituals erstellt/aktualisiert.
Hinweise zu Ihren lokalen Tools und Konventionen. Steuert nicht die Tool-Verfügbarkeit; es dient nur als Orientierung.
Optionale kleine Checkliste für Heartbeat-Läufe. Halten Sie sie kurz, um Token-Verbrauch zu vermeiden.
Optionale Startcheckliste, die beim Neustart des Gateways automatisch ausgeführt wird (wenn interne Hooks aktiviert sind). Halten Sie sie kurz; verwenden Sie das Nachrichten-Tool für ausgehende Sendungen.
Einmaliges Ritual beim ersten Lauf. Wird nur für einen brandneuen Arbeitsbereich erstellt. Löschen Sie es, nachdem das Ritual abgeschlossen ist.
Tägliches Gedächtnisprotokoll (eine Datei pro Tag). Empfohlen: heute + gestern beim Sitzungsstart lesen.
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 geteilten/Gruppenkontexten). Siehe Memory für den Workflow und den automatischen Gedächtnis-Flush.
Arbeitsbereichsspezifische Skills. Skill-Speicherort mit höchster Priorität für diesen Arbeitsbereich. Überschreibt Projekt-Agent-Skills, persönliche Agent-Skills, verwaltete Skills, gebündelte Skills und skills.load.extraDirs, wenn Namen kollidieren.
Canvas-UI-Dateien für Knotenanzeigen (zum Beispiel canvas/index.html).
Wenn eine Bootstrap-Datei fehlt, fügt OpenClaw einen Marker für eine „fehlende Datei“ in die Sitzung ein und fährt fort. Große Bootstrap-Dateien werden beim Einfügen gekürzt; passen Sie die Grenzen mit agents.defaults.bootstrapMaxChars (Standard: 20000) und agents.defaults.bootstrapTotalMaxChars (Standard: 60000) an. openclaw setup kann fehlende Standarddateien neu erstellen, ohne vorhandene Dateien zu überschreiben.

​
Was NICHT im Arbeitsbereich liegt

Diese Inhalte befinden sich unter ~/.openclaw/ und sollten NICHT in das Arbeitsbereichs-Repo committet werden:
  • ~/.openclaw/openclaw.json (Konfiguration)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (Modell-Authentifizierungsprofile: OAuth + API-Schlüssel)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (agentenspezifisches Codex-Laufzeitkonto, Konfiguration, Skills, Plugins und nativer Thread-Zustand)
  • ~/.openclaw/credentials/ (Channel-/Provider-Zustand plus Legacy-OAuth-Importdaten)
  • ~/.openclaw/agents/<agentId>/sessions/ (Sitzungstranskripte + Metadaten)
  • ~/.openclaw/skills/ (verwaltete Skills)
Wenn Sie Sitzungen oder Konfiguration migrieren müssen, kopieren Sie sie separat und halten Sie sie aus der Versionskontrolle heraus.

​
Git-Backup (empfohlen, privat)

Behandeln Sie den Arbeitsbereich als privates Gedächtnis. Legen Sie ihn in einem privaten Git-Repo ab, damit er gesichert und wiederherstellbar ist. Führen Sie diese Schritte auf dem Rechner aus, auf dem der Gateway läuft (dort befindet sich der Arbeitsbereich).
1

Repo initialisieren

Wenn git installiert ist, werden brandneue Arbeitsbereiche automatisch initialisiert. Wenn dieser Arbeitsbereich noch kein Repo ist, führen Sie Folgendes aus:
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
2

Privates Remote hinzufügen

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

Laufende Aktualisierungen

git status
git add .
git commit -m "Update memory"
git push

​
Keine Secrets committen

Vermeiden Sie es selbst in einem privaten Repo, Secrets im Arbeitsbereich zu speichern:
  • API-Schlüssel, OAuth-Tokens, Passwörter oder private Anmeldedaten.
  • Alles unter ~/.openclaw/.
  • Roh-Dumps von Chats oder sensiblen Anhängen.
Wenn Sie sensible Referenzen speichern müssen, verwenden Sie Platzhalter und bewahren Sie das echte Secret an anderer Stelle auf (Passwortmanager, Umgebungsvariablen oder ~/.openclaw/).
Vorgeschlagener .gitignore-Starter: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
Arbeitsbereich auf einen neuen Rechner verschieben

1

Repo klonen

Klonen Sie das Repo an den gewünschten Pfad (Standard ~/.openclaw/workspace).
2

Konfiguration aktualisieren

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

Fehlende Dateien anlegen

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

Sitzungen kopieren (optional)

Wenn Sie Sitzungen benötigen, kopieren Sie ~/.openclaw/agents/<agentId>/sessions/ separat vom alten Rechner.

​
Erweiterte Hinweise

  • Multi-Agent-Routing kann unterschiedliche Arbeitsbereiche pro Agent verwenden. Siehe Channel-Routing für die Routing-Konfiguration.
  • Wenn agents.defaults.sandbox aktiviert ist, können Nicht-Hauptsitzungen Sandbox-Arbeitsbereiche pro Sitzung unter agents.defaults.sandbox.workspaceRoot verwenden.

​
Verwandte Themen

  • Heartbeat - HEARTBEAT.md-Arbeitsbereichsdatei
  • Sandboxing - Arbeitsbereichszugriff in Sandbox-Umgebungen
  • Session - Sitzungsspeicherpfade
  • Standing Orders - persistente Anweisungen in Arbeitsbereichsdateien