claw2tencentcloud
# OpenClaw 数据迁移助手
帮助用户将 OpenClaw 数据迁移到腾讯云实例，支持单实例迁移、批量迁移和自定义迁移方案。
## 技能概览
本技能包含三种能力：
1. **技能 1 — 单实例迁移**：将单个 OpenClaw 数据迁移到当前机器
2. **技能 2 — 批量迁移**：批量迁移多个 OpenClaw 数据到腾讯云 Lighthouse 或 CVM 实例
3. **技能 3 — 自定义方案**：对于不满足技能 1 和技能 2 的场景，给出相应的迁移方案
## 技能 1：迁移单个 OpenClaw 数据到当前机器
### 迁移风险告知
在开始迁移前**必须**告知用户以下风险：
- 开始迁移时源端 OpenClaw 实例会被停止
- 迁移后当前 OpenClaw 实例的数据会被源端 OpenClaw 实例的数据覆盖
### 输入参数
| 参数 | 说明 | 必填 |
|------|------|------|
| `src_ip` | 源端 OpenClaw 实例的公网 IP 地址 | ✓ |
| `username` | 源端 OpenClaw 实例的登录用户名 | ✓ |
| `password` | 源端 OpenClaw 实例的登录密码 | ✓ |
### 迁移步骤
提示用户输入上述 3 个参数，然后将 `src_ip`、`username`、`password` 替换到以下命令中逐步执行：
```bash
# 1. 安装 sshpass
apt install -y sshpass;
# 2. 停止源端 OpenClaw 服务
sshpass -p '{password}' ssh -o StrictHostKeyChecking=no {username}@{src_ip} "openclaw gateway stop";
# 3. 打包源端数据（/root/.openclaw 目录可能数据量较大，也可能不存在）
sshpass -p '{password}' ssh -o StrictHostKeyChecking=no {username}@{src_ip} "tar -czf /home/openclaw-state.tgz -C /root .openclaw";
# 4. 从源端拷贝数据到当前实例（耗时可能较久，提示用户耐心等待；失败可重试）
sshpass -p '{password}' scp -o StrictHostKeyChecking=no {username}@{src_ip}:/home/openclaw-state.tgz /home;
# 5. 备份当前 OpenClaw 实例数据（如源端数据不兼容可用此备份恢复）
cp -r /root/.openclaw /home/openclaw-backup
# 6. 覆盖当前 OpenClaw 实例数据
tar -xvzf /home/openclaw-state.tgz -C /root;
# 7. 修复配置文件路径（源端与当前版本可能不一致）
sed -i 's|/app/extensions/|/root/.openclaw/extensions/|g' /root/.openclaw/openclaw.json
# 8. 修复权限并重启
chmod 0600 /root/.openclaw/openclaw.json;
openclaw gateway restart;
```
### 常见问题
1. 用户源端实例未允许 SSH 访问
2. 用户源端实例 OpenClaw 数据不在 `/root` 目录下
3. 迁移期间源端 OpenClaw 数据被修改
4. 源端 OpenClaw 版本与当前版本不一致，配置文件不兼容
## 技能 2：批量迁移多个 OpenClaw 数据到腾讯云实例
### 迁移风险告知
在开始迁移前**必须**告知用户以下风险：
- 开始迁移时源端 OpenClaw 实例会被停止
- 迁移后目标 OpenClaw 实例的数据会被源端 OpenClaw 实例的数据覆盖
### 输入参数
| 参数 | 说明 | 必填 |
|------|------|------|
| 源端云平台的云 API 访问密钥 | SecretId + SecretKey | ✓ |
| 腾讯云目标账号的云 API 访问密钥 | SecretId + SecretKey | ✓ |
| 待迁移的 OpenClaw 实例列表 | 见下方格式 | ✓ |
| 源端云平台名称 | 如腾讯云、阿里云等 | 选填 |
| 源端实例所在地域 | 如 ap-guangzhou | 选填 |
| 目标实例所在地域 | 如 ap-guangzhou | 选填 |
**实例列表格式**（每行一组，空格分隔）：
```
<源端实例ID> <源端登录账号> <源端登录密码> <目标端实例ID>
```
示例：
```
lhins-abc12345 ubuntu MyP@ssw0rd ins-xyz67890 # 腾讯云LH -> 腾讯云CVM
```
### 输出
结合脚本执行结果的文件，汇总迁移的汇总结果。
### 迁移步骤
1. 提示用户输入上述参数
2. 下载批量迁移脚本：`https://go2tencentcloud-1251783334.cos.ap-guangzhou.myqcloud.com/others/claw2tencentcloud.py`
3. 读取脚本的说明，按照说明填充脚本中的需要参数
4. 执行脚本。脚本会自动迁移多个 OpenClaw 实例到腾讯云实例，并结合脚本生成的结果文件生成迁移结果。因数据量大、机器带宽小等因素，脚本执行可能耗时较久，提示用户耐心等待
详细的迁移命令参考见 `references/migration_commands.md`。
### 常见问题
1. 用户源端实例未允许 SSH 访问
2. 用户源端实例 OpenClaw 数据不在 `/root` 目录下
3. 迁移期间源端 OpenClaw 数据被修改
4. 源端 OpenClaw 版本与当前版本不一致，配置文件不兼容
5. 云 API 密钥缺少权限，腾讯云需要以下权限：
- CVM 可读写权限：`QcloudCVMFullAccess`
- Lighthouse 可读写权限：`QcloudLighthouseFullAccess`
- TAT（腾讯自动化助手）可读写权限：`QcloudTATFullAccess`
## 技能 3：自定义迁移方案
当技能 1 和技能 2 无法满足用户场景时，需要收集以下信息后给出迁移方案：
- 源端 OpenClaw 实例的部署情况
- 网络环境
- 目的实例类型等信息
根据上述信息提供可执行的迁移方案。
标签
skill
ai
