ls /workspace/projects/workspace/skills/

claw-migrate - OpenClaw 备份与恢复指南

简单安全：无需代码，无需自动化，只需清晰的指引

---

🎯 这是什么？

claw-migrate 是一个纯指导型技能——无需安装，无需运行代码。

只需按照以下指引备份和恢复你的 OpenClaw 工作区。

---

📁 路径一：备份

快速备份（推荐）

bash

仅备份核心文件（快速）

tar -czf openclaw-backup-$(date +%Y%m%d_%H%M%S).tar.gz \
-C /workspace/projects/workspace \
AGENTS.md SOUL.md IDENTITY.md USER.md TOOLS.md HEARTBEAT.md \
memory/ .learnings/ docs/ scripts/ templates/

完整备份（包含技能）

bash

备份所有内容，包括技能

tar -czf openclaw-full-backup-$(date +%Y%m%d_%H%M%S).tar.gz \
-C /workspace/projects/workspace \
AGENTS.md SOUL.md IDENTITY.md USER.md TOOLS.md HEARTBEAT.md \
memory/ .learnings/ docs/ scripts/ templates/ skills/ agents/

需要备份的内容 ✅

类别	文件	是否备份？
核心配置	AGENTS.md, SOUL.md, IDENTITY.md, USER.md	✅ 是
工具

TOOLS.md, HEARTBEAT.md | ✅ 是 | | 记忆 | memory/*.md | ✅ 是 | | 学习记录 | .learnings/*.md | ✅ 是 | | 文档 | docs/ | ✅ 是 | | 脚本 | scripts/ | ✅ 是 | | 模板 | templates/ | ✅ 是 | | 技能 | skills/ | ⚠️ 可选（体积大） | | 代理 | agents/ | ⚠️ 可选 |

不需要备份的内容 ❌

文件	原因
.env	包含 API 密钥
openclaw.json

包含机密信息 | | credentials/ | 配对令牌 | | identity/ | 设备认证 | | devices/ | 已配对设备 | | feishu/ | 频道配置 | | browser/ | 浏览器数据（体积大） |

---

🔄 路径二：恢复

从备份恢复

bash

将备份解压到工作区

tar -xzf openclaw-backup-YYYYMMDD_HHMMSS.tar.gz \
-C /workspace/projects/workspace/

恢复步骤

1. 1. 停止 OpenClaw（如果正在运行）

bash openclaw gateway stop

1. 2. 解压备份

bash tar -xzf your-backup.tar.gz -C /workspace/projects/workspace/

1. 3. 验证文件

bash ls -la /workspace/projects/workspace/

1. 4. 重新配对频道（必需）

bash openclaw pairing

1. 5. 重启 OpenClaw

bash openclaw gateway restart

恢复注意事项 ⚠️

项目	操作
API 密钥	重新添加到 .env
频道配对

重新配对所有频道 | | 设备认证 | 重新认证设备 | | 记忆文件 | 自动合并 | | 技能 | 保留（无需重新安装） |

---

📤 路径三：分享到 ClawTalent

准备分享

1. 1. 清理敏感信息

bash # 删除 .env、credentials 等 rm -rf .env credentials/ identity/ devices/

1. 2. 创建清单文件

json { name: my-openclaw-config, version: 1.0.0, description: 我的 OpenClaw 工作区配置, openclaw_version: 2026.3.13, skills: [coze-web-search, agent-browser], agents: [main, life, work] }

1. 3. 上传到 GitHub

bash git add . git commit -m 分享 OpenClaw 配置 git push origin main

通过 ClawTalent 平台分享

访问：https://clawtalent.shop

1. 1. 创建账户
2. 上传清理后的配置
3. 获取 CT-XXXX ID
4. 与他人分享 ID

---

🔍 路径四：发现配置

浏览 ClawTalent

访问：https://clawtalent.shop

搜索：

• - 多代理设置
• 特定技能
• 行业模板

从 ClawTalent 部署

bash

从 CT-XXXX ID 获取配置

git clone https://github.com/hanxueyuan/clawtalent-CT-XXXX.git
cd clawtalent-CT-XXXX
tar -xzf config.tar.gz -C /workspace/projects/workspace/

部署前验证

1. 1. 检查 OpenClaw 版本兼容性
2. 查看技能列表
3. 检查代理配置
4. 确认不包含敏感数据

---

🔐 安全最佳实践

始终 ✅

• - 将备份存储在私有 GitHub 仓库中
• 使用环境变量存储 API 密钥
• 恢复后重新配对频道
• 分享前清理敏感信息

切勿 ❌

• - 分享 .env 文件
• 将 API 密钥提交到 Git
• 分享配对令牌
• 备份浏览器数据（隐私问题）

---

📋 快速参考

备份命令

bash

快速备份（仅核心文件）

tar -czf backup.tar.gz -C /workspace/projects/workspace \
AGENTS.md SOUL.md memory/ .learnings/

完整备份（包含技能）

tar -czf full-backup.tar.gz -C /workspace/projects/workspace \ AGENTS.md SOUL.md memory/ .learnings/ skills/ agents/

恢复命令

bash

解压备份

tar -xzf backup.tar.gz -C /workspace/projects/workspace/

验证

ls -la /workspace/projects/workspace/

存储选项

选项	命令
本地	cp backup.tar.gz ~/backups/
GitHub

git push origin main | | 云端 | 上传到 Google Drive / Dropbox |

---

🆘 故障排除

权限被拒绝

bash

修复权限

chmod -R 755 /workspace/projects/workspace/
chmod 600 /workspace/projects/workspace/.env

恢复后文件缺失

检查 .gitignore——某些文件默认被排除在备份之外。

恢复后频道无法使用

重新配对频道：
bash
openclaw pairing

找不到技能

技能位于 skills/ 目录中。验证：
bash
ls /workspace/projects/workspace/skills/

---

📚 资源

• - GitHub：https://github.com/hanxueyuan/claw-migrate
• ClawTalent：https://clawtalent.shop
• OpenClaw 文档：https://docs.openclaw.ai

---

📄 许可证

MIT 许可证——可自由使用和分享（但请先清理敏感信息！）