English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Fundamentals

Agent-Arbeitsbereich

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.

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:
json5
{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

openclaw onboard, openclaw configure oder openclaw setup erstellt den Arbeitsbereich und legt die Bootstrap-Dateien an, wenn sie fehlen.

Wenn Sie die Arbeitsbereichsdateien bereits selbst verwalten, können Sie die Erstellung von Bootstrap-Dateien deaktivieren:

json5
{ 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.

Dateizuordnung des Arbeitsbereichs

Dies sind die Standarddateien, die OpenClaw im Arbeitsbereich erwartet:

AGENTS.md - Betriebsanweisungen

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.

SOUL.md - Persona und Ton

Persona, Ton und Grenzen. Wird in jeder Sitzung geladen. Anleitung: SOUL.md-Persönlichkeitsleitfaden.

USER.md - wer der Benutzer ist

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

IDENTITY.md - Name, Stimmung, Emoji

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

TOOLS.md - lokale Tool-Konventionen

Hinweise zu Ihren lokalen Tools und Konventionen. Steuert nicht die Tool-Verfügbarkeit; es dient nur als Orientierung.

HEARTBEAT.md - Heartbeat-Checkliste

Optionale kleine Checkliste für Heartbeat-Läufe. Halten Sie sie kurz, um Token-Verbrauch zu vermeiden.

BOOT.md - Startcheckliste

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.

BOOTSTRAP.md - Ritual beim ersten Lauf

Einmaliges Ritual beim ersten Lauf. Wird nur für einen brandneuen Arbeitsbereich erstellt. Löschen Sie es, nachdem das Ritual abgeschlossen ist.

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

Tägliches Gedächtnisprotokoll (eine Datei pro Tag). Empfohlen: heute + gestern beim Sitzungsstart 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 geteilten/Gruppenkontexten). Siehe Memory für den Workflow und den automatischen Gedächtnis-Flush.

skills/ - Arbeitsbereichs-Skills (optional)

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/ - Canvas-UI-Dateien (optional)

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

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).

  • Repo initialisieren

    Wenn git installiert ist, werden brandneue Arbeitsbereiche automatisch initialisiert. Wenn dieser Arbeitsbereich noch kein Repo 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 hinzufügen

    GitHub-Web-UI

    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:
    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-Web-UI

    1. Erstellen Sie ein neues privates Repository auf GitLab.
    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:
    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 Secrets committen

    Vorgeschlagener .gitignore-Starter:

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

    Arbeitsbereich auf einen neuen Rechner verschieben

  • Repo klonen

    Klonen Sie das Repo an den gewünschten Pfad (Standard ~/.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>/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
    Was this useful?
    On this page

    On this page