OpenClaw 在交互時(shí)給人的感覺(jué)是“無(wú)狀態(tài)的”。但實(shí)際上并非如此。它會(huì)保存配置、頻道登錄信息、會(huì)話記錄、內(nèi)存、技能以及許多在首次遷移到新服務(wù)器時(shí)至關(guān)重要的小文件。

本指南是我針對(duì) OpenClaw 編寫(xiě)的實(shí)用備份清單，而非理論講解，也不是“直接復(fù)制文件夾”之類(lèi)的簡(jiǎn)單建議。目標(biāo)很簡(jiǎn)單：即使你的 VPS 在凌晨 3 點(diǎn)宕機(jī)，你也能恢復(fù)備份，你的助手也能像什么都沒(méi)發(fā)生過(guò)一樣正常運(yùn)行。

在深入探討路徑之前，需要說(shuō)明一點(diǎn)：較舊的安裝版本可能仍然使用.clawdbot目錄，較舊的文檔和腳本可能仍然使用“Moltbot”。概念本身沒(méi)有改變，只是名稱不同而已。

你需要用 OpenClaw 備份哪些內(nèi)容

如果你只能記住這篇文章中的一件事，那就記?。篛penClaw 有兩個(gè)重要的根，以及一個(gè)可選的第三個(gè)根。

1）州目錄

狀態(tài)目錄存放著所有“底層架構(gòu)”：配置、密鑰、身份驗(yàn)證配置文件、會(huì)話和通道狀態(tài)。如果丟失了狀態(tài)目錄，就會(huì)丟失那些難以重建的內(nèi)容。

常見(jiàn)內(nèi)容包括：

• openclaw.json（主配置）
• 身份驗(yàn)證配置文件和提供商令牌（API 密鑰、OAuth 令牌）
• 每個(gè)代理的會(huì)話歷史記錄
• 通道狀態(tài)（例如 WhatsApp 登錄信息塊）
• 像這樣的配置備份.bak.*也包含機(jī)密信息。

~/.openclaw官方的 OpenClaw 遷移文檔建議在遷移過(guò)程中停止網(wǎng)關(guān)并進(jìn)行數(shù)據(jù)歸檔。您可以在OpenClaw 遷移文檔中找到相關(guān)信息。

2) 工作區(qū)目錄

你的工作區(qū)就像是“大腦文件”：記憶標(biāo)記、角色規(guī)則、本地技能、輔助腳本、筆記等等。如果丟失了這些文件，OpenClaw 仍然可以啟動(dòng)，但它會(huì)忘記自己的身份。

典型內(nèi)容包括：

• MEMORY.md和memory/文件
• SOUL.md，，，（如果你使用它們AGENTS.md）USER.mdTOOLS.md
• 工作技能<workspace>/skills/<skill>/SKILL.md
• 任何你保留的“代理上下文”信息，例如模板、清單、操作手冊(cè)等。

如果您想了解內(nèi)存的存儲(chǔ)方式以及為什么它只是 Markdown，那么這篇資料是一個(gè)很好的參考閱讀：OpenClaw 內(nèi)存詳解。

3）媒體和附件文件夾（可選，但通常值得）

如果你通過(guò)聊天渠道使用 OpenClaw，你可能會(huì)收到圖片、語(yǔ)音留言、PDF 和其他文件，這些文件你之后可能會(huì)用到。有些人不在乎，把收到的媒體文件當(dāng)作一次性用品。而有些人則非常依賴這些文件。

如果您確實(shí)依賴此功能，請(qǐng)備份存儲(chǔ)入站媒體的文件夾。某些設(shè)置使用專門(mén)的“媒體備份”功能，將文件放在類(lèi)似以下位置：

~/openclaw-media/<channel>/YYYY-MM-DD/...

那個(gè)文件夾里只有文件。像備份工具里的其他文件夾一樣處理它就行了。

Linux、macOS 和 Windows 上的關(guān)鍵默認(rèn)路徑

根據(jù)包裝和規(guī)格的不同，安裝路徑略有差異。不過(guò)，大多數(shù)安裝路徑都遵循相同的形狀。

Linux 和 macOS 默認(rèn)設(shè)置

• 狀態(tài)目錄：通常~/.openclaw/
• 工作區(qū)：通常情況下~/.openclaw/workspace，除非你更改了它

某些較舊的配置可能仍然包含~/.clawdbot自定義工作區(qū)。最穩(wěn)妥的方法是打開(kāi)狀態(tài)目錄并檢查代理工作區(qū)設(shè)置，~/clawd以確認(rèn)配置值。openclaw.json

Windows默認(rèn)設(shè)置

在 Windows 系統(tǒng)中，您通常會(huì)看到以下選項(xiàng)之一，具體取決于系統(tǒng)安裝的年代：

• C:\Users\<User>\.openclaw
• C:\Users\<User>\.clawdbot（較舊）

如果您不確定數(shù)據(jù)位置，OpenClaw 的常見(jiàn)問(wèn)題解答 (FAQ) 中有一個(gè)章節(jié)介紹了啟動(dòng)/停止和故障排除等基本操作。這通常是找到“此安裝使用哪個(gè)文件夾”答案的最簡(jiǎn)單方法。OpenClaw常見(jiàn)問(wèn)題解答。

最小備份與完整備份

這就是人們?nèi)菀追稿e(cuò)的地方。他們備份了“好”的部分（工作區(qū)），卻忘記了“壞”的部分（狀態(tài)目錄）。然后他們恢復(fù)數(shù)據(jù)，卻納悶為什么 WhatsApp 需要重新配對(duì)，會(huì)話也消失了。

最小備份范圍

如果接受重新驗(yàn)證，那么最小備份就可以了。

• openclaw.json
• 整個(gè)工作區(qū)目錄（內(nèi)存、角色文件、本地技能）

您將丟失會(huì)話歷史記錄，并且需要重新登錄頻道和進(jìn)行提供商身份驗(yàn)證。如果您在 WhatsApp 上運(yùn)行 OpenClaw 并且討厭配對(duì)流程，那么您將無(wú)法享受最小備份帶來(lái)的便利。

全面?zhèn)浞莘秶?/h3>

要想真正實(shí)現(xiàn)“恢復(fù)并繼續(xù)”的恢復(fù)，你需要的是完整備份。

• 整個(gè)狀態(tài)目錄（配置、密鑰、身份驗(yàn)證、會(huì)話、通道狀態(tài)）
• 整個(gè)工作區(qū)目錄或目錄
• 如果您要存儲(chǔ)收到的附件，請(qǐng)將其放入媒體文件夾。
• 如果您使用外部數(shù)據(jù)庫(kù)進(jìn)行儀表板或會(huì)話存儲(chǔ)，則需要生成數(shù)據(jù)庫(kù)轉(zhuǎn)儲(chǔ)文件。

完整備份可以在恢復(fù)后保持用戶個(gè)性、內(nèi)存、會(huì)話和頻道狀態(tài)的完整性。

備份文件包含機(jī)密信息，因此請(qǐng)像對(duì)待生產(chǎn)環(huán)境文件一樣對(duì)待它們。

狀態(tài)目錄以明文形式存儲(chǔ)著密鑰，包括 API 密鑰、OAuth 令牌和通道會(huì)話數(shù)據(jù)。因此，您的備份集本質(zhì)上就是您“王國(guó)密鑰”的副本。

我的基本規(guī)則：

• 對(duì)備份進(jìn)行加密。狀態(tài)目錄備份也不例外。
• 將密碼短語(yǔ)存儲(chǔ)在密碼管理器中。如果丟失，備份就徹底失效了。
• 不要通過(guò)電子郵件、Slack 或公共鏈接發(fā)送原始存檔。
• 如果懷疑備份數(shù)據(jù)泄露，請(qǐng)輪換令牌并重新配對(duì)通道。

如果您想了解 OpenClaw 的相關(guān)內(nèi)容（工具訪問(wèn)和哪些內(nèi)容屬于敏感信息），我們的部署強(qiáng)化指南將對(duì)您有所幫助：OpenClaw 安全最佳實(shí)踐。

快速導(dǎo)出內(nèi)存和人物文件

內(nèi)存文件本質(zhì)上就是 Markdown 格式，所以導(dǎo)出它就像復(fù)制文件夾一樣簡(jiǎn)單。如果你想要手動(dòng)“立即獲取”導(dǎo)出，以下是最簡(jiǎn)單的方法。

手動(dòng)導(dǎo)出（僅內(nèi)存導(dǎo)出）

# Adjust WORKSPACE if yours is different
WORKSPACE="$HOME/.openclaw/workspace"
mkdir -p "$HOME/Desktop/openclaw-memory-backup"
cp "$WORKSPACE/MEMORY.md" "$HOME/Desktop/openclaw-memory-backup/" 2>/dev/null || true
cp -r "$WORKSPACE/memory" "$HOME/Desktop/openclaw-memory-backup/" 2>/dev/null || true

手動(dòng)導(dǎo)出整個(gè)工作區(qū)

WORKSPACE="$HOME/.openclaw/workspace"
cp -r "$WORKSPACE" "$HOME/Desktop/openclaw-workspace-backup"

這并不能替代真正的備份。它只是“我即將編輯一堆角色規(guī)則，想要快速回滾”的一種操作。

在 Linux 和 macOS 上使用 tar 進(jìn)行一鍵備份

如果你想要最便捷的備份方式，并且可以接受先將本地存檔保存到本地，然后再同步到其他地方，那么 tar 就是一個(gè)不錯(cuò)的選擇。

創(chuàng)建具有時(shí)效性的加密檔案

單獨(dú)使用 tar 命令并不能加密。你可以將 tar 命令與其他加密方式（例如agetrap 或 tv gpg）結(jié)合使用，并將加密結(jié)果存儲(chǔ)在異地。

set -euo pipefail
BACKUP_DIR="$HOME/backups/openclaw"
DATE="$(date +%Y-%m-%d_%H-%M-%S)"
STATE_DIR="$HOME/.openclaw"
WORKSPACE_DIR="$HOME/.openclaw/workspace"
mkdir -p "$BACKUP_DIR"
tar -czf - -C "$STATE_DIR" . | age -p -o "$BACKUP_DIR/state-$DATE.tgz.age"
tar -czf - -C "$WORKSPACE_DIR" . | age -p -o "$BACKUP_DIR/workspace-$DATE.tgz.age"

缺點(diǎn)：除非使用密鑰文件，否則每次輸入密碼短語(yǔ)都會(huì)讓 cron 任務(wù)變得很煩人。優(yōu)點(diǎn)：極其簡(jiǎn)單且易于移植。

添加 cron 計(jì)劃任務(wù)

crontab -e
# Daily at 03:00
0 3 * * * /usr/local/bin/backup-openclaw.sh >/dev/null 2>&1

如果您已經(jīng)在使用 OpenClaw cron 進(jìn)行自動(dòng)化操作，那么仍然可以通過(guò) cron 或 systemd 定時(shí)器將備份作為“系統(tǒng)任務(wù)”來(lái)執(zhí)行。有關(guān) OpenClaw 內(nèi)部 cron 的基礎(chǔ)知識(shí)，請(qǐng)參閱：OpenClaw cron 調(diào)度器指南。

使用 Duplicati 備份 OpenClaw

Duplicati之所以受歡迎，是因?yàn)樗哂锌缙脚_(tái)性和易用性。它還支持客戶端加密。Duplicati的文檔涵蓋了卷的加密和解密以及相關(guān)工具。Duplicati加密工具。

關(guān)于 Duplicati 的另一個(gè)細(xì)節(jié)：Duplicati 社區(qū)文檔將 AES-256 加密描述為一項(xiàng)核心功能，并且數(shù)據(jù)在傳輸前會(huì)在本地進(jìn)行加密。Duplicati社區(qū)文檔簡(jiǎn)介。

第一步：選擇源文件夾

添加您的州目錄和工作區(qū)目錄。

• Linux/macOS：~/.openclaw以及您的工作區(qū)路徑
• Windows：C:\Users\<User>\.openclaw以及您的工作區(qū)路徑

如果你的工作區(qū)不在目錄內(nèi).openclaw，請(qǐng)顯式添加。很多人會(huì)將工作區(qū)放在單獨(dú)的磁盤(pán)上。

步驟二：設(shè)置加密并妥善保管密碼短語(yǔ)

在 Duplicati 中，您需要在作業(yè)向?qū)е羞x擇加密方式。請(qǐng)使用 AES-256 加密。選擇一個(gè)較長(zhǎng)的隨機(jī)密碼短語(yǔ)。將其保存在您不會(huì)丟失的地方。

步驟三：安排和保留

對(duì)于大多數(shù)個(gè)人用戶來(lái)說(shuō)，每天更新一次就足夠了。如果 OpenClaw “全天”運(yùn)行且你非常依賴它，那么每 6 小時(shí)更新一次也是合理的。

留存率因人而異。我喜歡簡(jiǎn)單的模式：

• 每天一次，持續(xù)7至14天
• 每周一次，持續(xù) 4 至 8 周
• 每月一次，持續(xù)幾個(gè)月

最重要的是，你可以恢復(fù)到上周的狀態(tài)。這就是“我搞砸了配置但沒(méi)立刻發(fā)現(xiàn)”的情況。

步驟 4：盡早進(jìn)行測(cè)試恢復(fù)

不要等到災(zāi)難發(fā)生那天才行動(dòng)。將文件還原到臨時(shí)文件夾，并確認(rèn)看到以下內(nèi)容：

• openclaw.json
• agents/和會(huì)話文件
• workspace/包含記憶和角色文件

服務(wù)器配置方面，可以使用 restic 或 Borg 進(jìn)行備份。

如果你在 VPS 或家庭實(shí)驗(yàn)室機(jī)器上運(yùn)行 OpenClaw，那么 restic 和 Borg 是常見(jiàn)的選擇，因?yàn)樗鼈兛删帉?xiě)腳本且可靠。

Restic 默認(rèn)使用加密，其文檔描述了如何使用 scrypt 從存儲(chǔ)庫(kù)密碼派生密鑰，然后使用 AES-256 進(jìn)行加密。restic參考資料。

如果你想深入了解密碼學(xué)，F(xiàn)ilippo Valsorda 寫(xiě)了一篇詳細(xì)的文章，分析了 restic 的文件加密格式和先加密后 MAC 的設(shè)計(jì)。restic密碼學(xué)筆記。

一個(gè)簡(jiǎn)單的 restic 示例

export RESTIC_REPOSITORY="s3:s3.amazonaws.com/your-bucket/openclaw"
export RESTIC_PASSWORD="use-a-real-passphrase-here"
restic backup "$HOME/.openclaw"
restic forget --keep-daily 14 --keep-weekly 8 --keep-monthly 6 --prune

如果在VPS上執(zhí)行此操作，請(qǐng)確保密碼不會(huì)保存在shell歷史記錄中。請(qǐng)使用權(quán)限嚴(yán)格的環(huán)境變量文件或密鑰管理器。

Docker 和卷備份

只要接受一個(gè)事實(shí)，Docker 設(shè)置就很簡(jiǎn)單：“重要文件夾”通常是卷。所以你需要備份卷。

您可能有：

• 一卷OPENCLAW_STATE_DIR
• 用于工作區(qū)目錄的卷
• 如果您運(yùn)行的是 Postgres 或 MySQL，則需要數(shù)據(jù)庫(kù)卷。

一致的快照

如果您需要一致的時(shí)間點(diǎn)備份，可以停止服務(wù)、創(chuàng)建快照，然后再重新啟動(dòng)服務(wù)。這樣做會(huì)造成停機(jī)時(shí)間，但可以避免出現(xiàn)奇怪的部分備份。

如果您使用的是 ZFS 或 LVM，還可以進(jìn)行文件系統(tǒng)快照。對(duì)于 24/7 全天候運(yùn)行的服務(wù)來(lái)說(shuō)，這通常是最佳方案，因?yàn)樗梢栽诓婚L(zhǎng)時(shí)間停機(jī)的情況下提供一致的視圖。

數(shù)據(jù)庫(kù)轉(zhuǎn)儲(chǔ)

如果您將會(huì)話或儀表板存儲(chǔ)在 Postgres 或 MySQL 中，也請(qǐng)備份數(shù)據(jù)庫(kù)。這通常意味著：

• pg_dump適用于Postgres
• mysqldump適用于 MySQL

像其他所有數(shù)據(jù)一樣，對(duì)數(shù)據(jù)庫(kù)轉(zhuǎn)儲(chǔ)文件進(jìn)行加密。

遷移到新機(jī)器

這是大多數(shù)人關(guān)心的場(chǎng)景：你買(mǎi)了一臺(tái)新的迷你電腦，或者你正在將 OpenClaw 從測(cè)試 VPS 遷移到生產(chǎn) VPS。

官方遷移文檔簡(jiǎn)明扼要，非常實(shí)用。文檔建議停止網(wǎng)關(guān)并歸檔.openclaw工作區(qū)。OpenClaw正在遷移。

在舊機(jī)器上

# Stop the gateway so files are not changing during copy
openclaw gateway stop
# Archive state dir
cd ~
tar -czf openclaw-state.tgz .openclaw
# Archive workspace (adjust if your workspace is elsewhere)
tar -czf openclaw-workspace.tgz .openclaw/workspace

在新機(jī)器上

請(qǐng)先安裝 OpenClaw，然后將歸檔文件恢復(fù)到正確位置。

cd ~
tar -xzf /path/to/openclaw-state.tgz
tar -xzf /path/to/openclaw-workspace.tgz

然后啟動(dòng)網(wǎng)關(guān)：

openclaw gateway start
openclaw status

核實(shí)：

• 通道已連接并正在回復(fù)
• 記憶回憶功能正常（問(wèn)它一些你知道自己記得的事情）。
• 你的技能已經(jīng)非常強(qiáng)大了。

如果您只恢復(fù)工作區(qū)而不恢復(fù)狀態(tài)目錄，則需要重新驗(yàn)證提供程序并重新配對(duì)通道。這并非“錯(cuò)誤”，但您應(yīng)該預(yù)料到這種情況。

會(huì)話和聊天記錄

會(huì)話記錄保存在狀態(tài)目錄下，每個(gè)代理都有各自的目錄。目前還沒(méi)有通用的“導(dǎo)出會(huì)話為 JSON 并導(dǎo)入”按鈕。因此，如果您重視會(huì)話數(shù)據(jù)，請(qǐng)務(wù)必備份狀態(tài)目錄。

一個(gè)實(shí)用技巧：如果您正在調(diào)試會(huì)話行為或想要確認(rèn)恢復(fù)后會(huì)話是否存在，從 CLI 列出會(huì)話通常是最快的健全性檢查。

一個(gè)不會(huì)泄露機(jī)密信息的 Git 備份方案

Git 非常適合存放個(gè)人資料文件和技能描述。但它不適合存放機(jī)密信息，也不適合快速增長(zhǎng)的內(nèi)存日志。

優(yōu)秀的 Git 候選人：

• SOUL.md，，，AGENTS.md?USER.md?TOOLS.md
• skills/文件夾
• 需要版本控制的模板和參考文件

不推薦的 Git 版本：

• openclaw.json如果它包含秘密
• 如果您在意代碼庫(kù)大小，則需要注意大型且頻繁更改的內(nèi)存文件。

我見(jiàn)過(guò)一種行之有效的模式：使用 Git 管理技能和角色文件，對(duì)狀態(tài)目錄和內(nèi)存進(jìn)行加密備份。這樣既能獲得清晰的“更改”差異，又能確保所有敏感數(shù)據(jù)都能真正恢復(fù)。

恢復(fù)運(yùn)行手冊(cè)，您可以將其復(fù)制到筆記中。

我喜歡簡(jiǎn)潔的流程手冊(cè)，可以放在一個(gè)屏幕上顯示。這是我的。

備份清單

• 狀態(tài)目錄已包含
• 包含工作區(qū)目錄
• 如果使用，則包含媒體文件夾
• 如果使用，則包含數(shù)據(jù)庫(kù)轉(zhuǎn)儲(chǔ)。
• 備份已加密
• 存在異地副本
• 配置保留策略

恢復(fù)序列

• 停止 OpenClaw 網(wǎng)關(guān)
• 恢復(fù)狀態(tài)目錄
• 恢復(fù)工作區(qū)目錄
• 如果使用數(shù)據(jù)庫(kù)，請(qǐng)恢復(fù)數(shù)據(jù)庫(kù)。
• 啟動(dòng) OpenClaw 網(wǎng)關(guān)
• 驗(yàn)證通道、會(huì)話、內(nèi)存、技能

一些實(shí)用的小建議，日后能幫到你。

不要將唯一的備份保存在同一塊磁盤(pán)上。

這聽(tīng)起來(lái)顯而易見(jiàn)，但人們?nèi)匀贿@樣做。如果硬盤(pán)損壞，你的備份也會(huì)丟失。

明確指定工作區(qū)路徑

如果您運(yùn)行多個(gè)代理，請(qǐng)清晰命名工作區(qū)并保持其穩(wěn)定。以后移動(dòng)工作區(qū)是可以的，但您最終會(huì)修改配置、腳本和一些假設(shè)。

大型配置修改后請(qǐng)備份

OpenClaw 配置文件會(huì)隨著時(shí)間推移而不斷增大。添加頻道、技能或代理后，請(qǐng)手動(dòng)觸發(fā)備份。雖然有點(diǎn)麻煩，但確實(shí)有效。

到此這篇關(guān)于OpenClaw 數(shù)據(jù)、設(shè)置和內(nèi)存?zhèn)浞葜改系奈恼戮徒榻B到這了,更多相關(guān)OpenClaw 內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論