OpenClaw 周报:v2026.3.23 重要修复与稳定性提升

发布日期：2026-03-24

📌 本周亮点

昨天(3月23日),OpenClaw 发布了 v2026.3.23 版本,这是继 v2026.3.22 重大架构更新后的重要修复版本。本周我们同步完成了 28 篇新文档的翻译工作,翻译进度达到 92.2%。

🔧 重要修复

浏览器与 Chrome MCP

• 修复现有会话附加超时：等待现有会话浏览器标签页就绪,而不是将初始 Chrome MCP 握手视为就绪状态,减少了 macOS Chrome 附加流程的超时和重复同意提示
• 修复无头浏览器启动：在初次可达性检测失败后,重用已运行的回环浏览器,而不是立即回退到重新启动检测,修复了较慢的无头 Linux 设置上的二次运行浏览器启动问题

ClawHub 与插件系统

• macOS 认证配置：正确使用 macOS 认证配置和 XDG 认证路径保存 ClawHub 凭据,确保技能浏览览使用已登录的认证状态
• 技能浏览修复：解决本地 ClawHub 认证令牌解析问题,切换浏览所有请求为搜索,避免 429 错误和空认证技能列表

消息工具

• Discord 和 Slack 兼容性：使 Discord 组件和 Slack 块再次可选,修复架构验证失败
• 飞书文件发送：飞书 message(..., media=...) 发送现在正确路由到出站媒体路径,文件和图片附件可以正常发送

模型提供商

• OpenRouter 定价：停止 openrouter/auto 定价刷新在引导期间无限递归,确保 OpenRouter 自动路由可以填充缓存的定价和使用成本
• Mistral 默认值：将捆绑的 Mistral 最大令牌默认值降低到安全输出预算,并教导 openclaw doctor --fix 修复旧的持久化 Mistral 提供商配置
• Codex OAuth 代理：在令牌续订路径上引导环境配置的 HTTP/HTTPS 代理调度器,确保过期的 Codex OAuth 配置文件可以在需要代理的环境中成功刷新

网关与安全

• 网关探测：停止成功的网关握手在加载后连接详细 RPC 时超时,使慢速设备报告可到达的 RPC 失败而不是错误的不可达网关
• 监督机制：通过将重复进程保持在重试等待而不是作为失败退出,防止锁定冲突在 launchd 和 systemd 下崩溃循环
• 执行审批：保持 shell 包装器位置参数 argv 白名单匹配仅在真正的直接载体上,拒绝单引号 $0/$n 令牌,禁止换行符分隔的执行

📚 文档翻译进展

本周我们完成了 28 篇新文档的翻译工作,重点关注插件系统:

新增翻译(28 篇)

插件系统(14 篇)

• 插件内部架构、构建插件、插件包、社区插件、插件清单
• 渠道插件开发、插件入口点、SDK 迁移指南、SDK 概览
• 提供商插件开发、运行时辅助程序、设置和配置、测试工具、语音通话插件

安装部署(2 篇)

• Docker VM 运行时、Matrix 迁移指南

工具集成(6 篇)

• DuckDuckGo 搜索、Exa 搜索、Gemini 搜索、Grok 搜索、Kimi 搜索、Web 获取工具

模型提供商(2 篇)

• DeepSeek 提供商、Google (Gemini) 提供商

其他(4 篇)

• Gateway 安全、Gateway 生命周期、Pi 开发工作流、内存配置参考

翻译进度

• 总文档数: 334 篇
• 已翻译数: 308 篇
• 翻译进度: 92.2%
• 待翻译: 26 篇

🎯 重点特性回顾

1. 全新插件 SDK 架构

• 新的公共插件 SDK 表面: openclaw/plugin-sdk/*
• 移除 openclaw/extension-api(无兼容垫片)
• 捆绑插件必须使用注入的运行时进行主机端操作
• 插件作者应迁移到 describeMessageTool(...) 方法

2. Matrix 正式支持

• 新增 Matrix 插件,基于官方 matrix-js-sdk
• 提供完整的 Matrix 协议支持
• 包含详细的迁移指南

3. 多搜索引擎集成

• 新增 Gemini、Exa、DuckDuckGo、Grok、Kimi 搜索集成
• 提供统一的搜索接口
• 支持多种搜索场景

4. 新增模型提供商

• DeepSeek 提供商完整支持
• Google Gemini 提供商集成
• 扩展 AI 模型选择范围

5. 环境变量统一

• 移除 CLAWDBOT_* 和 MOLTBOT_* 兼容环境变量
• 统一使用 OPENCLAW_* 环境变量
• 状态目录统一到 ~/.openclaw

6. 图像生成标准化

• 统一使用 image_generate 工具
• 移除 nano-banana-pro 技能包装器
• 使用 agents.defaults.imageGenerationModel 配置

🔗 快速链接

• 官方文档
• GitHub Release
• 中文翻译索引

💡 升级建议

2. 立即升级到 v2026.3.23 以获得最新的稳定性修复
4. 运行 openclaw doctor --fix 自动迁移旧配置
6. 如使用旧版 Chrome 扩展,请迁移到现有会话模式
8. 检查环境变量,确保使用 OPENCLAW_* 前缀
10. 如使用 Matrix,请参考迁移指南升级

本周报由 OpenClaw 文档翻译团队自动生成