OpenClaw 2026 更新汇总(3 月–5 月):每个版本对普通用户有什么用
OpenClaw 今年更新太勤了,我前前后后给 2026.3.1、2026.4.5、2026.4.12、2026.4.22、2026.4.26 各写过一篇解读,后来又写了一篇“最近一个月进化”。文章一多,读者反而容易迷路:到底该看哪篇?哪些改动跟自己有关?所以干脆把它们合并成这一页。这里不搬 changelog,只挑对普通用户真正有感知的变化:新了什么、怎么开、有什么坑。完整教程导航见 OpenClaw 中文教程合集。
先说结论:这三个月最值得知道的 7 件事
没空往下看的话,记住这几条就够了:
- Claude 4.6 默认开 adaptive thinking(2026.3.1):复杂问题回答质量明显好了,但 token 消耗也涨了,按量付费的要注意账单,不想要可以
/thinking off。 - 心跳轻量模式(2026.3.1):跑定时心跳任务的,加一行
lightContext: true,每次能省几百 token,积少成多。 - Dreaming 和 Active Memory(2026.4.5 / 2026.4.12):记忆从“存下来”走到“真的用上”。Dreaming 负责沉淀,Active Memory 负责在回答前主动去捞相关记忆。建议先只在私聊开。
- Control UI 有中文了(2026.4.5):一共 12 种语言,跟着系统走,不用额外设置。
/models add(2026.4.22):在聊天里直接加模型,不用重启 Gateway,试模型成本低了一大截。- Claude 导入器 +
openclaw migrate(2026.4.26):从 Claude Code / Claude Desktop / Hermes 搬家,不用再全靠手抄,记得永远先--dry-run。 - 插件和配置链大修(贯穿 4 月):坏插件不再把整个 Gateway 带走,
openclaw doctor --fix能隔离坏插件配置,插件加载也快了不少。
另外一个提醒:2026.4.5 移掉了一批旧配置别名,属于 breaking change,从老版本直接跳上来的,openclaw doctor --fix 一定要跑。
一张表看懂:各版本关键更新
| 版本 | 更像什么 | 普通用户最该关注 | 要注意的坑 |
|---|---|---|---|
| 2026.3.1 | 体验大改版 | Claude 4.6 默认 adaptive thinking、Telegram DM 话题、心跳轻量模式、Discord 线程活跃度超时 | token 消耗涨约两成(我自己的估算) |
| 2026.4.5 | 能力扩张型 | 视频/音乐生成内置、Dreaming 记忆、Control UI 中文、Qwen 等 bundled provider | 移除一批 legacy 配置别名,需 doctor --fix |
| 2026.4.12 | 稳定可用型 | Active Memory、插件加载改进、Feishu 增强、MLX speech(实验) | MLX speech 还偏实验,别当成熟卖点 |
| 2026.4.22 | 低摩擦转折点 | xAI 图像/TTS/STT、腾讯 Hy3、/models add、首次配置自动装插件、TUI 本地模式 | xAI、腾讯都要自己的 key 和账号 |
| 2026.4.26 | 迁移 + 工程稳定 | Claude 导入器、openclaw migrate、实时语音链路、Cerebras、Memory Search 增强、插件 degraded mode | 迁移先 dry-run,别一把 apply |
2026.3.1:Claude 默认开推理、Telegram 话题、心跳省 token
升级这事我一般不急,但 3.1 放出来我当天就升了,因为 Claude 默认开推理这个改动太影响日常体验。这版改动量在当时算大的,功能加 bug 修复有几十条,下面只挑对日常用户影响最大的。
用户能感知到的变化
- Claude 4.6 默认 adaptive thinking:以前推理默认是 low,现在改成 adaptive,模型自己决定要不要深度思考、想多深。我用了两天,简单问题没什么变化,稍复杂的代码分析、方案讨论质量明显上了一个台阶。代价是 token 涨了,我估算对话密集时大概涨两成。
- 推理 fallback 不再报错:配了一个不支持某推理级别的模型,以前直接报错,现在自动降级到 think=off,安静退化。
- Telegram DM Topics:私信里可以开话题分区,每个话题是独立 session。我自己是一个话题跑翻译、一个做代码助手、一个日常闲聊,切话题就像切专属助手,上下文干净多了。
- 心跳轻量模式:开启后心跳只注入 HEARTBEAT.md,跳过 AGENTS.md、USER.md、MEMORY.md 这些 bootstrap 文件。
- Discord 线程不再莫名消失:从 TTL 到期关闭改成活跃度超时,默认 24 小时无操作才关,可以再配 maxAgeHours 加硬上限。
- Gateway 健康检查端点:新增
/health、/healthz、/ready、/readyz,Docker / Kubernetes 用户可以直接接健康检查。 - OpenAI Responses API 默认走 WebSocket,SSE 作为降级备选,我实际感觉流式输出稍微流畅一点,差别不算大。
怎么开 / 怎么用
不想要 adaptive thinking,对话里直接发:
/thinking off也可以在配置文件里加对应关闭选项,给不同 agent 设不同推理级别的写法见 OpenClaw 模型切换指南。我自己选择保持开启,多花点 token 换更靠谱的回答,值;主要做轻量闲聊的可以关掉省钱。
心跳轻量模式:用 --light-context 参数,或在对应 agent 的心跳配置(agents.*.heartbeat.lightContext)里加一行:
lightContext: true我算过,一个简单心跳任务每次大概省三四百 token,心跳频繁的话一天能省几万。
Telegram 话题支持 allowlist、dmPolicy、skills、systemPrompt、requireTopic 这些选项。requireTopic 很适合多人共用:强制必须进某个话题才能发消息,管理清楚很多。Discord 线程可以用 /session idle 和 /session max-age 实时查看和调整超时。
顺手修掉的几个坑
- NO_REPLY 内部控制标记泄露给用户的问题修了,现在自动过滤。
- Telegram 长消息分块时每段都带引用和按钮的问题修了,现在只有第一段带(社区 xdanger 提的修复)。
- Docker 跑 Ollama 时配了 baseUrl 还去连 localhost 的问题修了。我自己就用 Docker 跑 Ollama 做本地向量检索,升级前偶尔会碰到。
- Cron 设置
delivery.mode: none后仍然发通知的问题修了,none 就是真的 none。 - Web 控制台 cron 页面小屏能正常滚动了,还加了中文本地化。
坑点
最大的坑就是账单:很多人可能不知道推理默认开启后 token 涨了,月底才发现。按量付费的用户升级后先想清楚要不要关。
2026.4.5:视频/音乐生成内置、Dreaming 记忆、Control UI 中文
这一版不是小修,几个大功能一次打包出来,属于“能力扩张型”更新。
用户能感知到的变化
- video_generate 和 music_generate 内置:不用单独装插件。视频生成走你配置的 provider,结果直接在回复里返回;音乐生成支持 Google Lyria 和 MiniMax,异步生成,完成后单独发给你。
- ComfyUI bundled 插件(comfy):本地 ComfyUI 和 Comfy Cloud 都支持,image_generate、video_generate、music_generate 三个工具都能走 ComfyUI workflow,还支持 prompt injection 和参考图上传。
- Dreaming 记忆机制:开启后会把对话里值得长期记住的内容整理进 MEMORY.md,同时生成 dreams.md 记录整理过程,Control UI 里还有 Dream Diary 界面可以看。用户侧只有两个选项:enabled 和 frequency。
- Control UI 多语言:简体中文、繁体中文、日语、韩语、德语、西班牙语、法语、土耳其语、印尼语、波兰语、乌克兰语、巴西葡萄牙语,共 12 种,跟着系统语言走。
- 更多 bundled provider:Qwen、Fireworks AI、StepFun 直接内置,配好 key 就能用;Bedrock 加了 Mantle 支持,区域路由自动处理。
- ClawHub 进 Skills 面板:可以直接在面板里搜索、查看、安装技能,不用切浏览器。
- iOS 原生 APNs 审批通知:要执行敏感操作时推送到手机,点开就能批准或拒绝。
怎么开 / 怎么用
Dreaming 在配置里把 memory.dreaming.enabled 设成 true,frequency 先用默认值:
memory:
dreaming:
enabled: true升完用 /status 确认模型配置没问题,用 /tools 看 video_generate 和 music_generate 有没有出现在工具列表里。
坑点
- Breaking change:移掉了一批 legacy config alias,包括
talk.voiceId、talk.apiKey、agents.*.sandbox.perSession、browser.ssrfPolicy.allowPrivateNetwork、hooks.internal.handlers,以及各 channel/group/room 下的 allow 字段。手写过这些的,升完可能报错,跑openclaw doctor --fix一般能解决大部分,还有红色报错就按提示逐条处理。 - 视频/音乐生成需要你自己配好对应 provider 的 API key,没 key 工具装好了也跑不起来;调外部服务,等几十秒很正常。
- ComfyUI 那条路需要你自己有跑起来的实例,不是开箱即用。
- Dreaming 被传得比较玄,实际上它能把你反复提到的偏好沉淀下来,但别指望它“完全记住你”,记忆质量跟你的对话质量强相关。
2026.4.12:Active Memory、插件加载、Feishu 增强
如果说 4.5 在告诉你“OpenClaw 能做更多事了”,4.12 就是在告诉你“OpenClaw 更值得长期用了”。这版没有花哨新玩具,核心是更稳、更会记。
用户能感知到的变化
- Active Memory:前面的 Dreaming 更像搭记忆基础设施,Active Memory 是让记忆真正参与回答。体感上是跨天任务更容易续上、偏好不用反复解释。比如你昨天在折腾飞书接入,今天接着问,它更有机会接住进度。
- 插件加载改进:针对“Skill 装了但偶尔抽风”“升级后插件突然异常”这类偶发问题。装很多 Skill、接多平台、自己写 Skill 的用户感受最明显。
- Feishu 增强:国内用户在飞书里的接入和使用体验继续改善。对很多人来说飞书才是真正的工作入口,这条链打顺了,OpenClaw 才像每天会用的工具。还没配飞书的看 OpenClaw 接入飞书/钉钉完整教程。
- MLX speech:指向更本地化、低延迟的语音交互,对 macOS 用户更有意义,目前还偏实验性质。
怎么开 / 怎么用
Active Memory 的具体开法和配置项我单独写过:OpenClaw Active Memory 是什么?怎么开?,下面“最近一个月进化”部分也给了最保守的配置。
升级后先跑基础状态检查:
openclaw status
openclaw gateway status
openclaw gateway restart
openclaw doctor这几条命令不熟的,补一下 OpenClaw 启动 / 重启 / 停止命令大全。然后重点验证:会话是否正常、插件是否正常加载、记忆召回是否自然、飞书消息链路是否顺、最常用的 Skill 能不能稳定执行。
坑点
- Active Memory 不是开了就更聪明,它只是让系统更有机会把相关历史接进当前回答。记忆内容本来就乱,它也不会凭空变神。
- MLX speech 别现在就当成熟卖点。Windows / Linux 用户知道方向就行,纯文本工作流的暂时优先级不高。
- 升级顺序很关键:先备份(自定义 Skill、渠道配置、记忆配置、语音 provider 配置、改过的插件加载方式)→ 升级 → 验证主链路 → 再逐项恢复个性化改动,每恢复一项测一次。不要把升级、换配置、加插件、改渠道放在同一轮做,那不是升级,那是给自己制造排错副本。
2026.4.22:xAI 全家桶、腾讯 Hy3、/models add
前面的 4.20 偏基础体验和维护层(onboarding 界面整理、Kimi 默认模型与价格、sessions OOM 防护等),4.21 是小版本过渡。到 4.22 才出现“使用层面能明显感知”的组合更新,我当时的判断是:OpenClaw 正在把“高上限”往“低摩擦”上收。
用户能感知到的变化
- xAI 补成一整套:图像生成(grok-imagine-image、grok-imagine-image-pro)、参考图编辑、TTS、STT、Voice Call 实时转写,语音输出支持 MP3、WAV、PCM、G.711,6 个 xAI voice 可直接用。xAI 从“多一个文本模型”变成“文本 + 图像 + 音频”。
- 腾讯 provider 进官方插件体系:新增 bundled Tencent Cloud provider plugin,带 TokenHub onboarding、文档、hy3-preview 模型目录项和 Hy3 分层价格元数据。国内用户多了一条更像样的路线。
/models add:在聊天里直接注册模型,不用重启 gateway;/models保留为 provider 浏览入口,还补了可复制的命令示例。- 首次配置自动装插件:onboarding 过程中缺 provider 或 channel 插件会自动装,不用中途退出去补,新手少踩一个大坑。
- 诊断导出更完整:默认开启 payload-free stability recording,diagnostics export 包括脱敏日志、status、health、config、stability snapshots,反馈问题更方便。
- TUI local embedded mode:可以在终端跑本地聊天,不必先拉起 Gateway,但插件审批门仍然生效。
- 其他小点:WhatsApp 可配置原生回复引用;
/status新增 Runner 字段,显示会话跑在 embedded Pi、CLI-backed provider 还是 ACP harness 上;非交互 doctor 运行时间官方说下降约 74%;插件加载时间官方说降低 82%–90%。
怎么用
普通用户我建议先试三件事:有语音/图像需求的看看 xAI 这条线;国内用户留意腾讯 / Hy3;有空就试 /models add,这是最不花时间、最容易立刻感受到差别的功能。模型相关的命令速查见 OpenClaw CLI Commands 完整指南。
坑点
xAI 和腾讯都只是官方集成层往前走了,用之前还是得自己有对应账号和 key。TUI 本地模式更适合终端党和想快速试用的人,不是所有读者都需要。
2026.4.26:Claude 导入器、openclaw migrate、实时语音、Cerebras
这版乍一看像修修补补,啃完 release note 才发现方向很清楚:迁移更顺、语音更真能用、插件和 provider 更工程化。
用户能感知到的变化
- 内置 Claude 导入器:可以预览并应用 Claude Code 和 Claude Desktop 里的 instructions、MCP servers、skills、command prompts 等内容。已经把 Claude Code 调教好的人,切过来的心理成本低很多。
openclaw migrate统一迁移入口:包含 plan、dry-run、JSON 输出、迁移前备份、onboarding detection、archive-only report copies,还有 Hermes importer。- 实时语音链路补强:浏览器 realtime transport 做成通用接口;Google Live 浏览器 Talk 会话补了受限临时 token、endpoint 验证、每个浏览器连接的 Gateway relay 会话上限;还给 backend-only 实时语音插件铺了 Gateway relay。
- Cerebras bundled provider:带 onboarding、静态模型目录、文档和 endpoint 元数据。
- Memory Search 增强:
memorySearch.inputType、queryInputType、documentInputType,支持非对称 embedding endpoint、provider batch indexing、Ollama 检索 query 前缀,以及 QMD 多项修复。轻度用户感知不强,认真用本地 embeddings 的有价值。 - 插件和配置链大修:配置 schema 无效时以 degraded mode 启动,
openclaw doctor --fix可以隔离坏插件配置;profile 安装不再误写到默认 profile,安装安全扫描不再误伤 test files,symlink 插件目录支持更完整,重复插件启动时会警告。 - 运行环境小修:slim 镜像补 CA 证书;低内存 Linux / Node 24 前台启动更稳;ALL_PROXY 传递更完整;Windows 绝对路径规范化、Feishu/Lark sidecar 加载修复;Google Meet 媒体权限、
openclaw nodes remove、MCPtype: "http"统一为 streamable-http。
怎么用
迁移命令见下一节“最近一个月进化”里的 migrate 部分,核心原则就一句:先 dry-run 看计划,再 apply。
坑点
当前环境跑得很稳、不需要迁移、也不用语音/插件/memory 这些重度能力的,可以先观望;偏生产的环境更新要谨慎。真遇到坏插件导致起不来,先试 openclaw doctor --fix,别一上来就重装。
最近一个月的进化:站在普通用户角度再看一遍
后来我又写过一篇“最近一个月进化”,不按版本,而是挑普通用户真正该关心的 5 类变化。版本细节上面讲过了,这里只补那篇里新增的实操内容和判断。
1. Active Memory:先只开私聊
说人话,Active Memory 就是在主模型正式回答前,先派一个受限的记忆子 Agent 去查有没有相关旧记忆。好处是不用你提醒;坑是越主动越容易越界,最典型的就是群聊里把你私聊说过的偏好顺嘴带出来。官方给了 allowedChatTypes、allowedChatIds、deniedChatIds 这些边界配置,最保守的开法:
{
"plugins": {
"entries": {
"active-memory": {
"enabled": true,
"config": {
"enabled": true,
"agents": ["main"],
"allowedChatTypes": ["direct"],
"queryMode": "recent",
"promptStyle": "balanced",
"timeoutMs": 15000
}
}
}
}
}刚装好还在调模型的先别开;Telegram / 飞书私聊稳定了再开 direct chat;群聊、工作群先别开。另外现在可以用 toolsAllow 指定 recall 工具,兼容 memory-core、memory-lancedb 这类记忆路线,记忆在慢慢变成可替换的一层。
2. 模型管理:不再是配置文件考试
除了 4.22 的 /models add,还有两条我觉得普通用户真用得上的命令:/think default 和 /fast default,把当前 session 的临时 override 清掉,回到配置或 provider 默认值,专治“几天前临时改过、后来忘了”。建议会这几条:
openclaw models status
openclaw models list
openclaw update status聊天里:
/model status
/models
/think default
/fast default先用 /model status 确认自己跑在哪个模型上,再去评价“它今天是不是变笨了”。另外 2026.5.9 beta 里,OpenClaw 会把当前 provider/model identity 注入 system prompt,Agent 更不容易在“我是什么模型”这件事上胡说。
3. openclaw migrate:迁移永远先 dry-run
openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate hermes --dry-run
openclaw migrate apply claude --yes这套流程先扫描、告诉你哪些导入哪些跳过、列出冲突,默认不导入 secrets,apply 前做备份。Claude 这边会处理项目级 CLAUDE.md、用户级 ~/.claude/CLAUDE.md、MCP server、skill 目录,还能把 command Markdown 转成手动调用的 OpenClaw skills;但不会自动执行 Claude hooks,也不会照搬过宽的权限。Codex CLI 适合迁 skills 和部分插件,Hermes 有 SOUL、AGENTS、memory、模型配置的迁移路线。从零开始的新用户暂时不用管。
4. 插件和 Provider:生态变强,新手别乱装
Provider 和插件越来越多信息放进 plugin manifest,新 provider 不必等核心大改,插件出问题也更好单独诊断。常用命令:
openclaw plugins list
openclaw plugins search calendar
openclaw plugins install clawhub:some-plugin
openclaw plugins inspect some-plugin --runtime
openclaw plugins doctor
openclaw plugins update --all安装、inspect 慢的话可以开 trace:
OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 openclaw plugins doctor但我还是要泼冷水:插件是代码,能扩展能力也能扩大风险面。官方 bundled 的按需启用;ClawHub 里维护积极的一次只装一两个;来路不明的 npm/git 插件新手别碰;要高权限的先看代码。
5. Telegram、飞书、Docker、诊断:不起眼但决定能不能长期用
- Telegram:polling 和临时发送客户端共用 grammY API throttler、forum topics 元数据缓存优化等,长时间运行更不容易因网络、限流、topic 路由卡住。
- 飞书:2026.5.9 beta 里 Telegram/Feishu 会尊重 per-agent 和全局 reasoningDefault,决定推理预览是 stream 还是 hidden,两个渠道表现更一致。
- Docker:slim 镜像装了 CA 证书,runtime 镜像用 tini 回收孤儿进程并转发信号,VPS、NAS、1Panel 场景更稳。
- 诊断:CLI 报错开始更强调“下一步该怎么恢复”,会指向下一条恢复命令。bot 没反应时先看状态,别一上来就重装,实在要重装看 OpenClaw 彻底卸载 + 全新安装教程。
我给新手的顺序一直没变:先把 Gateway 跑稳 → 再把模型弄明白 → 再接 Telegram/飞书 → 最后再碰记忆和插件。真正要练的是“少装、慢开、会排错”。
怎么升级
下面的命令都来自前面几篇原文,按场景选:
最简单的方式(3.1 那篇用的):
npm install -g openclaw
openclaw gateway restart
openclaw --version跨版本升级、尤其是从 4.5 之前跳上来(推荐):
openclaw doctor --backup # 先备份
openclaw update # 升级
openclaw doctor --fix # 自动迁移旧配置
openclaw gateway restart想先看看会发生什么、或者切更新渠道:
openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --channel stableOpenClaw 有 stable、beta、dev 三个渠道:主力网关用 stable,想尝鲜先 beta dry-run,dev 别拿来当生产环境。每天靠 Telegram / 飞书干活的,稳定比尝鲜值钱。
升级前后的检查顺序:
openclaw update status:先知道当前版本和更新渠道。openclaw status:看 gateway、agents、channels 是否正常。openclaw models status:确认当前模型、fallback、provider 没乱。- 检查 Telegram / 飞书入口。
- 有 Claude / Codex / Hermes 历史资产的,再跑 migrate dry-run。
- 最后再考虑 Active Memory 和插件。
另外,升级前养成备份习惯,特别是自定义的 AGENTS.md 和 openclaw.json。一般升级不会覆盖配置,但备份总没错。
后续版本会继续补在这里
以后 OpenClaw 有对普通用户值得一说的新版本,我会直接追加到这一页,不再一版一篇。想看完整教程体系,回 OpenClaw 中文教程合集。
FAQ
升级后 Claude 回答变慢、token 变多了,怎么回事?
大概率是 2026.3.1 起 Claude 4.6 默认开了 adaptive thinking。对话里发 /thinking off 可以关掉;如果是你自己某次临时开过 thinking 后忘了,用 /think default 恢复默认。
Dreaming 和 Active Memory 有什么区别,要都开吗?
Dreaming(4.5)负责把对话里值得记的东西整理进 MEMORY.md;Active Memory(4.12)负责在回答前主动去查相关记忆。都不是“开了就变神”的功能,建议等模型和渠道跑稳后再开,Active Memory 先只开私聊。
升级后配置报错、Gateway 起不来怎么办?
先跑 openclaw doctor --fix。4.5 移除了一批旧配置别名,--fix 会自动迁移;4.26 之后坏插件配置也能被隔离,系统会以 degraded mode 先启动起来。
我从 Claude Code 过来,能直接迁吗?
可以,从 4.26 开始有 Claude 导入器和 openclaw migrate。先跑 openclaw migrate claude --dry-run 看计划,没问题再 openclaw migrate apply claude --yes。默认不导入 secrets,也不会自动执行 Claude hooks。