龙虾文档

主题

今天更新

更新日志 ​

本页汇总 OpenClaw 2026.3 ～ 2026.4 主要版本的新特性与重要修复，供中文用户对照升级。

官方完整发布记录见 GitHub Releases。

版本时间线 ​

版本发布日期主题亮点
2026.4.52026-04-06视频/音乐生成工具、ComfyUI 工作流、Dreaming 记忆、12 语言 UI
2026.4.22026-04-02Task Flow 子系统、before_agent_reply Hook、Android 助手入口
2026.4.12026-04-01聊天原生 /tasks 面板、SearXNG、Bedrock Guardrails、macOS 语音唤醒
2026.3.312026-03-31后台任务统一控制面、QQ Bot 内置、Matrix 流式草稿、Slack 原生审批

升级提示

每次升级先跑一遍 openclaw doctor --fix，它会自动把旧版配置迁移到新的标准路径，避免启动校验失败。

2026.4.5 ​

核心新特性 ​

视频与音乐生成工具 ​

  • 新增内置工具 video_generate：Agent 可直接调用，在回复中返回生成好的视频文件。内置支持 xAI grok-imagine-video、阿里云百炼 Wan、Runway 三家 Provider，并自带实测与默认模型映射。
  • 新增内置工具 music_generate：支持 Google Lyria、MiniMax 直连，加上通过 Comfy 工作流驱动的本地生成。支持异步任务跟踪，任务完成后自动把音频投递回对话。
  • 对于 Lyria 这类提供商，不支持的可选参数（例如 durationSeconds）会给 warning 而不是直接失败。

ComfyUI 工作流集成 ​

新增内置 comfy 工作流媒体插件，同时支持本地 ComfyUI 与 Comfy Cloud：

  • 一套工作流同时承载 image_generate、video_generate、music_generate
  • 支持提示词注入、可选的参考图上传、实测连通性检查、产物自动下载

新增 Provider 与集成 ​

Provider类型说明
Qwen聊天阿里通义千问内置 Provider
Fireworks AI聊天开源模型推理平台
StepFun（阶跃星辰）聊天国产模型，部分免费
MiniMax TTS语音MiniMax 文字转语音
MiniMax Search搜索MiniMax 搜索集成
Ollama Web Search搜索本地 Ollama 搜索
  • Amazon Bedrock 强化：内置 Mantle 支持 + 推理 Profile 自动发现 + 自动注入请求区域，让 Bedrock 上托管的 Claude、GPT-OSS、Qwen、Kimi、GLM 等路由几乎零配置。
  • Bedrock 记忆向量库：新增 Titan、Cohere、Nova、TwelveLabs Embedding 支持；provider: "auto" 可基于 AWS 凭证链自动发现，并按 Provider 控制向量维度。
  • 视频 Provider 三件套：xAI grok-imagine-video、Alibaba Model Studio Wan、Runway。

Dreaming 记忆系统 ​

全新实验性的 Dreaming（做梦） 长期记忆机制上线，详见 记忆系统：

  • 三阶段协作：浅睡（light）→ 深睡（deep）→ REM，每个阶段独立调度、可单独恢复
  • 加权的短期记忆晋升、/dreaming 命令、Dreams UI、多语言概念标签
  • 新配置项 recencyHalfLifeDays、maxAgeDays 调节衰减窗口
  • 新增 openclaw memory rem-harness、promote-explain 工具用于调试 REM 阶段
  • Dream Diary 面板在 Dreams 中直接呈现；dreams.md 独立于日常记忆存在，避免污染默认召回

Control UI 本地化 ​

Control UI 新增 12 种语言：简体中文、繁體中文、Português（Brasil）、Deutsch、Español、日本語、한국어、Français、Türkçe、Bahasa Indonesia、Polski、Українська。

Skills & 插件体验 ​

  • Skills 面板直接集成 ClawHub 搜索、详情、安装流程，不用再跳到 CLI
  • 引导式 onboarding 新增插件配置 TUI
  • 新增 openclaw plugins install --force，可以直接覆盖已存在的插件 / hook-pack，而不需要 dangerous-code 开关

执行审批的多端扩展 ​

  • iOS 执行审批：通过 APNs 推送通知，点开进入原生审批弹窗，审批结果解析后同步清理陈旧通知状态
  • Matrix 执行审批：原生提示、账户绑定审批人、DM 或群聊投递、房间 / Thread 级解析

Agents / Claude CLI 深度集成 ​

  • OpenClaw 工具通过 loopback MCP 桥接暴露给后台 Claude CLI 运行
  • 捆绑 Claude CLI 运行改用 stdin + stream-json 的流式片段，长回复能看到实时进度
  • 移除了传统的 Claude CLI backend 与 setup-token 作为新用户引导方式；老配置仍可运行，openclaw doctor 可迁移老状态

其他体验改进 ​

  • 渠道级 contextVisibility：可配置 all / allowlist / allowlist_quote 控制引用、Thread、历史上下文是否按发送人白名单过滤
  • Provider 请求覆盖：OpenAI / Anthropic / Google 及兼容路径统一支持 headers、auth、proxy、TLS 控制
  • OpenAI GPT：前向兼容 openai-codex/gpt-5.4-mini、默认低啰嗦 verbosity、工具执行中有可见进度
  • Prompt 缓存：工作区上下文稳定前缀、HEARTBEAT.md 保留在缓存边界之下、Vertex AI cacheRetention: "long" 真正走 1 小时 TTL
  • Lobster 插件：捆绑 Lobster 工作流直接进程内运行，不再 spawn 外部 CLI

破坏性变更 ​

  • 配置规范化：移除一批遗留别名，包括 talk.voiceId / talk.apiKey、agents.*.sandbox.perSession、browser.ssrfPolicy.allowPrivateNetwork、hooks.internal.handlers、渠道/群组/房间的 allow 字段等。正确路径是标准 public path + enabled 字段。
  • 加载期保留兼容层，跑一次 openclaw doctor --fix 会把旧字段自动迁移。

关键修复（节选） ​

  • 安全收紧：/allowlist add/remove 要求 owner 权限；before_tool_call Hook 崩溃时 fail-closed；浏览器 SSRF 重定向被更早拦下
  • Telegram：DM 语音条转录恢复；模型切换菜单、Topic 回复、重启后的反应所有权等一系列修复
  • Discord：REST/webhook/monitor 走配置代理；@everyone/@here 按开关生效；replyToOnlyWhenBatched 改名为 replyToMode: "batched"；默认媒体上限抬到 100 MB
  • Matrix：秘密存储丢失时的恢复、transports pin、channels.matrix.dm.sessionScope 让不同 DM 房间保留独立上下文
  • Voice / Talk Mode：Android Talk Mode 的播放取消、节点会话恢复、网关会话恢复三条链路都修好了
  • Gateway macOS launchd：KeepAlive 在进程内重启时的交接；已安装未加载的 LaunchAgent 自动恢复

2026.4.2 ​

核心新特性 ​

  • Task Flow 子系统：恢复核心 Task Flow 底座，支持 managed / mirrored 同步模式、持久化 flow 状态、新增 openclaw flows 巡检与恢复命令；支持 managed 子任务派生 + sticky cancel intent
  • Android 助手入口：加入 assistant 角色入口 + Google Assistant App Actions metadata，Android 可以从助手触发 OpenClaw 并把 prompt 交给聊天框
  • 新 Hook：before_agent_reply：插件可以在 LLM 调用前短路并返回合成回复，非常适合快速响应规则命中的场景
  • Exec 默认 YOLO：Gateway / 节点的宿主执行默认 security=full + ask=off，对应文档与 doctor 报告一并对齐
  • 飞书云文档评论工作流：专用 Drive comment-event 流程，支持评论线程上下文解析、线程内回复、feishu_drive 评论动作
  • Matrix 规范化提及：所有文本 / 媒体 caption / 编辑 / 投票 fallback / 动作驱动编辑都发送 m.mentions 元数据，Element 等客户端能可靠收到通知
  • agents.defaults.compaction.notifyUser：把 🧹 Compacting context... 开场提示改为可选，默认不打扰

破坏性变更 ​

  • xAI x_search：从核心 tools.web.x_search.* 迁到插件所属 plugins.entries.xai.config.xSearch.*；auth 统一到 plugins.entries.xai.config.webSearch.apiKey / XAI_API_KEY
  • Firecrawl web_fetch：从 tools.web.fetch.firecrawl.* 迁到 plugins.entries.firecrawl.config.webFetch.*，web_fetch 回退经由新的 fetch-provider 边界

两项都可以用 openclaw doctor --fix 自动迁移。

关键修复 ​

  • Providers 传输策略统一：所有 HTTP / stream / websocket 路径共用请求 auth、proxy、TLS、header 形塑；禁止不安全 TLS 覆盖
  • Anthropic 路由中 service_tier 原生识别收紧，假/代理主机不再继承 native 默认
  • Exec approvals：allow-always 改为持久信任；Windows 包装路径与畸形 path 条件 fail-closed
  • QQ Bot / Slack / Mattermost 多项审批与路由修复

2026.4.1 ​

核心新特性 ​

  • 聊天原生 /tasks 面板：当前会话的后台任务板，显示最近任务详情；无 linked task 时回退为 Agent 本地计数
  • SearXNG Provider：新增捆绑的 web_search 插件，可配置任意 SearXNG 实例
  • Amazon Bedrock Guardrails：内置 Provider 支持 Guardrails 参数
  • macOS 语音唤醒：新增 Voice Wake 选项，可直接唤起 Talk Mode
  • 全局默认 Provider 参数：新增 agents.defaults.params，所有 Agent 统一默认
  • 失败重试策略：Rate limit 时同一 Provider 内的 auth-profile 切换次数可封顶；新增 auth.cooldowns.rateLimitedProfileRotations
  • Cron 工具白名单：openclaw cron --tools 为每个定时任务单独配置工具白名单
  • Telegram errorPolicy / errorCooldownMs：按账户、聊天、话题抑制重复投递错误
  • Z.AI：glm-5.1 与 glm-5v-turbo 加入内置目录

关键修复 ​

  • 聊天侧错误回复脱敏：不再把原始 Provider / runtime 错误泄漏进频道；遇到 Bedrock toolResult/toolUse session mismatch 会提示 /new
  • 任务注册表维护扫描：SQLite 压力大时不再阻塞 gateway 事件循环
  • 模型切换：/model 排队等待当前繁忙回合结束，然后把后续回合切到新模型
  • Exec approvals 生态：allow-always 真正持久化为用户信任；exec-approvals.json 安全默认在无 inline / session 策略时生效

2026.3.31 ​

核心新特性 ​

  • 后台任务统一控制面：把 ACP / subagent / cron / 后台 CLI 执行统一到一张 SQLite ledger 下；detach 生命周期经由 executor seam；加入审计 / 巡检 / 状态可见性，且自动清理和 lost-run 恢复更稳
  • Task Flow 第一版：新增 openclaw flows list|show|cancel，把手动多任务 flow 与单任务自动 sync flow 分开管理
  • QQ Bot 成为捆绑 Channel：多账号、SecretRef credential、slash 命令、提醒、媒体收发完整支持，正式成为 Channel 生态一员
  • LINE 出站媒体：在 LINE 专属投递路径上新增图片、视频、音频出站，视频还有 explicit preview/tracking
  • Matrix 三件套：
    • channels.matrix.historyLimit 支持可选房间历史上下文（每 Agent 独立 watermark）
    • channels.matrix.proxy 显式 HTTP(S) 代理配置
    • Draft streaming：Matrix 部分回复在同一条消息里原地更新
    • threadReplies 按 DM 细粒度覆盖
  • MCP 远程传输：mcp.servers 支持远程 HTTP/SSE Server（含 auth headers、安全重打码）
  • Slack 原生执行审批：审批提示留在 Slack 内，不再 fallback 到 Web UI 或终端
  • WhatsApp 反应：Agent 可以对消息直接回 emoji，而不是必须打字回复
  • OpenAI Responses text.verbosity：跨 HTTP/WS 传输统一生效，/status 可见
  • Pi + Codex：嵌入 Pi 运行支持 native Codex 网页搜索，配置 / 文档 / 向导齐备

破坏性变更 ​

  • 移除 nodes.run 包装：节点 shell 执行一律走 exec host=node；节点特有能力留在 nodes invoke 和专用 media/location/notify action 上
  • Plugin SDK 老兼容路径弃用：老的 provider 兼容子路径与 bundled provider / channel-runtime 兼容 shim 发出迁移警告（未来主版本会删）
  • 插件/技能安装安全默认 fail-closed：内建 dangerous-code critical 问题和安装期扫描失败默认阻断，需 --dangerously-force-unsafe-install 显式覆盖
  • Gateway auth 收紧：trusted-proxy 拒绝混合 shared-token 配置；local-direct fallback 要求显式 token
  • 节点命令需等待 pairing 审批，仅配对已不足以暴露节点命令

关键修复 ​

  • Nostr 入站 DM：配对 / 发送授权前先校验事件签名，伪造 DM 无法触发副作用
  • Gateway 态：inbound 大图片不再把 media:// 记号漏进纯文本会话；附件顺序保留；模型图像能力无法解析时 fail-closed
  • Discord 语音：加入语音频道前继续执行 guild channel + 成员白名单校验
  • Exec 环境：屏蔽 proxy、TLS、Docker endpoint 环境变量覆盖、Python 包索引覆盖，请求级命令无法重路由出站流量
  • Feishu：quoted replies 与 topic bootstrap 继续遵守群发送人 allowlist

升级建议 ​

  1. 备份配置：升级前先复制一份 ~/.openclaw/openclaw.json
  2. 跑 doctor：openclaw doctor --fix 自动迁移遗留字段（2026.4.5 / 2026.4.2 / 2026.3.31 都有 breaking 变更）
  3. 检查 exec 与 approvals：如果依赖 tools.exec、exec-approvals.json、nodes.run 的旧约束，需要人工复核
  4. plugin 安全策略：2026.3.31 之后 dangerous-code 默认 fail-closed，必要时显式加 --dangerously-force-unsafe-install
  5. 体验新能力：按需启用 video_generate、music_generate、Dreaming、Task Flow 等新系统

相关资源 ​

最后更新于:

觉得有帮助？