OpenClaw Datenspeicherung: Pfade und Backup-Strategien

Kennst du das? Du setzt ein neues Tool auf und fragst dich nach fünf Minuten: Wo landen eigentlich meine Daten? Und was passiert mit meinen API-Keys, wenn ich das System verschiebe?

Es ist wichtig zu wissen, wo OpenClaw Informationen ablegt, damit du beim Backup oder einem Umzug die volle Kontrolle behältst und keine wichtigen Konfigurationen verlierst.

Speicherorte für Daten

Hier erfährst du, wo OpenClaw seine Daten speichert und wie du sie am besten sicherst.

Werden alle mit OpenClaw genutzten Daten lokal gespeichert?

Nein – der Status von OpenClaw ist lokal, aber externe Dienste sehen weiterhin, was du ihnen sendest.

• Standardmäßig lokal: Sessions, Memory-Dateien, Config und Workspace liegen auf dem Gateway-Host (~/.openclaw + dein Workspace-Verzeichnis).
• Systembedingt remote: Nachrichten, die du an Model-Provider (Anthropic/OpenAI/etc.) schickst, gehen an deren APIs.
• Plattform-Speicherung: Chat-Plattformen wie WhatsApp, Telegram oder Slack speichern Nachrichtendaten auf ihren eigenen Servern.
• Du kontrollierst den Fußabdruck: Die Nutzung lokaler Modelle behält Prompts auf deinem Rechner, aber der Channel-Traffic läuft weiterhin über die Server des jeweiligen Kanals.

Wo speichert OpenClaw seine Daten?

Alles befindet sich unter $OPENCLAW_STATE_DIR (Standard: ~/.openclaw):

Pfad	Zweck
$OPENCLAW_STATE_DIR/openclaw.json	Hauptkonfiguration (JSON5)
$OPENCLAW_STATE_DIR/credentials/oauth.json	Legacy OAuth-Import
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json	Auth-Profile (OAuth + API-Keys)
$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json	Runtime-Auth-Cache
$OPENCLAW_STATE_DIR/credentials/	Provider-Status (z. B. whatsapp/<accountId>/creds.json)
$OPENCLAW_STATE_DIR/agents/	Status pro Agent (agentDir + Sessions)
$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/	Konversationsverlauf & Status

Dein Workspace (AGENTS.md, Memory-Dateien, Skills etc.) ist davon getrennt und wird über agents.defaults.workspace konfiguriert (Standard: ~/.openclaw/workspace).

Wo sollten AGENTS.md / SOUL.md / USER.md / MEMORY.md liegen?

Diese Dateien gehören in den Agent-Workspace, nicht nach ~/.openclaw:

• Workspace (pro Agent): AGENTS.md, SOUL.md, IDENTITY.md, USER.md, MEMORY.md, memory/YYYY-MM-DD.md, optional HEARTBEAT.md
• State-Verzeichnis (~/.openclaw): Config, Credentials, Auth-Profile, Sessions, Logs

Der Standard-Workspace ist ~/.openclaw/workspace, konfigurierbar über:

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

Was ist die empfohlene Backup-Strategie?

Pack deinen Agent-Workspace in ein privates Git-Repo und sichere es an einem privaten Ort. Das erfasst das Memory sowie die AGENTS/SOUL/USER-Dateien.

Übermittle nichts unter ~/.openclaw (Credentials, Sessions, Token, Konfigurationsdateien) an Git. Falls du eine vollständige Wiederherstellung benötigst, sichere sowohl den Workspace als auch das State-Verzeichnis separat.

Wie deinstalliere ich OpenClaw vollständig?

Schau dir dazu die entsprechende Anleitung an: Uninstall

Können Agents außerhalb des Workspaces arbeiten?

Ja. Der Workspace ist das Standard-cwd und der Anker für das Memory, aber keine strikte Sandbox. Relative Pfade werden innerhalb des Workspaces aufgelöst. Absolute Pfade können jedoch auf andere Orte des Hosts zugreifen, sofern kein Sandboxing aktiviert ist.

Wenn ein Repo das Standard-Arbeitsverzeichnis sein soll, setze den workspace des Agents auf den Repo-Root:

{
  agents: {
    defaults: {
      workspace: "~/Projects/my-repo"
    }
  }
}

Ich bin im Remote-Modus – wo ist der Session-Speicher?

Der Session-Status gehört dem Gateway-Host. Wenn du im Remote-Modus arbeitest, liegt der relevante Session-Speicher auf dem entfernten Rechner, nicht auf deinem lokalen Laptop.

Nächste Schritte

• Installation Guide
• Configuration Overview

AI Setup Assistant