夜雨聆风点击上方蓝字
关注我们
大家好，我是阿伟。
昨天晚上十点多，阿伟本来已经准备关电脑睡觉了。习惯性地瞄了一眼GitHub通知——OpenClaw发了新版，2026.3.28。
说来惭愧，阿伟的龙虾还停在3.13。中间十五个版本，一个都没更新。不是不想升，是之前看3.22那次大改，Breaking Changes一堆，怕升完炸了还得花时间修。就一直拖着。
但是这次3.28的Release Notes阿伟点进去一看——70多个贡献者、将近80条改动、xAI搜索直接内置、插件加了审批机制、一堆老Bug终于修了。阿伟看完的感觉就俩字：炸裂。
忍不了了。打开终端，SSH连上我的腾讯云Ubuntu小鸡，敲了一行：
openclaw update
飞书插件先跑了一遍注册，然后开始正式更新。进度条跑了大概一分半钟，84.6秒包管理器更新，加上6.5秒的doctor自检。最后蹦出来：
Update Result: OKBefore: 2026.3.13After: 2026.3.28
紧接着微信插件 @tencent-weixin/openclaw-weixin 也自动拉了2.1.1的新版本下来。然后龙虾自己重启了Gateway，终端最后一行打了句话：
Fresh code, same lobster. Miss me?
阿伟看到这句的时候笑了一下。龙虾还挺会撩。
跑了一下 openclaw gateway status，一切正常：systemd启着，RPC probe: ok，端口18789在监听。
升级这块算是顺利过关了。那阿伟拖着没升的这段时间，龙虾到底都更新了些什么？Release Notes阿伟从头到尾读了一遍，下面把重点掰开给大家看。
阿伟摸鱼这段时间，龙虾到底经历了什么
先说背景。阿伟之前停在3.13，中间最大的一次变动是3.22。那个版本是OpenClaw今年的一次架构大改，光Breaking Changes就有12条。插件系统整个换了SDK、Chrome浏览器扩展的老方案被砍了、连环境变量的前缀都从以前的 CLAWDBOT_* 统一改成了 OPENCLAW_*。3.22等于把龙虾的骨架拆了重组了一遍。
而3.28是在3.22基础上的第一个大功能版本。这次70多个贡献者一起提交了代码。Release Notes翻到底的时候，阿伟数了一下，改动加起来有将近80条。
这次Breaking Changes不多，但踩到了会很疼。
Qwen的portal-auth认证直接被砍了。 之前用 portal.qwen.ai 的OAuth接入方式，一升级就废了。官方给的迁移方案是跑一行：
openclaw onboard --auth-choice modelstudio-api-key
改走阿里云灵积的API Key。阿伟自己没有用Qwen接OpenClaw，所以没踩到。但如果你在用，升级前一定先看看这个，别升完了才发现模型调不动。
还有一个容易忽略的——Config Doctor不再帮你迁移两个月前的旧配置了。以前配置文件里有些老字段，Doctor会默默帮你改好。现在它不管了，超龄的旧配置直接报验证失败。跟阿伟一样隔了很久没升级的朋友，升完之后跑一遍 openclaw doctor --fix，这步不能省。
龙虾学会上网搜了
这个是阿伟觉得3.28里最值得说的新功能。
以前龙虾要搜网上的东西，你得自己配Tavily或者Firecrawl之类的第三方搜索插件。配起来还挺麻烦的，要申请API Key、写配置、有时候还得调代理。
3.28直接把xAI的Grok搜索能力内置进来了。你只要有xAI的API Key，龙虾就能用Grok帮你搜网页。更厉害的是还加了一个 x_search 工具，能直接搜X（就是以前的Twitter）上面的帖子，连转发数、回复数、收藏数这些指标都能拉回来。
设置也变简单了。在 openclaw onboard 或者 openclaw configure --section web 的时候，流程里会自动问你要不要启用Grok搜索和x_search。选了之后填一个 XAI_API_KEY 就行，xAI的模型provider和搜索工具共用同一个Key。
而且这次还做了一个阿伟觉得很贴心的事：如果你之前已经配了xAI的Key和web search工具，升级之后xAI的插件会自动启用，不用你再手动去 plugins.allow 里面加一行。以前每次加个新插件都要去改配置文件，这次终于不用了。
还有几个阿伟觉得挺实用的
对了，除了xAI搜索，还有几个东西阿伟顺手记下来了。
apply_patch默认开了。 这个工具之前一直处于实验状态，想用得自己手动在配置里打开。它干的事情是让OpenAI和Codex模型能一次性改多个文件——不用一个文件一个文件地edit，直接打一个patch包过去。3.28之后对OpenAI系列模型默认启用了。阿伟还没实际测过效果怎么样，但理论上批量改文件的时候应该会快不少。
MiniMax能画图了。 加了一个 image-01 模型的图片生成Provider。能从文字生成图片，也能拿一张图片做基础去编辑，还支持调宽高比。不过同时MiniMax也砍了一堆老模型——M2、M2.1、M2.5、VL-01全删了，只留了M2.7。如果你之前用MiniMax的老模型跑推理，升级之后可能会报模型找不到。
插件有了"审批"机制。 这个是给插件开发者用的，但对普通用户也有好处。以前龙虾调工具的时候是直接执行，你都来不及拦。3.28给 before_tool_call 钩子加了一个 requireApproval，插件可以在龙虾执行某个操作之前弹个确认框——Telegram上是按钮、Discord上是交互消息、CLI里是命令行提示。相当于给龙虾加了道保险。
Podman容器部署简化了。 以前用Podman跑OpenClaw还要创建一个专门的 openclaw 系统用户，现在直接用当前用户的rootless模式就行了，还加了个 openclaw --container <name> 的命令能直接在宿主机上操控容器内的龙虾。Docker用户也有个好消息：openclaw gateway install --force 现在能正确刷新systemd的unit文件了，之前小内存机器上这个命令经常卡死。
修Bug这块，龙虾真的欠了不少债
阿伟翻了一下3.28的Bug修复列表，大概有三十多条。这里挑几个用户感知最强的说。
WhatsApp的无限回声终于修了。 这个Bug有多离谱呢？你在WhatsApp的自聊模式（就是给自己发消息那种场景）里跟龙虾对话，龙虾回复的消息会被当成新的用户消息重新处理，然后龙虾又回复一条，又被当成用户消息……无限循环，直到你手动停掉。这个问题在 GitHub Issue #54570 里有人报过，终于在3.28里修了。
Telegram消息被切成半截。 以前Telegram发长消息的时候，拆分算法用的是一个估算的比例来决定在哪里切。结果有时候切到词的正中间，英文单词劈成两半，中文句子断在奇怪的位置。3.28换成了真实HTML长度来找切分点，按词边界拆。如果一条消息里标签太多导致长度超限，也有兜底处理了。
Gemini 3.1的模型解析修了。 之前如果你用 google/gemini-3.1-pro 或者 google/gemini-3.1-flash-lite 这类写法，Google的Provider有时候解析不出来是哪个模型。3.28修了Provider ID的传递逻辑，还修了flash-lite的前缀排序问题。用Gemini的朋友升级之后应该会发现模型切换稳定了。
Anthropic崩溃恢复。 之前Anthropic返回一些非常规的stop原因（比如 sensitive，就是内容敏感被截断了），OpenClaw会直接崩掉，整个Agent run都挂了。3.28把这类情况包了一层错误处理，不至于一个敏感回复把整个对话搞死。
其他还有Discord重连修复、iMessage不再泄露 [[reply_to:...]] 标签到消息正文里、Mistral的422错误修复、Control UI的敏感配置默认隐藏等等。细碎的修复很多，就不一一列了。反正阿伟翻完这堆Fix的感觉就是——你们早干嘛去了。
升之前，先看看别人踩过的坑
阿伟这次升级算是顺利的。但阿伟在动手之前搜了不少别人踩坑的帖子，有些挺吓人的。下面这些全部来自公开资料，不是阿伟自己的经历，出处都标了。
小内存服务器升级卡死这个最常见。有位博主在阿里云1核1G小鸡上跑 openclaw update，npm跑完了，Gateway纹丝不动。查了半天才发现是构建过程中内存不够OOM了，但终端没报任何错。解决方案是手动跑 openclaw gateway install --force 刷新systemd文件，再 openclaw gateway restart。（来源：80AJ博客）
飞书插件丢了。 有人之前是手动把飞书插件文件丢到目录里的。一升级路径就没了，龙虾直接不认飞书了。重新用 openclaw plugins install @openclaw/feishu 装一遍就好。这种事说白了就是一开始没走正规渠道。（来源：脚本之家）
升级之后CLI连不上Gateway、报 missing scope: operator.read 的也有人碰到。跟3.22改了Control UI认证逻辑有关系。跑 openclaw doctor --fix 能修。（来源：主机格调）
3.22那次大改还导致过Dashboard直接白屏——npm打包漏了 dist/control-ui/ 目录。从3.13直接跳到3.22的用户最容易中招。好消息是3.28已经修了，所以现在升直接升到3.28反而比卡在3.22安全。（来源：DEV Community）
还有一个比较疼的：第三方插件直接挂掉。3.22把插件导入路径从 openclaw/extension-api 全换成了 openclaw/plugin-sdk/*，不给兼容层。你装的第三方插件如果还没适配新SDK，升完就用不了了。这个只能等插件作者更新，你自己修不了。（来源：BSWEN）
所以阿伟真心建议：升级前先把 ~/.openclaw 整个目录备份一份。 一行命令的事，真出了问题至少能回退。
阿伟的升级流程，给你抄作业
阿伟自己的升级流程贴出来，照着做就行。
先跑升级：
openclaw update
Docker或Podman用户走容器内命令。阿伟是npm全局装的，直接 openclaw update 就行。
升完之后，这步不能跳过——跑一遍Doctor：
openclaw doctor --fix
特别是你跟阿伟一样隔了好几个版本没升的。中间有些配置字段改了名字，结构也变了，Doctor会帮你自动修。阿伟升级的时候它自动跑了doctor checks，6.5秒跑完，没报错。
然后看一眼Gateway：
openclaw gateway status
看到 Runtime: running、RPC probe: ok 就没问题。挂了的话 openclaw gateway restart 拉起来。
用Qwen的朋友多一步——之前走 qwen-portal-auth 的记得迁移：
openclaw onboard --auth-choice modelstudio-api-key
不迁的话Qwen模型调用直接废掉。
这次3.28的Release Notes阿伟前前后后读了差不多一个小时。说实话还没来得及一个个去试新功能，只是完成了升级，确认Gateway能正常跑起来。
但就光看Release Notes的内容量，阿伟觉得这次没忍住是对的。拖了十五个版本，中间3.22把架构翻了一遍，3.28又塞了一堆新东西进来。xAI搜索集成、插件审批机制、apply_patch默认开启，这几个阿伟后面有空会一个个试，有意思的再单独写。三十多条Bug修复就不多说了，WhatsApp和Telegram的问题修了总归是好事。
但阿伟也不装。搜了一圈社区帖子，这段时间升级翻车的人不在少数。特别是3.22那次大改，插件SDK换了、环境变量换了、浏览器扩展砍了，一堆东西一起变。跟阿伟一样拖了很久没升的朋友，升之前一定要备份，升完一定跑Doctor。别嫌麻烦。
龙虾的更新频率今年明显快了，三月份到现在已经出了好几个版本。跟着大版本走就行，beta的不建议追。
看到这里的都是真爱粉。阿伟还没来得及深度体验3.28的新功能，后面试了有意思的再写。碰到问题的朋友通过公众号找阿伟，阿伟帮你看。
觉得有用的话，帮阿伟点个在看或者转发，让更多用龙虾的朋友看到。
分享，点赞，在看
都在这儿，点我不香吗？
