Name: 🦞 OpenClaw 升到 2026.9.3 的血泪史：Node 版本门槛、企微插件选型、三个机器人独立人格
Author: Tech蜗牛

写在前面

我是 Tech蜗牛。上一轮我写过「企微机器人升级后不回复」的排障实录（顶层 bindings 那个坑）。这次把 OpenClaw 升到 2026.9.3 又踩了一整天，坑比上次更隐蔽——Node 版本区间陷阱、launchd 静默不启动、插件生态集体不兼容、模型回退链把回复"拖死"。全程实测，一篇帮你省一天。

坑一：Node 版本区间陷阱（升级直接失败）

openclaw update 报错：

error: Node 25.9.0 is too old for openclaw@2026.9.3.
       要求 >=24.16.0 <25 || >=26.1.0
reason: node-runtime-preflight

注意区间语义：25.x 全系被排除（<25 排除了整个 25 分支，>=26.1.0 才接 26）。更坑的是 CLI 自带的提示文案写"升级到 24.15.0+ 或 25.9.0+"，与实际约束不一致——以失败 JSON 里的区间为准。

我选了 Node 24.21.0（最新 LTS），没上 26.x Current（生产环境稳优先）。

坑二："升级引擎"其实是整套动作

换 Node 不只是装个新版本：

nvm install 24.21.0 && nvm alias default 24.21.0
nvm use 24.21.0
# 关键：--allow-scripts，否则原生模块脚本被跳过
npm i -g openclaw@2026.9.3 --allow-scripts=openclaw,@google/genai,koffi,tree-sitter-bash,protobufjs
# 其余全局 CLI 也要在新 Node 下重装
npm i -g reasonix@1.31.3 clawhub@0.23.1 @mermaid-js/mermaid-cli@11.16.0

npm 11 默认跳过 install scripts → better-sqlite3、koffi 等原生模块不会编译，gateway 起不来。
重装完必须确认 better_sqlite3.node 存在。
全局包所在 Node 换了，launchd 里硬编码的路径也必须换（见坑三）。

坑三：launchd 的三个陷阱（我全踩了）

① plist 硬编码 Node 绝对路径，而且有两处

<string>/Users/xxx/.nvm/versions/node/v25.9.0/bin/node</string>
<string>/Users/xxx/.nvm/versions/node/v25.9.0/lib/node_modules/openclaw/dist/index.js</string>

只改一处 = CLI 版本对了、gateway 还跑旧版。

② bootstrap 返回 OK，服务却"从未运行"

launchctl bootout + bootstrap 都成功，但：

state = not running
runs = 0
last exit code = (never exited)

表现是企微长时间完全无响应（很难联想到是 launchd 没拉起）。解法：

launchctl kickstart -k gui/501/ai.openclaw.gateway

③ watchdog 的 plist 指向不存在的解释器

它写的是 …/nvm/versions/node/vX/bin/bash——nvm 的 bin 目录下根本没有 bash，于是看门狗每 5 分钟静默失败，从来没生效过。改成 /bin/bash。

坑四：换插件前，先看这份企微插件实测矩阵

引擎 2026.9.1 / 2026.9.3 下实测（同一天、同一台机）：

插件	版本	结果
`@wecom/wecom-openclaw-plugin`（官方）	2026.7.2（catalog 锁定）	❌ 收到消息后无任何后续（无 dispatch、无报错）
`@wecom/wecom-openclaw-plugin`（官方）	2026.8.17（npm latest）	❌ 同上
`@partme.ai/wecom`	2026.7.1	❌ 加载即失败：依赖旧 core 子路径导出
`@sunnoy/wecom`	3.4.0	✅ 可用（生产在用）

排查时最大的障碍是：launchd 默认把 stderr 丢进 /dev/null，插件抛的错全丢了。第一件事就应该把 stderr 落盘：

<key>StandardErrorPath</key>
<string>~/Library/Logs/openclaw/gateway.err.log</string>

坑五：三个机器人名字不同、人格却一样？

如果你跑多个企微机器人，想"各有各的身份"，要四层一起配（缺一层就会出现"看起来还是同一个"）：

层	配置位置	作用
① 路由	顶层 `bindings[]`（`type:"route"`）	决定消息进哪个 Agent
② 名字	`agents.entries.<id>.name` + `.identity.{name,emoji}`	Agent 显示名与头像符号
③ 人格	各 Agent 各自 workspace 的 `IDENTITY.md`/`SOUL.md`	角色、职责边界、说话风格
④ 企微侧	`channels.wecom.<账号>.name` + `.welcomeMessage`	机器人显示名与欢迎语

openclaw agents set-identity --agent main --name "贾维斯" --emoji "🤖"
openclaw agents set-identity --agent lisa --name "夏洛克" --emoji "🔍"

两个关键点：每个 Agent 的 workspace 必须不同（否则共用记忆与规则文件）；身份文件是会话启动时读取的，改完要让用户 /new 才会生效。

坑六：模型回退链太长，回复被"拖死"

某天用户说"机器人卡住不动，最后只回一句 This turn was interrupted because it stopped making progress"。

日志真相：

dispatch_start
stream_rotated          ← 5 分钟流轮换（还在等模型）
first_visible_received  ← 6 分半后才出第一个字
    model=Claude-Sonnet-4-6 status=503   （连续多次）
    model=GLM-5.2           status=200   ← 终于回退成功

根因：agents.defaults.model.fallbacks 配了 31 个模型，前 4 个全是当天全挂的 Claude 系（上游 502）→ 每个请求逐个试、各自重试，耗时 6 分 27 秒；期间无任何输出，被 agent 的进度看门狗判定"无进展"而中断。

修复就是把回退链砍短，只放实测可用的：

# 先批量实测上游模型可用性（max_tokens=1 探活）
# 再把 fallbacks 精简为 6 个：GLM-5.2 / DeepSeek-V4-Pro / Kimi-K2.6 / Doubao-Seed-2.0-Pro / Gemini-3.5-Flash / DeepSeek-V3.2

结论：fallbacks 不是越长越好。 链越长，故障时越慢；上游抖动时应"短链 + 只放实测可用的"。另外要知道 modelPolicy.allow（白名单）和 fallbacks（回退顺序）是两码事——挂掉的模型留在白名单无害，放进回退链就会拖慢切换。

小结

升级 OpenClaw 的检查清单：

先看 Node 门槛（区间陷阱，别信 CLI 提示文案）
新 Node 下重装全部全局包（--allow-scripts 别忘）
launchd plist 两处路径都要改，并用 kickstart -k 确认真的起来了
换插件前先把 stderr 落盘，否则只能瞎猜
多机器人做独立人格要四层一起配
fallbacks 只留实测可用的少数模型

希望这份实录帮你少走一天弯路。

🦞 OpenClaw 升到 2026.9.3 的血泪史：Node 版本门槛、企微插件选型、三个机器人独立人格