> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 从 LightClaw 迁移到 Octop

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

从 OpenClaw 或 Hermes Agent 迁入时不走这份备份，用命令读取原来的目录。见[从 OpenClaw 迁移](/guide/migrate/openclaw.md)和[从 Hermes Agent 迁移](/guide/migrate/hermes.md)。


> **注意**
> 
> 迁移前请先把 **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**标签页。


![LightClaw 导出到 Octop](/images/ui-lightclaw-export-octop.png "导出到 Octop")


### 打开导出页

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

### 导出归档

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

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

## 步骤 2 — 在 Octop 恢复

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


![Octop 备份与恢复](/images/ui-octop-backup-restore.png "备份与恢复")


### 上传归档

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

### 发起恢复

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

### 确认

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


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


## 迁移之后

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


> **提示**
> 
> **备份与恢复**面板也用于日常 Octop 备份。与 LightClaw 无关的备份流程见[备份与恢复](/guide/guides/backup-restore.md)。
> 

