OpenClaw 3.23 版本更新说明：建议不要先升级

青萍叙事2026-03-24

版本：2026.3.23 发布时间：2026-03-24 建议：稳定优先，建议观望

🚨 重要提示

如果你当前的 OpenClaw 运行稳定，建议暂时不要升级到 3.23 版本。

这个版本虽然修复了大量问题，但也引入了多个破坏性变更（Breaking Changes），尤其是插件系统和浏览器配置的改动可能影响现有工作流。

⚠️ 主要破坏性变更

1. 插件安装优先级调整

变化：openclaw plugins install 现在优先从 ClawHub 安装，而非 npm。

影响：如果你之前依赖 npm 安装某些插件，可能需要显式指定来源。

# 从 ClawHub 安装（默认）
openclaw plugins install <package>

# 强制从 npm 安装
openclaw plugins install npm:<package>

2. 浏览器配置迁移

变化：移除旧的 Chrome 扩展中继路径，改用 existing-session / user 模式。

影响：使用旧版浏览器配置的用户需要迁移。

1	openclaw doctor --fix

3. 插件 SDK 重构

变化：新的公共插件 SDK 路径为 openclaw/plugin-sdk/*，旧的 openclaw/extension-api 已移除。

影响：自定义插件作者需要迁移代码。

4. Matrix 插件重构

变化：使用官方 matrix-js-sdk 重写 Matrix 插件。

影响：现有 Matrix 用户需要按照迁移指南重新配置。

✨ 值得关注的改进

🤖 模型/Provider 改进

Qwen (Alibaba Cloud Model Studio)：增加标准按量付费端点，支持中国区与全球区 API Key
Mistral：降低默认 token 上限，避免 422 错误
OpenAI Codex OAuth：支持代理环境下的 token 刷新

🎨 UI 优化

Knot 主题：黑红配色，符合 WCAG 2.1 AA 对比度标准
按钮系统：整合 btn–icon、btn–ghost、btn–xs 等基础组件
可访问性：全量添加 aria-labels

🔒 安全增强

CSP 策略：为内联脚本计算 SHA-256 哈希，默认阻止未授权脚本
执行审批：防止 shell 包装器注入攻击
语音调用 Webhook：限制未认证请求的缓冲大小（1MB → 64KB）

🧩 插件系统

ClawHub 优先：技能安装默认从 ClawHub 获取
Claude 市场支持：新增 Claude 市场注册表解析
聊天命令：新增 /plugins 和 /plugin 命令管理插件

🐛 关键 Bug 修复

认证相关

修复 OpenAI token 保存后回滚问题
修复 Control UI 操作符权限验证
修复 ClawHub macOS 认证路径

插件相关

修复插件运行时侧车文件缺失
修复 ClawHub 版本兼容性检查
修复插件卸载时的版本规格问题

消息工具

修复 Discord components 和 Slack blocks 验证
修复 Feishu 文件/图片附件发送
修复 Telegram 线程上下文丢失

浏览器相关

修复 Chrome MCP 会话等待逻辑
修复 CDP 循环浏览器复用

📋 升级检查清单

如果你决定升级，请先完成以下检查：

备份当前配置：cp -r ~/.openclaw ~/.openclaw.backup
检查插件列表：openclaw plugins list
确认无关键任务运行
阅读完整更新日志
准备回滚方案

🔄 如何升级

# 升级 OpenClaw
npm install -g openclaw

# 迁移配置
openclaw doctor --fix

# 验证安装
openclaw status

🎯 我的建议

✅ 可以升级的情况

你在开发环境测试
你需要 3.23 修复的特定 Bug
你有完整的备份和回滚方案

❌ 建议观望的情况

生产环境运行中
依赖 Matrix 或自定义插件
没有测试环境

💬 交流反馈

升级后遇到问题？欢迎在养虾交流群讨论！

关注公众号【青萍叙事】，回复关键词【养虾】加入交流群

关于青萍 Claw

青萍 Claw 是一个开箱即用的 OpenClaw 龙虾云端托管平台。

官网：https://claw.lusyoe.com

核心能力

📅 个人日历与日程管理
📝 微信公众号、知乎、小红书内容创作
🧠 个人知识库与第二大脑
📊 多维表格与数据处理
🔍 网络搜索与信息检索
⏰ 定时任务与自动化工作流
💬 多平台消息（飞书/QQ/钉钉）
🎨 青萍 AI 专属技能（AI 生图、AI 视频）

核心理念

龙虾不应该只是个聊天机器人，而应该是你的数字分身。

云端托管，开箱即用，24 小时在线。你只需要告诉龙虾要做什么，然后等它给你结果。