夜雨聆风
2026-03-29 | 技术评测
▌ TL;DR
OpenClaw v2026.3.28 是一次重要更新，带来了交互式工具调用防火墙、xAI 搜索、MiniMax 图像生成等安全与功能增强，但包含两个 Breaking Changes。如果你使用 Qwen Portal OAuth 或非常老的配置，需要特别注意。推荐升级，但建议先在测试环境验证。
推荐升级需注意 Breaking Changes
OpenClaw 是一个自托管的 AI Agent 网关，连接 WhatsApp、Telegram、Discord、iMessage 等聊天应用到 AI 编码助手（如 Pi）。你可以在自己的机器或服务器上运行单个 Gateway 进程，它将成为你的消息应用和随时可用的 AI 助手之间的桥梁。
新增功能
v2026.3.28 引入了多项实用功能，以下是核心亮点：
xAI 搜索 xAI 提供商已迁移到 Responses API，新增第一方 x_search 工具。从自有 Web 搜索和工具配置中自动启用 xAI 插件，使得 Grok 认证和配置的搜索流程无需手动插件切换即可工作。
MiniMax 图像生成 新增 MiniMax 图像生成提供商，支持 image-01 模型，提供生成和图像到图像编辑功能，并包含宽高比控制。
插件审批系统 新增 before_tool_call 钩子的 async requireApproval 功能，允许插件在工具执行前暂停并提示用户通过 exec 审批覆盖层、Telegram 按钮、Discord 交互或任何通道的 /approve 命令进行批准。/approve 命令现在通过自动回退同时处理 exec 和插件审批。
ACP 绑定改进 新增 Discord、BlueBubbles 和 iMessage 的当前对话 ACP 绑定，使得 /acp spawn codex --bind here 可以将当前对话转换为 Codex 支持的工作空间，而无需创建子线程。
Podman 改进 简化当前 rootless 用户的容器设置，在 ~/.local/bin 下安装启动助手，并记录主机 CLI openclaw --container ... 工作流，而不是专用的 openclaw 服务用户。
Breaking Changes
本次更新包含两个 Breaking Changes，需要特别注意：
Breaking Qwen 提供商：移除 portal.qwen.ai 的已弃用 qwen-portal-auth OAuth 集成；使用 openclaw onboard --auth-choice modelstudio-api-key 迁移到 Model Studio。
Breaking Config/Doctor：删除超过两个月的自动配置迁移；非常旧的 legacy 密钥现在会在验证时失败，而不是在加载或通过 openclaw doctor 时被重写。
社区反馈
社区对 OpenClaw 的评价总体积极，主要关注点在于安全性和可扩展性。GitHub Issues 中有用户反馈插件系统让开发更加灵活，但也担心审批机制可能影响自动化工作流。Discord 社区讨论显示，大多数开发者欢迎 xAI 集成，认为这将增强搜索功能。
是否推荐升级
推荐升级，但需根据你的使用场景谨慎操作：
适合升级 如果你不使用 Qwen Portal OAuth，或者配置相对较新（2个月内），本次升级带来的新功能（尤其是 xAI 搜索和插件审批系统）会显著提升安全性和功能性。
谨慎升级 如果你使用 Qwen Portal OAuth，需要先迁移到 Model Studio API Key。如果你有非常旧的配置（超过2个月），建议先运行 openclaw doctor 检查配置兼容性。
已知风险和坑
升级过程中可能遇到以下问题：
风险 1 Qwen Portal OAuth 配置将失效。如果你仍在使用 portal.qwen.ai 的 OAuth 集成，升级后 API 调用将失败。必须提前迁移到 Model Studio API Key。
风险 2 超过2个月的旧配置迁移将停止。如果你依赖自动配置迁移功能，本次升级后非常旧的 legacy 密钥将无法自动迁移，需要手动更新。
坑 1 插件审批系统默认不启用。你需要手动配置 before_tool_call 钩子来启用审批功能，否则新功能不会生效。
坑 2 Podman 容器设置路径改变。如果你使用 Docker/Podman 部署，需要按照新的工作流重新配置启动助手位置。
升级方法和步骤
以下是推荐的升级流程：
步骤 1 备份当前配置。运行以下命令备份 openclaw.json：
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup步骤 2 检查当前配置兼容性。运行 Doctor 工具：
openclaw doctor步骤 3 如果使用 Qwen Portal OAuth，迁移到 Model Studio API Key：
openclaw onboard --auth-choice modelstudio-api-key步骤 4 停止当前 Gateway 进程：
openclaw gateway stop步骤 5 更新 OpenClaw 到最新版本：
npm install -g openclaw@latest步骤 6 启动 Gateway 并验证：
openclaw gateway start openclaw status步骤 7 测试核心功能。在连接的聊天应用中发送测试消息，验证 xAI 搜索、图像生成和插件审批等功能是否正常工作。
如果升级过程中遇到问题，可以使用备份文件回滚：
cp ~/.openclaw/openclaw.json.backup ~/.openclaw/openclaw.json npm install -g openclaw@v2026.3.24总结
OpenClaw v2026.3.28 是一次值得升级的更新，它带来了实用的新功能和改进的安全机制。虽然有两个 Breaking Changes，但只要提前准备并按照步骤操作，升级过程应该是顺利的。建议生产环境先在测试环境中验证，确认无误后再升级到生产环境。
来源：https://github.com/openclaw/openclaw/releases, https://docs.openclaw.ai, https://x.com/openclaw/status/2038084923517796839
