kita / notes
← 回到全部笔记

事件日期 阅读约 4 分钟

多 Agent 协同实测与 OpenClaw「三省六部」落地:从文件黑板接力到修掉 Node spawnSync EBUSY

发布于

本文目录(3 节)
  1. 1. 12 次真调用实验:没有共享载体,跨会话接力 100% 断掉
  2. 2. 部署 OpenClaw + Edict 三省六部踩到的 6 个坑
  3. 3. Gateway 起不来的真凶:spawnSync 的 stdin 命名管道 EBUSY

10 月初我同时在用 WorkBuddy、OpenCode、DeepSeek Harness(dsh)、ZCode 和 Cursor,经常出现上半场在 A 工具里查完问题,下半场切到 B 工具让它接着改,结果 B 完全不知道 A 干了什么。为此我花五天时间做了两件事:先用真实验摸清多 Agent 共享状态的底线成本,再把社区里 1.6 万星的 cft0808/edict(基于 OpenClaw 的“三省六部” 11 Agent 协同看板)搬到 Windows 本机跑通。

1. 12 次真调用实验:没有共享载体,跨会话接力 100% 断掉

在读了 12 个多 Agent 框架(ruflo、hive、munder-difflin、gastown、agent-orchestrator 等)的源码后,我先纠正了自己看 README 时的一个误判:像 ruflo 号称的跨实例 federation 只是发消息(复制分发),只有具备单一可变写入点、所有参与者读写同一份状态的才算真共享。

为了量化“共享状态到底值多少钱”,我设计了一个严格对照实验(S3_experiment_report.md):让 Agent-1 生成一个不可猜的随机事实指纹,再让全新的 Agent-2 报出这个指纹,唯一变量是中间的共享载体,每组跑 3 次真调用:

实验组 共享载体 Agent-2 答对率 Agent-2 平均耗时
A 组 无共享 0 / 3(0%) 10,819 ms
B 组 文件黑板(board.md) 3 / 3(100%) 4,810 ms
C 组 结构化文件(JSON) 3 / 3(100%) 6,124 ms
D 组 同工具 Session 续用 3 / 3(100%) 3,717 ms

有两个很有意思的实验现象:一是 A 组无共享时反而比 B 组慢了一倍多(10.8s vs 4.8s),因为模型在回答“我不知道”之前会先在目录里徒劳地搜一圈;二是仅仅加一个 Markdown 文件,就把跨工具接力成功率从 0% 拉到了 100%。

基于这个结果,我把本机的跨工具协作收敛成了零服务成本的两层文件结构:静态规矩放 ~/.workbuddy/shared/AGENTS.md(由 sync.py 同步到 8 个工具的指令落点),动态在办状态放 Desktop/ai/.workbuddy/memory/HANDOFF.md(单写者接力台)。

2. 部署 OpenClaw + Edict 三省六部踩到的 6 个坑

10 月 5 日开始在本机部署完整形态的 Edict(太子、中书省、门下省、尚书省、六部与钦天监共 11 个角色,看板跑在 http://127.0.0.1:7891)。照着网上流传的残缺教程做一定会翻车,实操中一共拆了 6 颗雷:

  1. OpenCode Go 模型的出口与协议分家:写脚本全量实测了订阅里的 36 个模型,发现 gpt-6-luna、gpt-5.6-luna、grok-4.6、grok-4.7 四个模型只认 /v1/responses 协议,打 /v1/chat/completions 必报 ModelProtocolUnsupported;而且 gpt-6-luna 在国内直连和香港代理下都会报 403 unsupported_country_region_territory,把本机 Clash(127.0.0.1:7897)切到新加坡节点后 33 个模型才全部打通。
  2. koffi 原生模块误报缺 CMake:npm i -g openclaw@latest 时,koffi@3.3.1 的安装脚本误报 Failed to load prebuilt binary 并试图调 CMake 编译。实际上 @koromix/koffi-win32-x64 的 koffi.node 预编译二进制明明就在盘上且能直接 require('koffi')。改用 npm i -g openclaw@latest --ignore-scripts 再手动跑 postinstall-bundled-plugins.mjs,51 秒装完。
  3. OPENCLAW_HOME 跨工具语义完全相反:openclaw CLI 把这个环境变量当成父目录(自己再往里套一层 .openclaw),而 Edict 的 install.ps1 把它当成 .openclaw 目录本身,run_loop.ps1 在变量未设置时又把它推成仓库根目录导致刷新循环一直空转。修法是干脆删掉 Env:OPENCLAW_HOME,让两边都回退到默认的 ~/.openclaw。
  4. PowerShell 5.1 吃双引号导致 Agent 注册静默失败:install.ps1 里内嵌了一段 Python 代码,其中的 f-string {b.get("agentId", "?")} 被 PowerShell 5.1 传参时吃掉了内层双引号变成 {b.get('agentId', ?)} 抛 SyntaxError,而脚本没检查退出码还照常打印“注册完成”。
  5. OpenClaw 2026.9.8 的 agents schema 断代:新版 OpenClaw 要求 agents 结构为 { ownership: "explicit", defaults, entries } 且 additionalProperties: false,而 Edict 全套脚本还在读写旧版的 agents.list 数组,并且 apply_model_changes.py 里有原地修改字典后再跟自身比对导致“永不落盘”的 Bug。我把注册与热切换脚本全部改成了读写 entries 并在修改前保存 JSON 快照。

3. Gateway 起不来的真凶:spawnSync 的 stdin 命名管道 EBUSY

看板跑起来后,openclaw gateway run(端口 18789)死活起不来,openclaw config validate 也只报一行没头没脑的:

TypeError: Cannot read properties of undefined (reading 'trim')

去翻 dist/sqlite-readonly-worker-cuICqy4r.mjs 第 36 行,发现是错误处理代码在 stderr 为 undefined 时直接调了 stderr.trim(),把底层真正的异常给吞了。加上空值保护后,真凶终于露面:

SQLite read-only worker failed to start: spawnSync C:\Program Files\nodejs\node.exe EBUSY

为了搞清楚为什么 spawnSync 会报 EBUSY,我在本机跑了一组最小对照矩阵:

调用方式 stdio 配置 本机结果
spawnSync(node.exe) 默认 ['pipe', 'pipe', 'pipe'] EBUSY 失败
spawnSync(node.exe) ['ignore', 'pipe', 'pipe'](只关掉 stdin 管道) 100% 通过
execFile(node.exe) 异步管道 100% 通过

定位非常干净:罪魁祸首只在 spawnSync 的 stdin 管道上,而 OpenClaw 的 SQLite 只读 worker 参数完全通过 argv 传递,根本不用 stdin。

于是连 OpenClaw 源码都不用改,直接写了一个 20 行的预加载补丁 C:\Users\30408\.openclaw\fix-spawn-sync.cjs:劫持 child_process.spawnSync,当调用方未显式传入 stdio 或 input 时,默认把 stdio 设为 ['ignore', 'pipe', 'pipe']。通过 NODE_OPTIONS=--require=C:\Users\30408\.openclaw\fix-spawn-sync.cjs(注意路径千万不能加双引号,否则 Node 会把引号里的反斜杠当转义吃掉)注入后,openclaw gateway health 在 72ms 内返回 OK,桌面双击《一键上朝.cmd》即可把 Gateway、数据刷新循环和 7891 看板一次性拉起。

← 返回全部手记