OpenClaw云端遷移至本地的部署指南
我要評論適用場景：OpenClaw 最初部署在云端（VPS/服務器），調(diào)教完成后遷移到本地機器（Mac/Linux/Windows）繼續(xù)使用。
本文檔涵蓋：完整數(shù)據(jù)遷移、選擇性遷移、部分遷移方案、以及遷移后的驗證步驟。
1. 前置準備
1.1 確認 OpenClaw 版本
在云端服務器執(zhí)行：
openclaw --version openclaw status
記錄輸出的版本號、Gateway 地址、已安裝的插件和技能列表。
1.2 檢查數(shù)據(jù)量
du -sh ~/.openclaw/ # 總大小 du -sh ~/.openclaw/workspace/ # workspace 大小 du -sh ~/.openclaw/skills/ # 技能大小 du -sh ~/.openclaw/logs/ # 日志大?。膳懦?
我本地的數(shù)據(jù)總量約 877MB，其中 workspace + skills 是核心，logs 可排除。
1.3 本地安裝 OpenClaw
在本地機器上安裝與云端相同（或更新）版本：
# Linux / macOS (npm) npm install -g openclaw # 驗證版本一致 openclaw --version
2. 完整遷移（推薦）
2.1 云端 — 停止網(wǎng)關并打包
停止網(wǎng)關可以防止遷移過程中數(shù)據(jù)被寫入，保證數(shù)據(jù)一致性。
# 登錄云端服務器 # 1. 停止 OpenClaw 網(wǎng)關 openclaw gateway stop # 2. 確認進程已停止 openclaw status | grep Gateway # 預期輸出：Gateway ... stopped 或類似 # 3. 排除不必要的目錄（減小體積） # 日志文件體積大但遷移價值低，可以先清空或排除 rm -rf ~/.openclaw/logs/*.log # 可選：清理舊日志 # 4. 打包整個目錄 tar -czvf openclaw-full-backup.tar.gz \ --exclude='.DS_Store' \ --exclude='node_modules' \ --exclude='.git' \ ~/.openclaw/ # 5. 查看打包結果 ls -lh openclaw-full-backup.tar.gz
2.2 傳輸備份文件到本地
選擇以下任意一種方式：
方式 A：SCP（推薦）
# 在本地機器執(zhí)行 scp your-user@your-cloud-server:/path/to/openclaw-full-backup.tar.gz ~/ # 如果使用了 SSH 密鑰 scp -i ~/.ssh/your-key.pem your-user@your-cloud-server:/path/to/openclaw-full-backup.tar.gz ~/
方式 B：Rsync（適合大文件、斷點續(xù)傳）
rsync -avP -e ssh your-user@your-cloud-server:/path/to/openclaw-full-backup.tar.gz ~/
方式 C：云對象存儲
上傳到 OSS/S3/GCS，本地下載（適合網(wǎng)絡不穩(wěn)定的情況）。
2.3 本地 — 解壓恢復
# 1. 解壓到臨時目錄（先不覆蓋，防止意外） mkdir -p ~/openclaw-restore tar -xzvf openclaw-full-backup.tar.gz -C ~/openclaw-restore/ # 2. 查看解壓結果 ls ~/openclaw-restore/ # 3. 備份本地已有的 openclaw 目錄（如果有） mv ~/.openclaw ~/.openclaw.local.bak 2>/dev/null # 4. 移動恢復 mv ~/openclaw-restore/.openclaw ~/ # 5. 驗證目錄結構 ls -la ~/.openclaw/
2.4 修復路徑問題
# 運行診斷工具，自動修復路徑不一致問題 openclaw doctor # 根據(jù)提示修復任何路徑或權限問題
2.5 啟動網(wǎng)關
openclaw gateway start
3. 選擇性遷移
如果你不需要完整遷移（比如只想要記憶和配置），可以只打包部分目錄。
3.1 打包時選擇性包含
tar -czvf openclaw-selective.tar.gz \ ~/.openclaw/openclaw.json \ ~/.openclaw/identity/ \ ~/.openclaw/agents/ \ ~/.openclaw/workspace/ \ ~/.openclaw/cron/ \ ~/.openclaw/memory/ \ ~/.openclaw/skills/ \ ~/.openclaw/devices/
3.2 選擇性遷移清單
| 目錄/文件 | 遷移價值 | 說明 |
|---|---|---|
openclaw.json | ??? 必須 | 核心配置文件 |
identity/ | ??? 必須 | 身份和認證信息 |
agents/ | ??? 必須 | Agent 狀態(tài)和會話 |
workspace/ | ??? 必須 | 你的工作區(qū)（含 MEMORY.md、SOUL.md 等） |
cron/ | ??? 推薦 | 定時任務配置 |
memory/ | ??? 推薦 | 記憶文件 |
skills/ | ?? 推薦 | 自定義技能（ClawHub 上的可重新安裝） |
devices/ | ? 一般 | 設備配對信息（本地設備可能不同） |
extensions/ | ? 視情況 | 第三方擴展 |
logs/ | ? 不需要 | 日志文件，無需遷移 |
4. 部分遷移（輕量方案）
適用于只想遷移核心記憶和配置，不遷移會話歷史的情況。
4.1 只遷移工作區(qū)和記憶
# 在云端打包 tar -czvf openclaw-minimal.tar.gz \ ~/.openclaw/openclaw.json \ ~/.openclaw/identity/ \ ~/.openclaw/workspace/ \ ~/.openclaw/memory/ # 傳輸后本地解壓恢復 tar -xzvf openclaw-minimal.tar.gz -C ~/ # 重新安裝 skills clawhub sync # 重啟網(wǎng)關 openclaw gateway restart
4.2 技能重建
如果選擇不遷移 skills/ 目錄，本地可以用以下方式重建：
# 查看云端裝了哪些技能（備份前記錄） ls ~/.openclaw/skills/ # 在本地重新安裝（需要先查云端裝的 skill IDs 或 names） clawhub install <skill-name> # 或者在 workspace/skills/ 目錄手動恢復
5. 云端善后
遷移完成后，建議在云端執(zhí)行以下操作：
5.1 停止云端網(wǎng)關（防止混淆）
# 在云端服務器執(zhí)行 openclaw gateway stop
5.2 考慮刪除或保留備份
# 確認本地遷移成功后再刪除云端數(shù)據(jù)（謹慎?。? # rm -rf ~/.openclaw/ # rm openclaw-full-backup.tar.gz
5.3 如果要徹底釋放云端資源
這是不可逆操作，請確保本地遷移完全成功后再執(zhí)行。
# 停止并卸載 OpenClaw openclaw gateway stop npm uninstall -g openclaw # 刪除所有數(shù)據(jù)（不可恢復！） rm -rf ~/.openclaw/ # 釋放服務器（如果是按量付費的實例可以關機/刪除）
6. 遷移后驗證
6.1 基本驗證
# 1. 確認版本 openclaw --version # 2. 檢查網(wǎng)關狀態(tài) openclaw status # 3. 檢查工作區(qū)文件完整性 ls ~/.openclaw/workspace/ cat ~/.openclaw/workspace/MEMORY.md | head -20 # 4. 檢查記憶文件 ls ~/.openclaw/memory/ # 5. 檢查定時任務 openclaw cron list
6.2 功能驗證
- 對話功能：發(fā)送一條消息，確認 AI 能正常回復
- 記憶檢索：問一個之前保存在 MEMORY.md 中的問題
- 定時任務：檢查 cron 任務是否正常
- 頻道連接：Telegram/WhatsApp/QQ 等頻道是否正常連接
- 技能：檢查自定義技能是否正常工作
6.3 完整性檢查清單
? OpenClaw 版本一致 ? 網(wǎng)關正常啟動 ? 工作區(qū)文件完整（MEMORY.md、SOUL.md 等） ? 記憶文件恢復 ? 定時任務配置保留 ? 頻道（Telegram/WhatsApp/QQ）登錄狀態(tài)保留 ? 自定義技能可用 ? AI 能正常對話 ? API 密鑰和認證信息正確
7. 常見問題
Q1：遷移后 openclaw doctor 報路徑錯誤？
A：正?，F(xiàn)象。舊路徑是云端的絕對路徑（如 /root/.openclaw/），本地路徑是 /Users/yourname/.openclaw/。openclaw doctor 會自動修復配置文件中的路徑，無需手動修改。
Q2：Telegram/WhatsApp 登錄態(tài)丟失？
A：認證 token 保存在 identity/ 目錄，完整遷移時不會丟失。如果使用部分遷移方案，確保包含 identity/ 目錄。
如果確實丟失，需要重新在本地設備進行 OAuth 授權。
Q3：API 密鑰需要重新配置嗎？
A：如果完整遷移，openclaw.json 中的 API Key 會一起遷移過來，無需重新配置。如果只遷移了工作區(qū)，需要在本地 openclaw.json 或環(huán)境變量中重新配置。
Q4：遷移后模型不工作？
A：檢查 openclaw.json 中的模型配置是否正確。如果是云端專用的 API 地址（如內(nèi)網(wǎng)地址），本地無法訪問，需要更改為公網(wǎng)可用的端點。
Q5：技能（Skills）需要重新安裝嗎？
A：不一定。如果完整遷移，skills/ 目錄會一起過來，本地可以直接使用。如果選擇了輕量方案，從 ClawHub 安裝的公共技能可以重新通過 clawhub sync 拉回，自定義技能需要手動恢復。
Q6：云端和本地可以同時運行嗎？
A：可以，但不推薦，因為會共享同一份數(shù)據(jù)目錄（如果用同一個 state dir），會導致狀態(tài)混亂。如果確實需要雙端運行，可以使用不同的 --profile 參數(shù)指定不同的配置目錄。
Q7：數(shù)據(jù)量太大，傳輸慢怎么辦？
A：
- 排除
logs/目錄（節(jié)省大量空間） - 優(yōu)先傳輸
openclaw.json+workspace/+memory/，這三個最重要 - 使用壓縮率更高的
xz格式：tar -cJvf backup.tar.xz ~/.openclaw/ - 使用 Rsync 的
--compress選項減少傳輸量
Q8：遷移后發(fā)現(xiàn)缺少文件怎么辦？
A：
- 檢查打包時是否用了
--exclude排除了某些文件 - 確認云端原始目錄是否包含這些文件
- 如果備份文件還在，可以重新解壓提取丟失的文件
- 養(yǎng)成習慣：重要操作前先
du -sh ~/.openclaw/記錄大小，遷移后對比
附錄：快速命令速查
# === 云端操作 === # 停止網(wǎng)關 openclaw gateway stop # 查看數(shù)據(jù)大小 du -sh ~/.openclaw/
以上就是OpenClaw云端遷移至本地的部署指南的詳細內(nèi)容，更多關于OpenClaw云端遷移至本地部署的資料請關注腳本之家其它相關文章！
相關文章
OpenClaw 搜索服務遷移教程之如何從 Brave 到 Tavily
這篇文章給大家介紹OpenClaw 搜索服務遷移教程之如何從 Brave 到 Tavily，本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友參考下吧2026-03-19
文章瀏覽閱讀412次，點贊9次，收藏8次。OpenClaw 的運行環(huán)境由全局核心配置模型定義插件/技能生態(tài)用戶工作空間和環(huán)境變量認證五部分組成。遷移的本質(zhì)是將這五部分核心文件2026-03-07
