OpenClaw 3.22重磅更新——好消息:GPT-5.4、全新 Plugin SDK,坏消息:微信Clawbot插件挂了

OpenClaw 2026.3.22 来了，这是今年以来最重要的一次版本更新。在 3.13 版本突破性的浏览器自动化之后，本次更新聚焦于 Agent 框架的成熟化、搜索能力的全面扩展，以及用户与自主系统交互方式的优化。但由于微信插件的不兼容，容易导致本次升级失败。

从 GPT-5.4 成为新的默认模型，到呼唤已久的 Plugin SDK，这次更新内容极为丰富。但需要注意的是：本版本优先考虑安全性和模块化，而非向后兼容。

微信插件（openclaw-weixin）启动崩溃

微信在3月22日推出的微信Clawbot插件由于采用了旧的导入入口，导致在升级过程直接挂掉，也影响了OpenClaw的升级，强烈建议：在升级之前先卸载微信插件。

现象：升级后 Gateway 启动报错，微信插件无法加载

原因：openclaw-weixin v1.0.3 导入了 resolvePreferredOpenClawTmpDir，该函数在新版 Plugin SDK 中从主入口移到了子模块，旧插件从主入口导入找不到

本质：3.22 版本移除了旧 openclaw/extension-api，Plugin SDK 接口发生 breaking change

解决：直接卸载微信插件（删除 /root/.openclaw/extensions/openclaw-weixin/），重启 Gateway

🧠 GPT-5.4：新一代智能标准

自 3.12 版本以来，OpenClaw 首次更新了默认 OpenAI 模型：

标准模型：openai/gpt-5.4
编程模型：openai-codex/gpt-5.4

这次切换为 Agent 带来了显著的推理稳定性和工具调用准确性提升。

关键改进

统一管理：OpenAI 的 chat、image、TTS、转录和 embedding 默认值统一到单一模块管理，复杂 Agent 舰队的配置更简单
Per-Agent AI Defaults：可为每个 Agent 单独设置思考和推理模型
自动回退机制：手动指定的模型 override 不可用或失败时，系统自动回退到 Agent 预配置的默认值，防止会话卡死

🔍 三大搜索引擎原生集成

自主 Agent 的能力上限取决于它能获取的信息质量。2026.3.22 原生集成了三大 AI-first 搜索和抓取工具：

Exa

支持原生日期过滤和搜索模式选择，Agent 可在特定时间范围内精准搜索最新研究论文或新闻。

Tavily

集成专用 tavily_search 和 tavily_extract 工具。Tavily 以提供 LLM 优化的搜索结果著称，有效减少 Token 噪声。

Firecrawl

全新 firecrawl_search 和 firecrawl_scrape 工具，可将任意 URL 即时转换为干净的、LLM-ready 的 Markdown 格式。

这些集成使 OpenClaw 成为自动化研究和数据提取领域最强大的平台。

🧩 全新 Plugin SDK 与 ClawHub

OpenClaw 的扩展方式正在发生根本性变化。

旧 API 正式退役

旧的 openclaw/extension-api 已被正式移除，没有兼容垫片。开发者必须迁移到新的 openclaw/plugin-sdk/* 模块化接口。

为什么要改？

旧方式存在三大问题：

启动慢：导入一个 helper 会加载几十个无关模块
循环依赖：宽泛的 re-export 容易创建导入循环
API 边界模糊：无法区分稳定 API 和内部实现

新 Plugin SDK 的每个导入路径（openclaw/plugin-sdk/<subpath>）都是小型、独立、有明确契约的模块。

ClawHub 成为首选安装源

运行 openclaw plugins install <package> 时，系统现在优先从 ClawHub 安装，npm 仅作为 fallback。这确保了社区审核过的、Agent 专用的插件始终被优先选择。

💬 会话中途澄清提问

使用自主 Agent 最令人沮丧的场景之一：Agent 在 30 分钟的研究任务中途做出了错误假设。

2026.3.22 通过允许 Agent 在会话中途提出澄清问题来解决这个问题。这些问题以非阻塞、可关闭的方式出现在会话中。你可以提供额外上下文或选择偏好，而不会打断 Agent 当前的思考过程或上下文窗口。

🔐 生产级安全强化

密钥管理

全新 SecretRef 系统，支持最多 64 个凭证目标，Agent 连接真实账户时不再担心 API Key 泄露到日志或配置文件中。

原生 PDF 处理

Agent 现在具备原生 PDF 处理能力，支持可配置的页数和大小限制，以及提取 fallback。这对依赖 Agent 进行文档摘要或从临床/财务报告中提取结构化数据的用户来说是巨大利好。

统一消息适配器

单一 sendPayload 适配器覆盖 Discord、Slack、WhatsApp、Zalo 和 Telegram 的通信，简化多渠道 Agent 逻辑。

默认权限收紧

新安装默认 tools.profile 改为 "messaging"，文件系统和 shell 访问默认不开放。这是防止未授权脚本执行的关键安全措施。

浏览器自动化迁移

旧 Chrome 扩展 relay 路径已移除（driver: "extension" 和 browser.relayBindHost）。需迁移到 existing-session / user 模式。

⚠️ 升级要点

必做操作

# 自动修复迁移问题openclaw doctor --fix

检查清单

项目	操作
旧 streamMode 配置	运行 `openclaw doctor --fix` 自动迁移
自定义插件	从 `extension-api` 迁移到 `plugin-sdk/*`
浏览器自动化	从 Chrome extension relay 迁移到 existing-session/user
权限设置	如 Agent 能力变弱，检查 `tools.profile` 是否需设为 `"full"`
Per-Agent 模型	可选配置，为不同 Agent 设置独立的推理模型

升级命令：

npm update -g openclawopenclaw doctor --fix

总结

OpenClaw 2026.3.22 是向生产级自主 Agent 可靠性迈出的重大一步。核心变化：

更聪明 — GPT-5.4 默认 + Per-Agent 模型配置
更能搜 — Exa + Tavily + Firecrawl 三大搜索引擎原生集成
更模块化 — 全新 Plugin SDK，告别混乱的旧 API
更安全 — SecretRef、权限收紧、浏览器安全迁移
更人性化 — 会话中途提问、原生 PDF、统一消息

🦞 OpenClaw — 你的 AI Agent，你的规则。