869 字
4 分鐘
OpenClaw 身份資料備份與遷移
最近 OpenClaw 經歷了頻繁的更新與專案改名（從 ClawdBot 到 OpenClaw），相信不少先行者跟我一樣，都遇過不小心更新失敗，或是因為環境衝突而不得不刪除重裝的狀況。
每一次被迫執行 uninstall 或按下 rm -rf 時都讓人心跳加速——我的 Agent 還會記得我嗎？那些我們共同累積的對話與默契會不會就此消失？
為了避免在這些折騰中遺失珍貴的記憶與設定，這篇文章整理了 OpenClaw 的關鍵檔案結構，以及我目前使用的備份與還原流程。確保無論重裝多少次，你的 AI 夥伴都能無縫回歸。
1. 核心檔案結構解析
OpenClaw 的資料主要分為三個邏輯層級：核心定義 (Identity)、記憶庫 (Memory) 與 系統設定 (Configuration)。
核心人格 (Core Identity)
這些檔案定義了 Agent 的基本設定、價值觀與行為準則。
| 檔案名稱 | 用途描述 |
|---|---|
SOUL.md | 人格核心：定義 Agent 的性格、語氣、核心價值觀與行為限制。 |
IDENTITY.md | 身份元資料：包含 Agent 的名稱、版本號與基本屬性設定。 |
USER.md | 使用者畫像：記錄了 Agent 對您的認知、偏好設定以及互動模式。 |
記憶庫 (Memory Bank)
這是 Agent 隨時間積累的長期記憶與短期上下文。
| 檔案名稱 / 目錄 | 用途描述 |
|---|---|
MEMORY.md | 長期記憶：儲存經過提煉的重要事件、決策與長期知識庫。 |
memory/*.md | 每日日誌：位於 memory/ 資料夾下，按日期歸檔的對話摘要與情境記錄。 |
sessions/ | 會話存檔：完整的對話原始資料（Raw Data），用於除錯或回溯完整上下文。 |
系統設定 (System Configuration)
定義 Agent 如何與外部世界連接。
| 檔案名稱 | 用途描述 |
|---|---|
openclaw.json | 全域設定：包含 Gateway 設定、API Keys（如未加密）、模型別名與插件設定。 |
2. 推薦備份清單
建議定期備份以下路徑的檔案。假設您的 OpenClaw 工作區位於預設的 ~/openclaw/：
- 核心設定檔：
~/openclaw/*.md(包含SOUL.md,MEMORY.md等) - 記憶資料夾：
~/openclaw/memory/ - 全域設定：
~/.openclaw/openclaw.json(注意：此檔案通常位於使用者根目錄的隱藏資料夾中)
自動化提示： 您可以建立一個簡單的 shell script 來自動打包這些檔案：
Terminal window
3. 遷移與還原流程
當您需要在新環境（如新的 MacBook 或 Docker 容器）中恢復 Agent 時，請遵循以下步驟：
步驟 1：環境初始化
首先，確保新環境已安裝 OpenClaw 核心框架與必要的 Runtime。
# 範例：安裝 OpenClaw CLInpm install -g @openclaw/cliopenclaw init步驟 2：設定還原
將備份的 openclaw.json 放置於使用者的設定目錄：
mkdir -p ~/.openclawcp /path/to/backup/openclaw.json ~/.openclaw/步驟 3：資料注入
將核心人格與記憶檔案複製到新的工作區目錄：
cp /path/to/backup/*.md ~/openclaw/cp -r /path/to/backup/memory ~/openclaw/步驟 4：重啟服務
完成檔案復原後，重啟 Gateway 以重新載入索引：
openclaw gateway restart當系統重啟完成後，您的 Agent 將會繼承所有的過往記憶與性格特質，無縫延續之前的互動體驗。
總結
- 核心原則：定期備份
SOUL.md與MEMORY.md是最最低限度的要求。 - 測試環境：OpenClaw 2026.2.2-3, macOS 26.3 Beta (25D5112c), 2026-02-05
- 自動化：建議將備份流程納入 cron job 或類似的排程任務。
參考來源：
OpenClaw 身份資料備份與遷移
https://laplusda.com/posts/openclaw-identity-backup-guide/ 這篇文章有幫助嗎？
回報錯字、失效連結，或告訴我你想看的延伸主題。