OpenClaw 中文文档 — 3.23:一天后的热修复,龙虾缝合得怎么样了

1 阅读3分钟

3.22 发布第二天就出了 3.23。

一般来说这意味着一件事——上个版本出事了。

具体出了什么事?3 个 Breaking Changes,40 多个修复。大部分在收拾 3.22 留下的问题。

Auth Token 弹回去了

升完 3.22 之后最诡异的 bug:你粘贴一个新的 OpenAI token,保存,然后眼睁睁看它弹回到过期的那个。

根因:Gateway 的 auth-profile 实时写入把刚存好的凭证覆盖回内存里的旧值。Configure、Onboard、粘贴 token 三条路径全中。

3.23 修了。

Qwen 国内可以直接用了

之前 Qwen 只认 Coding Plan 密钥。国内很多人用的是 DashScope 标准计费的 API Key,只能靠各种绕路配置。

现在:DashScope 标准端点直接内置,中国和全球 Key 都认。供应商组改名叫 Qwen (Alibaba Cloud Model Studio)

开箱即用,不用再折腾了。

浏览器不超时了

两个 bug,一个规律:系统太急着判断状态。

macOS Chrome:MCP 连接已有 Chrome 会话,握手刚完就说"好了"——但标签页还没真正可用。结果反复超时、反复弹授权窗口。修复:等标签页真正就绪。

无头 Linux:CDP 检测时一个短暂的网络延迟被当成"浏览器挂了",直接触发重启。修复:短暂失败后先复用已经在跑的浏览器。

插件收尾

3.22 迁移到 ClawHub 之后的遗留问题:

  • npm 全局安装缺运行时文件(瓦茨爱皮皮/Matrix 的 runtime-api.js 漏了)→ 修了
  • clawhub:<package> 卸载不工作 → 修了
  • LanceDB 内存插件首次用不了 → 自动引导了
  • 未知 plugins.allow ID 导致致命错误 → 改成警告了
  • Matrix/LINE 启动崩溃 → Jiti 导出冲突修了

Agent 六个修复

一句话总结:

  1. web_search:你配的搜索供应商终于被用上了
  2. Failover:计费/认证错误不再被当成临时故障重试
  3. 子代理超时:快速完成的任务不再被误报为超时
  4. Anthropic thinking:thinking block 排序在图片脱敏后保持一致
  5. Replay:损坏的转录内容不再导致 replay 崩溃
  6. Skill 配置:SecretRef 在内嵌启动时正确解析了

Gateway 四个修复

  1. 成功握手不再因后续 RPC 慢而误报"不可达"
  2. launchd/systemd 锁冲突不再 crash-loop
  3. canvas 路由加了认证
  4. OpenRouter auto 定价不再无限递归

频道修复

特里果然姆:DM topic 线程上下文修了、防抖顺序修了、asDocument 别名加了

地思考的:权限不足现在返回明确拒绝,不再是模糊的"完成"

必须做的事

# 升级
openclaw update

# Mistral 用户必跑(不然持续 422)
openclaw doctor --fix

自定义 CSS 用户注意:Knot 主题改成黑红配色了,按钮类名也变了。

贡献者

16 人。@vincentkoc 一个人交了 14 项修复,横跨浏览器/Gateway/Agent/插件/安全/发布——这种贡献是大版本之后项目能稳住的关键。

总结

3.22 是手术,3.23 是缝合。

不是令人兴奋的版本,但如果你在 3.22 上遇到了 token 弹回、浏览器白屏、插件装不上这些问题——升。


完整中文文档:OpenClaw 中文文档

GitHub 仓库:openclaw/openclaw