夜雨聆风发布日期：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
- 中文翻译索引
💡 升级建议
- 立即升级到 v2026.3.23 以获得最新的稳定性修复
- 运行
openclaw doctor --fix自动迁移旧配置 - 如使用旧版 Chrome 扩展,请迁移到现有会话模式
- 检查环境变量,确保使用
OPENCLAW_*前缀 - 如使用 Matrix,请参考迁移指南升级
本周报由 OpenClaw 文档翻译团队自动生成
