从 Hermes Agent 迁移到 Octop
一条命令把 Hermes Agent 的模型、人设与记忆、你自己安装的技能、MCP 服务器和聊天通道读进 Octop 的一位专家。命令只读取原来的目录,不会修改或删除其中的文件,迁移后两边可以并存。适用于 Octop 1.0.3b5 及以上。
步骤和 OpenClaw 相同,把命令里的 openclaw 换成 hermes。这一页只写 Hermes 自己的路径、凭证和差异。LightClaw 走备份恢复,见从 LightClaw 迁移。
会迁移什么
不会迁入的内容出现在结果末尾:
- Hermes 自带的技能。记录在
skills/.bundled_manifest里的技能会跳过,只迁你自己装的。 - 定时任务。在 自动化 里新建,或用
octop cron create。见定时任务。 - 使用 SSE 传输的 MCP 服务器。换成 Streamable HTTP 地址后,在 连接器 里手动添加。
- 只能用 OAuth 登录的模型账号,以及 Octop 里没有对应类型的模型供应商。
- Octop 暂不支持的通道,例如 Slack、Matrix、Mattermost。
开始之前
在装有 Hermes Agent 的那台机器上安装并初始化 Octop。
默认读取 ~/.hermes,也认 HERMES_HOME。目录在别处时加上 --from。
准备一位接收内容的专家。在 专家 页点 新建专家,或运行 octop agent create assistant。记下卡片名字下面的 专家 ID。下文示例用 1S3N3P。
迁移时不必停掉 Hermes Agent。只有在启用聊天通道之前,才需要先停掉原来的机器人。
预演并执行


预演不写入任何内容。状态分为「将迁移 / 已迁移」「已跳过」和「失败」。说明列写了跳过或失败的原因。
Octop 正在运行时需要重启,新的模型供应商和通道才会加载。用系统服务运行时执行 octop service restart。在终端里用 octop run 运行的,按 Ctrl+C 停止后重新运行。
在页面上核对
- 模型 — 打开 管理 → 模型配置。某一项的说明是「未找到 API Key」时,在这里补上密钥。
- 人设与记忆 — 在专家卡片上点 编辑工作区。
SOUL.md、MEMORY.md和USER.md在工作区根目录。 - 技能 — 打开 个性化 → 技能。迁过来的技能已经安装并启用。自带技能不在这里。
- MCP — 打开 连接器 → 已启用连接器。点卡片可以查看或修改命令、地址和请求头。



启用聊天通道
同一个机器人如果同时被 Hermes Agent 和 Octop 接管,一条消息会被回复两次,或者两边互相抢消息。所以迁过来的通道默认不启用。

停掉原来的机器人
停掉 Hermes Agent 的网关或服务,确认它已经不再回复。
核对凭证
打开 个性化 → 通道。点通道卡片,确认 Token、App ID 等凭证已经带过来,点 检测连接。
启用
打开 启用频道 并保存。给机器人发一条消息试试。

命令选项
可以重复运行。已经存在的内容会跳过。--overwrite 只覆盖工作区文件、技能和默认模型。模型供应商、MCP 连接器和通道不会被覆盖。要重新迁入它们,先在页面里删掉对应条目,再运行一次。
常见问题
提示「未找到 Hermes 的安装目录」。 用 --from 指定目录,例如 --from /srv/hermes。
提示 --agent is required。 加上 --agent,或先运行 octop agent use。
有一项显示「失败」。 看 说明 列,修正后再运行一次。已经成功的内容会跳过。有失败项时退出码为 1。
迁完后对话里选不到模型。 确认已经重启 Octop,并在 管理 → 模型配置 里检查供应商的 API Key 和地址。
还想把 OpenClaw 迁进同一位专家。 可以。后运行的那条遇到同名的人设文件、技能或已经设置的默认模型会跳过。希望两边分开时,各建一位专家。

