OpenClaw 資料儲存位置與備份指南：保護您的 Agent 數據

身為開發者，最頭痛的事情之一就是玩新工具時，搞不清楚設定檔和資料到底噴到哪去了。是存在自己電腦的某個角落，還是偷偷傳到了雲端？搞清楚資料流向，不僅是為了隱私，更是為了在換電腦或需要備份時，不會漏掉關鍵的 memory 或 session。

這篇文章會幫你理清 OpenClaw 的資料存放邏輯，讓你完全掌控自己的 AI 資料。

Data Storage Locations

了解 OpenClaw 將資料儲存在哪裡，以及如何進行備份。

不完全是 —— OpenClaw 的狀態（state）是本地的，但外部服務仍然會看到你傳送給它們的內容。

預設本地儲存： sessions、memory 檔案、config 和 workspace 都存放在 Gateway 主機上（~/.openclaw + 你的 workspace 目錄）
必要的遠端傳輸： 你傳送給模型供應商（Anthropic/OpenAI 等）的訊息會進入它們的 API；而通訊平台（WhatsApp/Telegram/Slack 等）則會將訊息資料儲存在它們的伺服器上
掌控權在你： 使用本地模型可以讓 prompt 留在你的機器上，但 channel 的流量仍然會經過該平台的伺服器

所有內容都存放在 $OPENCLAW_STATE_DIR 底下（預設路徑為：~/.openclaw）：

路徑	用途
`$OPENCLAW_STATE_DIR/openclaw.json`	主要設定檔 (JSON5)
`$OPENCLAW_STATE_DIR/credentials/oauth.json`	舊版 OAuth 匯入
`$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth-profiles.json`	認證設定檔 (OAuth + API keys)
`$OPENCLAW_STATE_DIR/agents/<agentId>/agent/auth.json`	Runtime 認證快取
`$OPENCLAW_STATE_DIR/credentials/`	供應商狀態 (例如 `whatsapp/<accountId>/creds.json`)
`$OPENCLAW_STATE_DIR/agents/`	每個 agent 的狀態 (agentDir + sessions)
`$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/`	對話紀錄與狀態

你的 workspace（包含 AGENTS.md、memory 檔案、skills 等）是分開存放的，透過 agents.defaults.workspace 設定（預設為：~/.openclaw/workspace）。

這些檔案應該放在 agent workspace 中，而不是 ~/.openclaw：

Workspace (每個 agent 獨立)：AGENTS.md、SOUL.md、IDENTITY.md、USER.md、MEMORY.md、memory/YYYY-MM-DD.md，以及選配的 HEARTBEAT.md
State 目錄 (~/.openclaw)：設定檔、credentials、auth profiles、sessions、logs

預設的 workspace 是 ~/.openclaw/workspace，你可以透過以下方式修改：

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

建議將你的 agent workspace 放在一個 private git repo 中，並備份到私有的遠端倉庫。這樣可以完整捕捉 memory 以及 AGENTS/SOUL/USER 等檔案。

不要 commit 任何在 ~/.openclaw 底下的內容（包含 credentials、sessions、tokens）。如果你需要完整還原，請分別備份 workspace 和 state 目錄。

請參考專門的指南：Uninstall

可以。workspace 是預設的 cwd（目前工作目錄）和 memory 錨點，並非強制性的沙盒。相對路徑會在 workspace 內解析，但除非啟用了沙盒模式，否則絕對路徑可以存取主機上的其他位置。

如果你希望某個 repo 成為預設的工作目錄，請將該 agent 的 workspace 指向該 repo 的根目錄：

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

Session 狀態是由 Gateway 主機 擁有的。如果你處於 remote mode，你該留意的 session 儲存位置是在遠端機器上，而不是你的本地筆電。

如果你在設定過程中遇到任何問題，可以詢問我們的 AI Setup Assistant。

OpenClaw Expert

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。