OpenClaw 4.11 踩坑指南

今天凌晨，OpenClaw发布了v2026.4.11。作为一个重度用户，我第一时间更新并测试了一圈。结果发现：这次更新修复的bug，几乎都是我之前踩过的坑。

如果你也在用OpenClaw，这篇踩坑指南值得一看。

坑一：Codex登录永远失败

问题描述：之前用Codex OAuth登录时，OpenClaw会偷偷篡改上游authorize URL的scope参数。结果就是：每次登录都报invalid_scope错误，完全进不去。

踩坑经历：我花了整整一个下午排查这个问题。以为是网络问题、以为是Codex服务挂了、甚至怀疑是自己的账号有问题。最后发现是OpenClaw自己"好心办坏事"。

修复效果：现在登录流程干净利落，一次成功。如果你是Codex用户，这个修复直接解决了"用不了"的问题。

坑二：音频转录全面瘫痪

问题描述：OpenAI、Groq、Mistral三家的音频转录功能集体失效。具体表现是：上传音频文件后，系统要么卡住不动，要么直接报错。

根本原因：DNS相关的问题。OpenClaw在处理这些服务的multipart请求时，用了pinned DNS，但配置有问题。

踩坑经历：我有个项目需要批量处理会议录音转文字。那段时间，我只能手动把音频文件上传到各个平台的原生界面，再复制结果回来——效率低到想哭。

修复效果：现在三家的语音转文字功能都恢复了。实测下来，转录准确率和速度都正常了。

坑三：macOS语音模式要授权两次

问题描述：在macOS上首次开启Talk Mode时，系统会弹出麦克风权限请求。授权后，你以为可以用了？不，还需要再点一次"开启"按钮。

用户体验：极其割裂。用户会想："我明明授权了，为什么还要再点一次？是不是哪里出问题了？"

踩坑经历：我教过几个朋友用OpenClaw的语音功能。每个人都会问："为什么我授权了还不能说话？"每次都要解释一遍这个bug。

修复效果：现在授权完直接进入语音模式，符合正常人的操作预期。

坑四：子Agent信息泄露

问题描述：在ACP（Agent Control Protocol）父会话里，会看到子Agent的内部运行注释。这些内容本来不应该暴露给用户。

具体表现：比如你让AI写代码，它会显示"正在分析需求"、"正在生成代码结构"、"正在编写具体实现"等内部进度信息。

问题所在：这些信息对用户没有价值，反而干扰了正常的对话流。更重要的是，有些内部信息可能包含敏感内容。

修复效果：现在这些内部进度信息被正确屏蔽了。父会话只看到最终结果，干净清爽。

坑五：Google Veo视频生成直接失败

问题描述：使用Google Veo生成视频时，请求直接失败。错误信息不明确，很难排查。

根本原因：OpenClaw发送了Gemini API不支持的numberOfVideos字段。这个字段在OpenAI的API里是有效的，但在Google的API里不被接受。

踩坑经历：我测试Veo功能时，反复尝试了十几次，每次都失败。最后只能放弃，改用其他视频生成工具。

修复效果：现在Veo生成可以正常跑了。实测生成了一个15秒的视频，效果还不错。

坑六：Ollama模型切换卡顿

问题描述：每次切换Ollama模型，或者刷新模型列表，都要等好几秒。体验很差。

根本原因：OpenClaw每次都会重新请求Ollama的/api/show接口，获取模型的上下文窗口和能力信息。

踩坑经历：我经常在几个模型之间切换测试。每次切换都要等，严重影响了工作效率。

修复效果：现在这些信息做了本地缓存。只要模型没变，就直接读缓存。实测模型切换从3-5秒缩短到几乎瞬时。

坑七：TTS音频回复不持久

问题描述：在网页端使用语音模式时，AI的TTS音频回复不会保存到对话历史。刷新页面就没了。

问题影响：如果你在语音对话中得到了重要信息，想回头查看，发现音频已经消失了。

踩坑经历：我有一次用语音模式讨论技术方案，AI给出了很详细的建议。第二天想回顾时，发现音频全没了，只能凭记忆。

修复效果：现在TTS音频回复会被持久化到对话历史，和文字消息绑定在一起。

坑八：飞书文档评论体验差

问题描述：AI回复飞书文档评论时，不理解文档上下文，回复内容很"通用"。

具体表现：比如文档里在讨论某个具体的技术方案，AI的回复却是"这个问题很好，建议进一步研究"之类的套话。

踩坑经历：我在飞书文档里用OpenClaw辅助技术讨论，结果AI的回复经常偏离主题，需要人工纠正。

修复效果：现在AI能理解文档结构和上下文，回复更精准。还支持表情回应和打字状态反馈，体验更像实时对话。

升级建议

如果你踩过以上任何一个坑，强烈建议升级。

升级命令：

升级后记得：

总结

这次更新虽然标着beta，但bug修复的质量很高。很多都是"卡死级"的问题——不修就用不了的那种。

从踩坑的角度看，这次更新解决了：

• ▶登录问题：Codex登录失败
• ▶功能问题：音频转录、Veo视频生成
• ▶体验问题：macOS语音授权、Ollama卡顿、TTS不持久
• ▶安全隐私：子Agent信息泄露

如果你还在忍受这些bug，现在是时候升级了。