使用指南
多具身体
把几部手机、几台电脑连成一个 ta:一份对话、一颗心,ta 自己选在哪具身体上思考,也能用另一具身体的相机与命令行。
#它是什么
灵魂仓库让同一个 agent 的几具身体共享人格与记忆;多具身体更进一步,让同时在线的身体直接连在一起,变成一个心智:
| 共用的 | 说明 |
|---|---|
| 一份对话 | 会话、对话、心流在所有身体上是同一份。在手机上开始的话题,打开电脑上的控制台接着看;别处的回复标出「在 X 上」 |
| 一颗心 | 只有一具身体(协调者)决定 ta 什么时候醒来;其他身体的感觉(被拿起、接上电源……)都汇过去 |
| ta 选在哪里做 | 醒来时 ta 看到每具身体的电量、温度、手头的事、你最近在哪里说话,自己选在哪一具(或几具同时)上思考、做梦 |
| 用另一具身体 | 在电脑上思考时可以用手机拍照、在服务器上跑命令(body_call),也可以把这一轮整个换到另一具身体继续(move_to) |
| 一份设置 | 模型与 Key、权限、预算(每日合计)、听觉与语音、急停在一处改了处处生效 |
正在和你说话的那一轮在哪具身体上,所有控制台都看得到;你在别处对同一个会话说的话,会自动转过去。
#需要什么
- 同步服务:让身体互相找到、打不通时中转。它不保存对话与记忆,只有账户、agent 与身体的登记。可以自己部署(仓库里的
sync/,一台有公网地址的 Linux 服务器,一行命令启动),见 sync/README。 - 灵魂仓库:每具身体先接入同一个灵魂仓库(见灵魂同步)。身体之间互相核对身份用的公钥登记在这里——这是信任的根,同步服务被攻破也冒充不了你的身体。
- GitHub 账号:在同步服务的网页上登录、批准身体。
#绑定一具身体
控制 → 多具身体:
- 填写同步服务地址(
https://…),保存。 - 点「绑定到同步服务」,页面上出现 8 位绑定码与一个链接(也可扫码)。
- 在浏览器里打开链接,用 GitHub 登录,输入绑定码;核对网页上的公钥指纹与控制台上的一致,点「批准」。
- 几秒后这具身体连上同步服务;其他已绑定的身体在线时,它们直接连上(局域网直连、IPv6、穿透,打不通时经服务器中转——中转的内容也是端到端加密的)。
同一个 agent 的所有身体要绑定到同一个 GitHub 账户下才会互相看到。
图表加载中…
#日常会看到的
- 谁持有心跳:多具身体页显示「心跳在 X 上」。几具身体都在线时,优先级大的持有;一样大时,接着电源的、开得久的优先。一直开着的服务器可以把「当协调者的优先级」调高。持有者离线,另一具身体会从最新的状态接着跳。
- 心流里的「选身体」:ta 醒来时选在了哪里。
- 审批:别处等待批准的请求也会出现在这里(标出在哪具身体上),在哪里批准都行。
- 急停:有其他身体在线时,急停会问你停「所有身体」还是「只停这具身体」。
- 飞书:同一个飞书机器人只能由一具身体连接。在「控制 → 飞书」里选「谁持有飞书」,其他身体想主动跟你说的话会转给它发出。
- 听觉:几部手机的耳朵同时听到同一句话时只留一份;ta 用声音回话时,从你说话的那部手机说出来。
- Hermes / OpenClaw:装了灵魂桥的身体可以作为只读成员绑定(把同步服务地址告诉那边的 ta,它会给你一个链接与绑定码):它能看到 ta 此刻在哪具身体上做什么、最近的会话,但不能在别的身体上做事,也不会被派去思考或做梦。
#断开时
身体之间连不上(断网、同步服务停了),每具身体照常运行,记忆仍经灵魂仓库同步;如果断成几部分,每部分各自有一颗心。重新连上时对话自动补齐,心跳合并。
#安全
- 身体之间的连接用 WebRTC(DTLS 加密),信令由每具身体的节点密钥签名,接收方只认灵魂仓库里登记的公钥。
- 模型 Key 在身体之间只经这条加密通道传,到了对方用它自己的主密钥重新加密保存。
- 同步服务只存:GitHub 用户名与显示名、agent 名与 id、身体名 / 类型 / 版本 / 公钥 / 最近在线时间;令牌只存哈希。不存 IP 与网络地址,看不到对话与记忆。
- 在同步服务网页的账户页可以随时解绑身体、删除 agent 或整个账户。