OpenClaw v2026.4.27 发布：插件体系重构深化，平台集成继续扩展

本次更新对插件 SDK 进行了系统性重构，核心方向是将内部共享逻辑正式暴露为公开 SDK 接口，同时为遗留兼容层设立明确的移除时间窗口。

具体来看，`openclaw/plugin-sdk/channel-route` 已作为独立模块公开，提供了路由标准化、解析器驱动目标解析、原始目标压缩键、解析后目标类型以及路由比较辅助函数等能力。这意味着第三方插件作者不再需要依赖内部实现路径，可直接基于稳定接口构建目标路由逻辑。原有的内部 channel-route shim 已转为兼容别名，标注了计划删除日期。

上下文传递方面新增了通用 host hooks，覆盖会话状态、下一步轮次上下文、受信任工具策略、UI 描述符、事件、调度器清理以及运行作用域插件上下文等七个维度（#72287）。此前插件在运行时获取上下文信息缺乏统一入口，各插件自行从内部模块读取，导致升级脆弱。新的 host hooks 建立了一个稳定的接口契约，减少了插件对内部实现的依赖。

插件测试支撑体系也同步完善。原有测试辅助函数分散在 `test/helpers` 桥接目录中，插件测试与仓库内部实现耦合过紧。本版将其重组为 `plugin-sdk/channel-test-helpers`、`plugin-sdk/channel-target-testing`、`plugin-sdk/plugin-test-api` 等多个聚焦子路径，并新增 `plugin-sdk/agent-runtime-test-contracts`、`plugin-sdk/channel-contract-test-helpers` 等。这使得插件测试可以在不引入仓库内部依赖的情况下完成。

价值评估：⭐⭐⭐⭐ 插件 SDK 的重构是本版最重要的架构改进。上下文传递机制的补全和测试接口的标准化，降低了插件维护成本，也为未来插件生态扩展奠定了基础。

本版平台集成有两个值得关注的进展。

元宝 渠道正式纳入官方目录。此前腾讯 元宝 机器人通过 `openclaw-plugin-yuanbao` 社区插件运行，本版将其注册至官方渠道目录、合约套件和社区插件文档，并新增 `docs/channels/yuanbao.md` 快速入门指南，支持 WebSocket 机器人私信和群聊两种接入模式（#72756、#73443）。这意味着 元宝 渠道获得了与飞书、Telegram 等官方渠道同等的配置体验和文档支持。

QQBot 群聊能力显著增强。本次更新为 QQBot 添加了完整的群聊支持，包括历史追踪、@-mention 门控、激活模式、群组级配置、FIFO 消息队列配合交付防抖、C2C `stream_messages` 流式处理、`sendMedia` 大文件分块上传等（#70624）。引擎内部被拆分为流水线阶段、专注出站子模块、内置斜杠命令模块，并通过 `createEngineAdapters()` 提供显式 DI 端口。架构重构后，QQBot 的扩展性和可维护性显著提升。

本版在模型侧的核心变化是新增了 DeepInfra 作为官方捆绑插件，提供 `DEEPINFRA_API_KEY` 接入引导、动态 OpenAI 兼容模型发现、图片生成与编辑、图片/音频媒体理解、TTS、文生视频、Memory Embeddings 等功能，并附带静态目录元数据和 provider 自有 base URL 策略。该插件继承并整合了此前多个 issue（#53805、#48088、#37576 等），覆盖较为完整。

模型目录迁移是另一个持续推进的方向。本版将 Qianfan、小米、NVIDIA、Cerebras、Mistral、Moonshot、DeepSeek、腾讯 TokenHub、StepFun、BytePlus、Volcano Engine、Fireworks、Together AI 等提供商目录从运行时回退钩子迁移至插件 manifest `modelCatalog` 行声明。迁移完成后，provider 过滤列表将基于 manifest 声明的静态行运作，不再依赖运行时 fallback 机制。

此外，Ollama 的一个问题修复值得注意：之前配置 `agents.defaults.imageModel` 或 `pdfModel` 裸引用时，若 image-capable provider 不唯一，可能导致引用解析失败并回落到默认 provider，进而使用非预期的模型（如 `moondream` 走错路径）。本版修复后引用解析可正确找到唯一匹配的 provider。

价值评估：⭐⭐⭐⭐ DeepInfra 的纳入丰富了提供商生态，模型目录迁移则是一个基础性工作——短期内用户感知不强，但中长期将显著改善 provider 发现和列表的一致性问题。

本版新增了运营商管理的出站代理路由功能，通过 `proxy.enabled`、`proxy.proxyUrl` / `OPENCLAW_PROXY_URL` 配置项启用。该功能包含以下设计要点：

– 严格验证 `http://` 前缀的 forward-proxy 格式，不支持 SOCKS5 等其他协议 – Loopback 地址的 Gateway 请求绕过代理，确保本地开发场景不受影响 – 退出时清理代理环境和调度器状态，防止状态残留

这是 OpenClaw 首次在核心层面提供代理管理能力。此前用户若需通过代理访问外部服务，需要依赖环境变量或自行处理，缺少与 Gateway 运行时的集成。代理状态与 Gateway 生命周期的绑定，简化了容器化部署场景下的网络配置。

价值评估：⭐⭐⭐ 出站代理是一个特定场景下的重要功能，对于在受限网络环境下运行 OpenClaw 的企业用户尤为实用。

TTS 相关的改动主要有两个。

macOS BlueBubbles TTS 修复（#72586）：OpenClaw 此前通过 BlueBubbles 向 macOS iMessage 发送语音消息时，文件以普通附件形式而非语音备忘录气泡呈现。本版在 macOS 主机上新增了 MP3 → Opus-in-CAF 的预转码步骤（单声道、24 kHz），并通过 MIME magic byte 检测验证 CAF 容器格式，确保 iMessage 将其识别为原生语音备忘录。转码仅在发送端进行，接收端体验与原生语音消息一致。

WebChat TTS 持久化修复（#72830）：此前自动 final-mode TTS 音频在回传时被错误地实现为添加第二条 assistant 消息，导致同一文本出现两次。本版改为通过补充式音频-only transcript 更新持久化 TTS 结果，避免了重复文本问题。

价值评估：⭐⭐⭐ 两个修复分别针对特定渠道的 TTS 体验，BlueBubbles 修复对 macOS iPhone+Mac 双生态用户有直接价值，WebChat TTS 修复改善了语音回复的端到端一致性。

本版为 Codex 模式的智能体添加了 Computer Use setup 支持（#71842）。新增 `/codex computer-use status/install` 命令，支持从 marketplace 发现安装、可选自动安装，并在 Codex 模式启动前执行 fail-closed MCP server 检查（#72094）。Codex Computer Use、Direct `cua-driver mcp` 和 OpenClaw.app 的 PeekabooBridge 三者之间的关系也在文档中得到了澄清，帮助用户理解桌面控制场景下的路径选择。

此前 Codex 桌面控制的接入方式不够清晰，安装路径分散，本次更新通过统一的 setup 命令和文档将其规范化。

价值评估：⭐⭐⭐ Codex 桌面控制的集成是本版的一个亮点功能，但目前主要面向开发者/高级用户，对主流用户的影响尚待生态成熟。

诊断能力方面本版有两个改进。

OTEL 模型调用指标扩展（#33832）：此前 OpenClaw 的 OTEL 集成可追踪请求/响应字节数、首响延迟和总耗时，但缺少端到端可观测性。本版将隐私安全的模型调用指标（请求 payload 字节、响应字节、首响延迟、总耗时）延伸至诊断事件、插件钩子、稳定性快照和 OTEL 模型调用 spans/metrics，但不记录原始模型内容。这意味着运维团队可以在不获取对话内容的前提下监控模型性能和稳定性。

日志 trace 上下文增强：JSONL 格式日志新增 `traceId`、`spanId`、`parentSpanId` 和 `traceFlags` 顶层字段（#40353 续），使日志处理器可以在不解析嵌套上下文的情况下关联请求和模型调用链路。

价值评估：⭐⭐⭐ 可观测性增强是企业级场景的基础设施需求，单次价值不显著，但累积效果明显。

本版对 Gateway 启动流程进行了多项精细化改进，目标是将插件和通道的初始化从关键路径上剥离，减少冷启动等待时间。

核心改动包括：

– 插件 manifest 复用：在配置验证阶段传入的插件元数据快照，直接在插件引导阶段复用，避免在 startup 阶段重复构建插件发现和 manifest 元数据 – 启动时通道加载优化：将通道运行时辅助工具从启动关键路径移除，改为请求时才加载；部分辅助模块（HTTP auth、canvas auth、插件路由 scope helpers）均采用延迟加载策略 – 模型预热与通道启动解耦：Gateway 启动时不再等待主模型预热完成，模型预热在后台有限速保护，Slack 等通道可更快上线 – 量子启动性能基准：新增 max-RSS 报告，便于追踪低内存启动回归（#72846 系列）

此外，启动流程中将 `plugins.enabled=false` 作为早期快速路径，跳过自动插件发现、lookup/运行时依赖和过时插件清理警告，同时保留通道阻塞警告。

价值评估：⭐⭐⭐ Gateway 启动优化是企业用户较为敏感的性能指标，尤其在频繁重启场景下效果累积明显。

本版修复数量较多，重点关注以下几类：

内存/会话修复较为集中：LINE 渠道现在将入站图片、视频、音频和文件持久化至 `~/.openclaw/media/inbound/` 而非临时文件，解决 `/tmp` 清理后 agent 无法读取 LINE 媒体的问题（#73370）；Auto-reply 修复了静默轮次后语音笔记媒体的传递问题，确保 `NO_REPLY` TTS 回复仍能交付音频（#73406）；Session 活动记录修复了未来时间戳导致过期会话持续活跃的问题。

Ollama 相关修复覆盖了多个长尾问题：裸引用解析（#38816）、thinking 配置默认关闭（#64710）、embedding 输入类型不对称的配置（已在 Changes 中提及）、非 batch 并发控制等。

Telegram 修复了原生 approval 跨多 bot 账户路由时 `accountId` 未被正确传递的问题（#69916），以及慢速 Telegram 发送或 WSL2 文件系统扫描导致的 Gateway 回复卡死问题（#74210）。

价值评估：⭐⭐⭐ 修复类改动用户感知相对分散，但在特定使用场景下往往能解决长久的痛点。本版修复覆盖面广，体现了较高的维护投入。

本版延续了 OpenClaw 近期”SDK 化、平台化、安全化”的迭代主线，未包含革命性的新功能，但插件体系的重构和平台集成的扩展具有结构性意义。

值得关注的趋势：插件 SDK 的成熟化意味着 OpenClaw 正从”核心功能平台”向”插件生态平台”深化，第三方开发者可预期的接口稳定性正在提升。DeepInfra 和 Yuanbao 的纳入则表明，OpenClaw 正在扩大其支持的推理提供商和 IM 平台范围，这对多提供商切换和多渠道运营的用户有直接价值。

需要关注的点：本版大量修复仍涉及历史积累的边界情况，插件 manifest 迁移和兼容层的存在意味着部分行为在后续版本可能发生变化，建议关注各兼容别名的计划移除时间节点。

附：完整更新清单（54 项）

> 本文基于 GitHub Release v2026.4.27 (https://github.com/openclaw/openclaw/releases/tag/v2026.4.27) 公开变更记录整理，涵盖 2026 年 4 月 26 日至 29 日期间的代码变更。