English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Fundamentals

Agenten-Arbeitsbereich

Der Workspace ist das Zuhause des Agenten. Er ist das einzige Arbeitsverzeichnis, das für Datei-Tools und für Workspace-Kontext verwendet wird. Halten Sie ihn privat und behandeln Sie ihn als Speicher.

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

Standardort

  • 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 Workspace und legt die Bootstrap-Dateien an, falls sie fehlen.

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

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

Zusätzliche Workspace-Ordner

Ältere Installationen haben möglicherweise ~/openclaw erstellt. Mehrere Workspace-Verzeichnisse beizubehalten, kann zu verwirrender Authentifizierungs- oder Zustandsdrift führen, da immer nur ein Workspace aktiv ist.

Workspace-Dateiübersicht

Dies sind die Standarddateien, die OpenClaw innerhalb des Workspace erwartet:

AGENTS.md - operating instructions

Betriebsanweisungen für den Agenten und dazu, wie er Speicher verwenden soll. Wird zu Beginn jeder Sitzung geladen. Ein guter Ort für Regeln, Prioritäten und Details zum gewünschten Verhalten.

SOUL.md - persona and tone

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

USER.md - who the user is

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

IDENTITY.md - name, vibe, emoji

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

TOOLS.md - local tool conventions

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

HEARTBEAT.md - heartbeat checklist

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

BOOT.md - startup checklist

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

BOOTSTRAP.md - first-run ritual

Einmaliges Ritual für den ersten Lauf. Wird nur für einen komplett neuen Workspace erstellt. Löschen Sie es, nachdem das Ritual abgeschlossen ist.

memory/YYYY-MM-DD.md - daily memory log

Tägliches Speicherprotokoll (eine Datei pro Tag). Empfohlen: heute und gestern beim Sitzungsstart lesen.

MEMORY.md - curated long-term memory (optional)

Kuratierter Langzeitspeicher. Nur in der privaten Hauptsitzung laden (nicht in geteilten/Gruppenkontexten). Siehe Speicher für den Workflow und das automatische Leeren des Speichers.

skills/ - workspace skills (optional)

Workspace-spezifische Skills. Skill-Speicherort mit höchster Priorität für diesen Workspace. Überschreibt Projekt-Agent-Skills, persönliche Agent-Skills, verwaltete Skills, gebündelte Skills und skills.load.extraDirs, wenn Namen kollidieren.

canvas/ - Canvas UI files (optional)

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

Was NICHT im Workspace liegt

Diese befinden sich unter ~/.openclaw/ und sollten NICHT in das Workspace-Repo committed werden:

  • ~/.openclaw/openclaw.json (Konfiguration)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (Modell-Authentifizierungsprofile: OAuth + API-Schlüssel)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (Codex-Laufzeitkonto pro Agent, Konfiguration, Skills, Plugins und nativer Thread-Zustand)
  • ~/.openclaw/credentials/ (Channel-/Provider-Zustand plus alte 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 Versionsverwaltung heraus.

Git-Backup (empfohlen, privat)

Behandeln Sie den Workspace als privaten Speicher. Legen Sie ihn in ein privates Git-Repo, damit er gesichert und wiederherstellbar ist.

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

  • Initialize the repo

    Wenn Git installiert ist, werden komplett neue Workspaces automatisch initialisiert. Wenn dieser Workspace 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"

  • Add a private remote

    GitHub web UI

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

    GitHub CLI (gh)

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

    GitLab web UI

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

  • Ongoing updates

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

    • Keine Secrets committen

    Vorgeschlagener .gitignore-Start:

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

    Workspace auf eine neue Maschine verschieben

  • Clone the repo

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

  • Update config

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

  • Seed missing files

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

  • Copy sessions (optional)

    Wenn Sie Sitzungen benötigen, kopieren Sie ~/.openclaw/agents/<agentId>/sessions/ separat von der alten Maschine.

    • Erweiterte Hinweise

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

    Verwandte Themen