> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenClaw 2026 更新汇总（3 月–5 月）：每个版本对普通用户有什么用
- URL: https://tbbbk.com/openclaw-updates-2026/
- Published: 2026-10-22T06:17:47.000Z
- Updated: 2026-10-22T06:17:47.000Z
- Description: 把 2026.3.1、4.5、4.12、4.22、4.26 和最近一个月的更新合成一篇：不搬 changelog，只讲普通用户能感知的变化、怎么开、有什么坑，以及怎么稳妥升级。
- Author: TuBaiBai
- Tags: OpenClaw, 折腾日记

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

## 先说结论：这三个月最值得知道的 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 模型切换指南](https://tbbbk.com/openclaw-model-switch-guide/)。我自己选择保持开启，多花点 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 接入飞书/钉钉完整教程](https://tbbbk.com/openclaw-wechat-dingtalk-feishu-setup/)。
- **MLX speech**：指向更本地化、低延迟的语音交互，对 macOS 用户更有意义，目前还偏实验性质。

### 怎么开 / 怎么用

Active Memory 的具体开法和配置项我单独写过：[OpenClaw Active Memory 是什么？怎么开？](https://tbbbk.com/openclaw-active-memory-guide-2026/)，下面“最近一个月进化”部分也给了最保守的配置。

升级后先跑基础状态检查：

```
openclaw status
openclaw gateway status
openclaw gateway restart
openclaw doctor
```

这几条命令不熟的，补一下 [OpenClaw 启动 / 重启 / 停止命令大全](https://tbbbk.com/openclaw-start-restart-stop-commands-guide-2026/)。然后重点验证：会话是否正常、插件是否正常加载、记忆召回是否自然、飞书消息链路是否顺、最常用的 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 完整指南](https://tbbbk.com/openclaw-cli-commands-guide/)。

### 坑点

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 彻底卸载 + 全新安装教程](https://tbbbk.com/openclaw-reinstall-clean-guide/)。

我给新手的顺序一直没变：先把 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 中文教程合集](https://tbbbk.com/openclaw-guide/)。

## 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。