OpenClaw v2026.3.23-2热修复版：macOS兼容性与插件系统重构

v2026.3.23-2 是 2026 年 3 月 23 日紧急发布的热修复小版本
基于 v2026.3.22（重大架构重构版）与 v2026.3.23（首轮补丁）迭代，核心解决 macOS 平台兼容性、MCP 超时/重复授权、多平台消息异常等高频痛点，无新增功能，主打稳定性与可用性修复。

一、版本定位与发布背景

• 发布时间：2026-03-23（紧随 v2026.3.23 之后，同天迭代）
• 版本层级：稳定热修复版（无 Breaking Changes，兼容 v2026.3.22/23 配置）
• 核心目标：修复前序大版本在 macOS、多平台集成、MCP 连接中的关键 Bug，解决用户升级后“功能失效、频繁授权、消息异常”等问题。

二、核心修复清单（v2026.3.23-2 专属）

1. macOS 平台重点修复

• Chrome 浏览器 MCP：大幅减少超时、消除重复授权弹窗，解决 macOS 上频繁重新授权的痛点；
• ClawHub 登录：修复 macOS 下登录状态读取异常，解决“登录后立刻掉线、技能市场无法访问”问题；
• 本地权限适配：优化 macOS 沙盒与文件读取权限，减少“配置丢失、会话中断”。

2. 多平台消息/集成修复

• 飞书（Feishu）：彻底修复文件/图片附件发送失败问题，支持正常收发富媒体消息；
• Telegram：修复自动回复顺序错乱、防抖（debounce）失效，解决“重复回复、回复延迟”；
• Discord/Slack：优化消息组件渲染、修复媒体上传偶发失败，提升长连接稳定性；
• 代理环境 OAuth：修复 Codex/Minimax 等模型在代理下的令牌刷新异常，解决“认证失效、无法调用”。

3. 其他关键修复

• MCP 会话：优化标签页附加后的等待逻辑，减少“会话卡死、无响应”；
• 子代理（Worker）：修复快速完成任务被误判超时的问题，提升任务执行准确率；
• 安全与稳定性：强化网关认证、收紧 Canvas 路由权限，修复低权限越权漏洞。

三、前序版本（v2026.3.22/23）核心基础

v2026.3.22 是里程碑式架构重构版，v2026.3.23 为首轮补丁，v2026.3.23-2 在此之上收尾修复，以下是影响使用的核心变更：

1. 破坏性变更（升级必做：openclaw doctor --fix 迁移）

• 插件系统：废弃旧 extension-api，启用全新 plugin-sdk；插件安装优先 ClawHub（官方市场），npm 降级为备选；
• 命名统一：移除 CLAWDBOT_/MOLTBOT_ 前缀，全量改为 OPENCLAW_；状态目录从 .moltbot 迁移至 .openclaw；
• 功能移除：删除 Chrome 扩展中继（browser.relayBindHost）、旧版图片生成工具 nano-banana-pro；
• 消息接口：统一为 ChannelMessageActionAdapter，旧 ListActions/getCapabilities 失效。

2. 核心功能升级（v2026.3.22）

• 模型：默认升级 GPT-5.4，新增 gpt-5.4-mini/nano；Minimax 升级至 M2.7；接入 Anthropic Vertex、xAI Grok 最新模型；
• 安全：Proxy SSRF 防护、Webhook 常量时间签名、执行审批强化、Unicode 恶意字符转义、JVM 注入拦截；
• 体验：Android 暗色主题、sms.search/callLog.search、多搜索引擎（Exa/Tavily/Firecrawl）、流式推理实时渲染思考过程；
• 架构：MCP 插件重构、动态模型回退、Cache-TTL 策略、ClawHub 深度集成。

3. v2026.3.23 首轮补丁（过渡修复）

• 修复 Mistral 模型 422 错误（降低默认 token 限制）、OpenRouter 定价递归、子代理超时误判；
• 优化 MCP 标签页等待、ClawHub macOS 认证、飞书附件、Telegram 自动回复。

四、升级建议与注意事项

1. 必须执行迁移：升级后运行 openclaw doctor --fix，自动修复配置、目录、权限问题，避免功能失效；
2. 插件兼容：旧插件（未适配新 SDK）会失效，优先从 ClawHub 安装更新版；微信插件暂未适配，升级后可能无法连接，建议观望或回退；
3. 稳定优先：若当前 v2026.3.13 无问题，可等插件生态完善后再升；若遇上述 Bug，直接升级至 23-2 即可；
4. 安装命令：npm install -g openclaw@2026.3.23-2 或 openclaw update --force。

五、升级实践

看到很多人说，升级碰到问题，因为内核插件功能进行了全新升级，所以普通升级可能会碰到问题。
我直接使用官方推荐的方式，升级正常 ：curl -fsSL https://openclaw.ai/install.sh | bash