OpenClaw 会话同步与跨设备续接

最后更新 2026-09-17 · MIT 许可 · 个人自托管免费

OpenClaw 是支持列表里配置方式最特殊的一个：它的内置 MCP server 是惰性启动的，只注册客户端不会自动同步，需要一个常驻进程来跑同步循环。

会话存在哪里

项 值
会话索引 ~/.openclaw/agents/<id>/sessions/sessions.json
会话内容 同目录下的 <sessionId>.jsonl
会话标识 以 transcript 的 UUID 为准；索引里的 key 存在 meta.openclaw:session_key

接入同步（两步）

第一步，和别的 Agent 一样：在接入帮助页选择 OpenClaw → 下载客户端包（服务端地址已自动预填）→ 解压后首次运行 install-deps.bat（Windows）或 ./install-deps.sh（macOS / Linux）→ 用页面给出的注册命令接入（工作区 API Key 已自动填入），客户端以 HERMES_SYNC_AGENT=openclaw 启动。

第二步，装常驻同步进程（OpenClaw 专有）：接入帮助页提供一份一键安装脚本（PowerShell 与 Git Bash 两版）。把它与解压出来的客户端 mcp/ 目录放在同级解压后运行，会注册为开机自启的常驻同步，不需要你手动起进程。

下载并解压客户端 → 运行 auto-sync 安装脚本 → 确认自启已注册

同步行为与注意点

  • 索引与内容分开维护：会话内容走 JSONL 追加，会话列表走 sessions.json 索引更新。
  • 网关会热加载索引（按修改时间），所以你不需要重启网关就能看到新会话。
  • 网关自身写入可能覆盖索引：网关在写自己的会话时会重写 sessions.json。为降低竞态，建议在网关有写入之后再拉一次（Web 控制台手动同步，或等下一个 5 分钟周期）。
  • 常驻进程是必需的：不装第二步，同步不会自己跑起来 —— 这是 OpenClaw 惰性启动机制决定的，不是配置错误。

跨设备与跨 Agent

装好常驻同步后，OpenClaw 的会话就和其他 Agent 一样进池子：另一台机器上的 OpenClaw、Hermes、OpenCode 都能看到并接着用。对「常驻的助手型 Agent」来说，跨设备接续的价值往往比编码类 Agent 更高 —— 你换台机器不至于从「你是谁」重新介绍自己。

相关