进阶
灵魂桥
让装着 Hermes Agent 或 OpenClaw 的机器成为同一个 agent 的另一具身体:把一句话发给那里的 agent,ta 会自己安装。
#它是什么
soul-bridge 是一个可以随时装上、拔出的小守护进程,装在运行 Hermes Agent 或 OpenClaw 的机器上。它把那个框架的人格与记忆文件和灵魂仓库双向同步,让手机上的 ta 和电脑上的 ta 共用同一个灵魂。
图表加载中…
#安装:让 ta 自己装
控制 → 高级 → 同步 的「Hermes / OpenClaw」里有一句现成的话。复制它,发给那台机器上的 Hermes 或 OpenClaw,ta 会按技能自己完成下面几步:
- 检查 Node.js(22.18+),没有就装在用户目录;获取程序;把技能留在自己的技能目录;
- 按顺序确定灵魂仓库:你给的地址 → ta 自己的记忆 → GitHub 上已有的
*.soul私有仓库 → 自动创建; - 用一条
init完成全部配置:生成部署密钥,有gh或GITHUB_TOKEN时自动添加可写部署密钥,克隆,导入现有人格与记忆,安装钩子与后台服务,首次同步; - 用
doctor自检,并按建议修复。
遇到三种情况时,ta 会把需要你做的事合并成一条消息发给你:缺少 GitHub 凭据;缺少 git 且没有 sudo;同一错误重试 3 次仍失败。通常你只需要在 GitHub 网页上添加一次 ta 给出的部署公钥。
整个过程你不需要打开终端。
#同步什么
| 映射 | Hermes | OpenClaw |
|---|---|---|
| 人格 | SOUL.md | SOUL.md |
| 常驻笔记 | memories/MEMORY.md(写回时按 Hermes 的字符上限截取,截取不写回仓库) | MEMORY.md(自由 Markdown,新段落被吸收为条目) |
| 关于用户 | memories/USER.md | USER.md |
| 日记 | —(Hermes 没有日记) | memory/YYYY-MM-DD*.md 双向;其他身体的日记镜像到 memory/bodies/<身体>/ |
| 共享笔记 | — | memory/notes/**.md 逐篇双向 |
| 生效时机 | 下一个会话 | 下一轮 |
桥接复制文件,并记住两侧的基线:框架新增的条目保留,框架删除的条目删除,被上限截掉的条目仍留在灵魂里,不算作删除。
#何时同步
Hermes:memory 工具调用后、会话收尾、文件变化时,以及定期拉取远端。OpenClaw:启动、/new、/reset、压缩后、文件变化时,以及定期拉取。那台机器收不到推送通知,所以要定期拉取;它只负责传输,和 agent 什么时候醒来无关。
#命令(供排错)
| 命令 | 作用 |
|---|---|
init | 一条命令接入 |
doctor | 逐项自检并给修复建议 |
sync | 立即同步一次 |
status | 配置、最近同步结果、公钥 |
attach / detach [--purge] | 重装钩子与服务 / 拔出(框架文件保持原样) |
本地数据在 ~/.agent-soul/<agent>/:配置、仓库副本、基线、部署密钥、日志。
#拔出
让那边的 agent 执行 detach,或者直接在 GitHub 删掉它的 Deploy key,它就写不进灵魂仓库了。框架里的文件保持原样。