> ## Documentation Index
> Fetch the complete documentation index at: https://octop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 从 LightClaw 迁移到 Octop

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

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

> [!WARNING]
>
> 迁移前请先把 **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](https://mintcdn.com/octop/LCcHeDKptpaVvFuf/images/ui-lightclaw-export-octop.png?fit=max\&auto=format\&n=LCcHeDKptpaVvFuf\&q=85\&s=76d5c585f39baea0e205421c73a084f8)

**1. 打开导出页**

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

**2. 导出归档**

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

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

## 步骤 2 — 在 Octop 恢复

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

![Octop 备份与恢复](https://mintcdn.com/octop/LCcHeDKptpaVvFuf/images/ui-octop-backup-restore.png?fit=max\&auto=format\&n=LCcHeDKptpaVvFuf\&q=85\&s=82fa2c036ff85f5106c4ae6a96c5d355)

**1. 上传归档**

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

**2. 发起恢复**

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

**3. 确认**

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

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

## 迁移之后

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

> [!TIP]
>
> **备份与恢复**面板也用于日常 Octop 备份。与 LightClaw 无关的备份流程见[备份与恢复](https://octop.mintlify.site/zh/guides/backup-restore.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.