一轮没有新功能、但很值得升级的修复更新
这次 4.8 的重点不是加功能,而是把 4.7 升级后最容易踩到的启动和插件加载问题一次性修掉。
4.7 才刚上线没多久,4.8 就紧跟着发布了。
这一次没有塞入任何新功能,而是专注修复。如果你在升级 4.7 之后碰到 Telegram 无法连接、Slack 异常、某些渠道插件启动时报错,那这次更新基本就是对着这些问题下刀的。
一、这次到底修了什么
4.8 所有修复几乎都围绕同一个底层原因:通过 npm 安装 OpenClaw 之后,一些渠道插件在启动时找不到自己要加载的文件,于是直接报错。
这其实是典型的打包路径问题:开发环境里相对路径是对的,但进入正式 npm 包之后,目录结构变化了,插件还在沿用旧路径,结果自然是加载失败。
4.8 的修复方案就是把这些插件统一切到 打包后的顶层 sidecar 文件 上去读取。路径一旦修正,启动问题也就跟着没了。
二、哪些渠道受影响
这次波及范围并不小,几乎覆盖了大部分常见渠道:
Telegram:启动时去找 dist/extensions/telegram/src/*,结果路径失效。
Slack:同样有路径问题,而且还有两个额外修复。
飞书(Feishu):同类问题。
Microsoft Teams、Google Chat、Matrix、Mattermost:同类问题。
IRC、Nextcloud Talk、Zalo、BlueBubbles:也都在本次修复范围内。
如果你正好是通过 npm 安装了 4.7,升级后又遇到某个渠道连不上、插件报错、或者根本起不来,那么最省事的做法就是直接更新到 4.8。
三、Slack 额外修掉的两个坑
Slack 这次不只是修路径,还顺手把两个现实里很容易卡人的 bug 修了。
1. 代理环境下 Socket Mode 连不上
以前 Slack 的 Socket Mode WebSocket 连接不会正确读取代理设置,所以在企业内网或需要 HTTP/HTTPS 代理的环境里,很容易直接连不上。4.8 修复后,会正确读取系统代理变量,也包括 NO_PROXY 规则。
2. Bot token 读取失败
如果你的 Slack bot token 放在 SecretRef 里,之前下载文件时会触发一次对原始配置的重新读取,进而把 token 解析搞坏。现在这个问题也已经处理掉了。
四、另外两个值得注意的修复
exec 命令显示的策略信息终于对了
之前运行 /exec 查看当前配置时,看到的默认执行策略并不是真实值,而是旧版本遗留下来的更严格默认值。它不会影响实际执行,但会让你误判配置状态。4.8 把这个显示误差一并修掉了。
代理模式下 DNS 锁定逻辑修正
OpenClaw 原本会在发请求前先做 DNS 解析并锁定 IP,用于 SSRF 防护。但如果你本来就走代理,这一步反而会破坏代理的正常解析链路。4.8 在检测到代理模式后,会跳过本地 DNS 锁定,把解析工作交给代理处理。
五、现在要不要升级
可以按这几个情况判断:
1. 如果你刚升 4.7,而且已经出现渠道异常,那就直接升到 4.8。
2. 如果你现在 4.7 跑得很稳,那可以先不急,等后续功能版一起升。
3. 如果你处在企业内网或强代理环境,比较建议升级,尤其是 Slack 相关修复很实用。
4. 如果你还停在更老版本,也可以顺手把这次修复一起带上。
六、升级命令
1. 执行 npm install -g openclaw@latest
2. 升级完成后,执行 openclaw doctor
3. 重点回测你常用的 Telegram、Slack 或其他渠道插件是否恢复正常
整体来看,OpenClaw 现在的修复节奏确实很快。4.7 才上线几个小时,4.8 就把关键问题补上了。对用户来说,这其实是件好事:踩坑之后不用等太久,往往就能拿到修复。
如果你正好卡在 4.7 的启动问题里,这次更新值得立刻试一下。
觉得有用?点赞 + 在看 + 转发,让更多人看到 👇
如果你升级后还有报错,也可以继续贴出来一起排查
夜雨聆风