OpenClaw 2026.4.27 核心解读:Codex 桌面控制、DeepInfra 提供商与插件治理

OpenClaw 2026.4.27 核心解读：Codex 桌面控制、DeepInfra 提供商与插件治理

从 GPU passthrough 到 manifest-first 插件系统，一次性读懂所有更新

我是atyou, 今天教大家OpenClaw 2026.4.27 Release 核心功能深度解读。

OpenClaw 2026.4.27 正式版于 2026 年 4 月 29 日发布，这是 4 月底的第二个重要迭代。beta.1 版本于同日较早时间发布，仅数小时后完成正式版合并。

本次更新带来了 Codex 桌面控制完整方案、DeepInfra 捆绑提供商、腾讯元宝和 QQBot 渠道扩展，以及插件系统的 manifest-first 架构转型。同时包含 35+ 稳定性和功能修复。

本文将从新功能、架构改进和 Bug 修复三个维度，逐一解读这个版本的每一项变更。

— — — — — — — — — —

一、Codex 桌面控制：Computer Use 完整支持方案

本次更新最重磅的功能之一，OpenClaw 现在提供了完整的 Codex 桌面控制能力，让 AI Agent 可以直接操作桌面应用。

Step 1Codex Computer Use 状态与安装命令

新增 /codex computer-use status 和 /codex computer-use install 命令，方便用户快速检查 Codex 模式状态和完成初始化配置。

这些命令内置了完整的安装流程引导，包括依赖检查、环境验证和 MCP 服务器配置。

# 检查 Codex Computer Use 状态

/codex computer-use status

# 安装 Codex Computer Use 环境

/codex computer-use install

💡提示 Codex 模式使用 MCP 服务器与桌面交互，在启动前会进行 fail-closed 安全检查，确保环境配置正确

Step 2Marketplace 发现与 MCP 服务器检查

新增 Marketplace 发现功能，用户可以浏览和安装支持 Codex 的第三方 MCP 服务器。

关键的是实现了 fail-closed MCP 检查机制：在 Codex 模式启动前，会验证所有 MCP 服务器的配置状态，任何配置错误都会阻止启动，避免 Agent 在不安全状态下操作桌面。

⚠️踩坑 如果 MCP 服务器配置有误，Codex 模式会直接拒绝启动而非静默失败，这可能导致已有工作流中断，请提前检查配置

— — — — — — — — — —

二、DeepInfra 提供商：新增捆绑模型供应商

DeepInfra 正式加入 OpenClaw 捆绑提供商大家庭，带来全面的模型支持和一站式 onboarding 体验。

Step 1DeepInfra 提供商功能概览

DeepInfra 作为新的捆绑提供商，支持以下能力：动态 OpenAI 兼容模型发现、图像生成与编辑、音频/视频媒体理解、TTS 语音合成、文本转视频、Memory 嵌入向量，以及静态目录元数据。

onboarding 流程使用 DEEPINFRA_API_KEY 环境变量，遵循 provider-owned base URL 策略，简化了首次使用的配置步骤。

# 配置 DeepInfra API Key

export DEEPINFRA_API_KEY=your_api_key_here

# 在 openclaw.yaml 中配置

providers:

–id: deepinfra

apiKey:${DEEPINFRA_API_KEY}

💡提示 DeepInfra 的模型发现是动态的，这意味着它能自动获取最新的可用模型，无需手动更新模型列表

Step 2模型目录与 suppression 机制

DeepInfra 的模型目录通过插件 manifest 的 modelCatalog 行声明，支持 aliases 和 suppressions 配置。

这意味着用户可以自定义模型别名，或者隐藏不想要的模型变体，实现更精细的模型选择控制。

— — — — — — — — — —

三、腾讯生态扩展：元宝与 QQBot 新支持

腾讯系渠道支持进一步扩展，元宝和 QQBot 现在都具备更完整的功能覆盖。

Step 1Tencent Yuanbao 渠道支持

新增官方元宝外部渠道插件 (openclaw-plugin-yuanbao)，已在官方渠道目录、合约套件和社区插件文档中注册。

新增 docs/channels/yuanbao.md 快速入门指南，详细说明 WebSocket bot DM 和群聊的配置步骤。

💡提示 元宝支持 WebSocket 连接方式的机器人对话和群聊，适合需要实时交互的场景

Step 2QQBot 全面升级：群聊、流式与媒体

QQBot 获得重大功能升级：完整的群聊支持（历史追踪、@-mention gating、激活模式、每群配置、FIFO 消息队列和发送防抖），

C2C 流式消息支持（通过 StreamingController 生命周期管理器），统一的 sendMedia 接口支持大文件分块上传。

引擎架构也进行了重构，拆分为 pipeline stages、focused outbound submodules、内置 slash-command 模块和显式 DI 端口。

— — — — — — — — — —

四、插件系统架构转型：manifest-first 时代

本次更新对插件系统进行了重大架构升级，从运行时发现转向 manifest-first 设计理念。

Step 1显式 activation.onStartup 声明

捆绑插件现在必须显式声明 activation.onStartup 元数据，明确指定需要在 Gateway 启动时导入的插件。

这改变了过去的隐式 sidecar 加载方式，让插件作者可以精确控制插件的激活时机，同时也为未来废弃隐式加载铺平道路。

# plugin.yaml 示例

activation:

onStartup:true

#替代过去的隐式加载

⚠️踩坑 旧的隐式 sidecar 加载方式已标记为 deprecated，现有插件会收到兼容性警告，建议尽快迁移到显式声明

Step 2modelCatalog 插件化迁移

多个模型提供商的目录已迁移到插件 manifest 的 modelCatalog 行：Qianfan、Xiaomi、NVIDIA、Cerebras、Mistral、Moonshot、DeepSeek、Tencent TokenHub、StepFun、BytePlus、Volcano Engine、Fireworks、Together AI。

这使得模型目录声明不再依赖运行时 fallback hooks，而是通过版本化的 manifest 文件管理，便于审计和版本控制。

Step 3Gateway 启动性能优化

通过复用 lookup-table 插件 manifest，Gateway 启动时不再重复构建插件发现和元数据，显著减少了冷启动时间。

plugin metadata snapshot 在配置验证阶段就被传递给插件 bootstrap，避免了重复的 manifest 解析开销。

— — — — — — — — — —

五、基础设施改进：GPU passthrough 与网络代理

两项重要的基础设施升级，扩展了 OpenClaw 的部署灵活性和安全控制能力。

Step 1Sandbox/Docker GPU passthrough

新增可选的 sandbox.docker.gpus 配置项，允许将主机 GPU 传递给 Docker 沙箱容器使用。

这使得本地 GPU 工作负载可以在沙箱化的 Agent 环境中运行，兼顾安全性和性能需求。修复了 issue #57976。

# openclaw.yaml 配置示例

sandbox:

docker:

gpus:“all”# 或指定 GPU 设备 ID

⚠️踩坑 需要主机 Docker 运行时支持 –gpus 参数，老版本 Docker 可能不兼容

Step 2出站代理路由支持

新增可选的 operator 管理的出站代理路由功能，通过 proxy.enabled、proxy.proxyUrl（或 OPENCLAW_PROXY_URL）配置。

实现了严格的 http:// forward-proxy 验证，Gateway 默认绕过 loopback 地址，并在退出时清理 proxy 环境变量和调度器状态。增强了企业部署场景的安全性。

— — — — — — — — — —

六、移动端改进：iOS 与 Android 节点存活事件

iOS 和 Android 移动端节点的配对和存活追踪机制得到显著改善。

Step 1iOS 节点 presence.alive 协议

新增经过认证的 node.presence.alive 协议事件和 node.list last-seen 字段。

这使得后台运行的 iOS 设备可以在标记配对节点为最近活跃的同时，不将其视为已连接状态，优化了移动端电池使用。

Step 2Android 节点 presence 事件

Android 端也实现了类似的 node.presence.alive 事件发布机制，在节点连接和后台转换后触发。

确保配对的 Android 节点在断开后仍能保留持久的 last-seen 元数据，改善了移动端场景下的状态同步。

— — — — — — — — — —

七、稳定性修复：35+ Bug 修复详情

本次更新包含了大量稳定性修复，涵盖多个核心模块。

Step 1Gateway 与会话管理

修复了 chat.history 和 sessions.list 的 thinking 默认值与 owning-agent 和 catalog 感知解析的对齐问题。

修复了设备配对状态文件在写入前恢复数组形状的问题，避免 UUID 键值的待审批和已配对条目在畸形 JSON 写入后消失。

修复了 Control UI 和 Node gateway 客户端中陈旧设备令牌的清理和重连逻辑，避免 scope 升级或令牌轮换后的限流循环。

💡提示 这些修复显著改善了多设备场景下的用户体验，特别是在使用 Control UI 管理多个 Gateway 时

Step 2Telegram 与 Slack 通道

Telegram 通道现在正确处理 multi-bot 账户中的 accountId 作用域路由。

Slack Socket Mode 新增 15s 默认 pong 超时和可配置覆盖选项，改善了陈旧 WebSocket 连接的处理。

Slack 媒体下载增加了 idle 和 total 超时限制，避免大文件下载阻塞消息处理。

Step 3Media 生成任务

修复了视频和音乐生成任务在父聊天上下文消失后被错误标记为 lost 的问题。

优先使用 OpenAI 图像和视频提供商而非 Fallback，确保自动媒体生成使用最新模型。

任务维护不再在 provider job 仍处于 pending 时将活跃的 Discord 媒体渲染标记为 lost。

— — — — — — — — — —

八、Plugin SDK 全面升级：测试与发布分离

Plugin SDK 进行了大规模的重构，将测试辅助工具和核心 API 明确分离。

Step 1测试辅助工具 SDK 化

大量测试辅助工具从 repo-only test/helpers 目录迁移到 SDK 的 focused subpaths：

– channel contract fixtures → plugin-sdk/channel-test-helpers

– sandbox config fixtures → plugin-sdk/sandbox-test-fixtures

– provider catalog/wizard/registry helpers → plugin-sdk/provider-test-helpers

– generic module reload/bundled-path/Node builtin mocks → plugin-sdk/generic-test-helpers

这意味着插件开发者可以更方便地复用这些测试工具，无需复制代码。

💡提示 旧的 test/helpers 目录已标记为 deprecated，建议新插件直接使用 SDK 中的测试辅助工具

Step 2Host Hooks 扩展

新增通用 host hooks 支持：session state、next-turn context、trusted tool policy、UI descriptors、events、scheduler cleanup 和 run-scoped plugin context。

这些 hooks 让插件可以更深度地集成到 Agent 运行时环境中，实现更复杂的业务逻辑。

— — — — — — — — — —

七、常见问题与排错

Codex Computer Use 需要什么前置条件？

需要配置正确的 MCP 服务器，OpenClaw 会在启动前进行 fail-closed 检查，任何配置错误都会阻止启动。

DeepInfra 支持哪些模型？

DeepInfra 支持动态模型发现，会自动获取最新的 OpenAI 兼容模型，包括图像生成、音频理解、TTS 等。

旧插件需要迁移吗？

使用隐式 sidecar 加载的旧插件会收到兼容性警告，建议更新为显式 activation.onStartup 声明。

GPU passthrough 支持哪些GPU？

需要主机 Docker 运行时支持 –gpus 参数，具体支持情况取决于 Docker 版本和 GPU 驱动。

QQBot 群聊支持哪些功能？

支持历史追踪、@-mention gating、激活模式、每群配置、FIFO 消息队列和流式消息。

— — — — — — — — — —

八、安全建议

•Codex 模式使用 MCP 服务器与桌面交互，启动前会进行 fail-closed 安全检查，确保环境安全

•新增出站代理支持企业部署场景，Gateway 默认绕过 loopback 地址，退出时自动清理代理状态

•设备令牌现在会在 mismatch 时正确清理，避免限流循环和安全隐患

⚠️重要提醒 本文中出现的所有 Token 均为示例或已脱敏处理。请务必使用你自己的 Token，并妥善保管。切勿将敏感凭证提交到 Git 仓库。

— — — — — — — — — —

总结

v2026.4.27 带来了 Codex 桌面控制完整方案、DeepInfra 捆绑提供商和腾讯系渠道扩展

插件系统全面转向 manifest-first 架构，Gateway 启动性能显著提升

35+ 稳定性修复覆盖多设备配对、通道通信、媒体生成和任务管理

Plugin SDK 测试辅助工具全面 SDK 化，插件开发体验大幅改善

•核心功能🔔 Codex 桌面控制 + DeepInfra

•架构升级🏗️ manifest-first 插件系统

•稳定性🔧 35+ Bug 修复

•SDK 改进📦 测试工具全面 SDK 化

— — — — — — — — — —

我是atyou, 您有什么感兴趣的主题，可以给我留言让我们一起拥抱AI, 共同进步，享受美好生活。

参考文档：

•OpenClaw GitHub → 点击访问

https://github.com/openclaw/openclaw

•v2026.4.27 Release Notes → 点击访问

https://github.com/openclaw/openclaw/releases/tag/v2026.4.27

•Codex Computer Use 文档 → 点击访问

https://github.com/openclaw/openclaw/blob/main/docs/codex.md

•DeepInfra Provider 文档 → 点击访问

https://github.com/openclaw/openclaw/blob/main/docs/providers/deepinfra.md

•元宝渠道快速入门 → 点击访问

https://github.com/openclaw/openclaw/blob/main/docs/channels/yuanbao.md