从 LightClaw 迁移到 Octop

在 LightClaw 导出备份，再在 Octop 页面上传并恢复——模型、通道、工作区、环境变量与定时任务可一键迁入。

把现有 LightClaw 配置迁到 Octop，不必手搓模型、通道、工作区文件或定时任务。LightClaw 会打出一份 Octop 兼容的 .tar.gz，你在 Octop 页面上传并恢复即可。

迁移前请先把 LightClaw 与 Octop 都升级到最新版本。旧版本可能打出或拒绝不兼容的归档。

​

开始之前

1. 在 LightClaw 打开高级设置 → 更新，如有新版本请先升级。
2. 在 Octop 打开管理 → 应用设置 → 应用更新，如有新版本请先升级。
3. 尽量选维护窗口操作：恢复会覆盖当前 Octop 的数据库与本地专家工作区。
4. 恢复成功后建议停掉 LightClaw（或关闭其通道），避免同一 IM 机器人被两边同时回复。

​

会迁什么

包含	不包含
已启用的模型 Provider（含 API Key）	历史消息（底层对话架构不同，暂不支持）
已启用通道配置（含密钥）	—
环境变量（含 AI 搜索 KEY）	—
Workspace 文件（SOUL.md、MEMORY.md、skills/ 等）	—
定时任务	—

迁入的专家及相关数据，会归属于在 Octop 中执行恢复的管理员账号。

​

步骤 1 — 在 LightClaw 导出

在 LightClaw 打开高级设置，切换到导出到 Octop标签页。

1. 打开导出页

   进入高级设置 → 导出到 Octop，确认页面上列出的迁移包含与不包含项。

2. 导出归档

   点击导出为 Octop 备份。浏览器会下载类似 octop-backup-from-lightclaw-….tar.gz 的文件。

在 Octop 恢复完成前，请妥善保存该 .tar.gz。

​

步骤 2 — 在 Octop 恢复

在 Octop 打开管理 → 应用设置，切换到备份与恢复标签页。

1. 上传归档

   点击上传备份，选择刚从 LightClaw 导出的 .tar.gz。上传只会把文件存进备份目录，不会立刻恢复。

2. 发起恢复

   在备份列表中对该归档点击恢复。确认弹窗里可选择是否同时恢复 config.json 与 env（这类配置需手动重启服务后才完全生效）。

3. 确认

   点击恢复。Octop 会覆盖当前数据库与本地工作区，随后热加载模型、专家与通道。

恢复不可撤销。若当前 Octop 实例已有重要数据，请先新建一份备份再操作。

​

迁移之后

• 若 Octop 要求重新登录，按提示登录即可——迁移恢复可能轮换会话密钥，但会保留当前管理员用户。
• 打开模型、通道、任务，确认 Provider、机器人和定时任务是否符合预期。
• 停止 LightClaw，或关闭其通道，避免同一 IM 消息被两边同时处理。
• 在 Octop 里开新对话继续工作——LightClaw 的历史消息不在迁移包内。

备份与恢复面板也用于日常 Octop 备份。与 LightClaw 无关的备份流程见备份与恢复。