阅读时间 20 分钟

OpenClaw 2026 更新汇总(3 月–5 月):每个版本对普通用户有什么用

把 2026.3.1、4.5、4.12、4.22、4.26 和最近一个月的更新合成一篇:不搬 changelog,只讲普通用户能感知的变化、怎么开、有什么坑,以及怎么稳妥升级。

OpenClaw 今年更新太勤了,我前前后后给 2026.3.1、2026.4.5、2026.4.12、2026.4.22、2026.4.26 各写过一篇解读,后来又写了一篇“最近一个月进化”。文章一多,读者反而容易迷路:到底该看哪篇?哪些改动跟自己有关?所以干脆把它们合并成这一页。这里不搬 changelog,只挑对普通用户真正有感知的变化:新了什么、怎么开、有什么坑。完整教程导航见 OpenClaw 中文教程合集。

先说结论:这三个月最值得知道的 7 件事

没空往下看的话,记住这几条就够了:

  1. Claude 4.6 默认开 adaptive thinking(2026.3.1):复杂问题回答质量明显好了,但 token 消耗也涨了,按量付费的要注意账单,不想要可以 /thinking off。
  2. 心跳轻量模式(2026.3.1):跑定时心跳任务的,加一行 lightContext: true,每次能省几百 token,积少成多。
  3. Dreaming 和 Active Memory(2026.4.5 / 2026.4.12):记忆从“存下来”走到“真的用上”。Dreaming 负责沉淀,Active Memory 负责在回答前主动去捞相关记忆。建议先只在私聊开。
  4. Control UI 有中文了(2026.4.5):一共 12 种语言,跟着系统走,不用额外设置。
  5. /models add(2026.4.22):在聊天里直接加模型,不用重启 Gateway,试模型成本低了一大截。
  6. Claude 导入器 + openclaw migrate(2026.4.26):从 Claude Code / Claude Desktop / Hermes 搬家,不用再全靠手抄,记得永远先 --dry-run。
  7. 插件和配置链大修(贯穿 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、MCP type: "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 stable

OpenClaw 有 stable、beta、dev 三个渠道:主力网关用 stable,想尝鲜先 beta dry-run,dev 别拿来当生产环境。每天靠 Telegram / 飞书干活的,稳定比尝鲜值钱。

升级前后的检查顺序:

  1. openclaw update status:先知道当前版本和更新渠道。
  2. openclaw status:看 gateway、agents、channels 是否正常。
  3. openclaw models status:确认当前模型、fallback、provider 没乱。
  4. 检查 Telegram / 飞书入口。
  5. 有 Claude / Codex / Hermes 历史资产的,再跑 migrate dry-run。
  6. 最后再考虑 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。