夜雨聆风
OpenClaw 3.22:插件架构彻底换血
核心一句话：旧插件体系完全废弃、新 SDK 接管、ClawHub 成官方源，所有旧插件必须迁移。
｜插件架构「换骨式」重构（最狠变化）
• 旧 API 直接移除，零兼容、无过渡期
◦ 废弃：openclaw/extension-api（旧扩展接口）
◦ 替换：全新 openclaw/plugin-sdk/* 模块化 SDK
◦ 后果：所有旧第三方插件直接失效，必须重写适配
• 开发与调用规则全改
◦ 必须从细分子路径导入（如 @openclaw/plugin-sdk/hooks）
◦ 插件不能直接调用宿主 API，必须通过注入 runtime
◦ 消息/工具机制重写：listActions 等 → 新 describeMessageTool
•
｜ClawHub：官方插件市场接管分发
• 安装源优先级变更
◦ 旧：plugins install → 直接从 npm 拉取
◦ 新：优先 ClawHub，找不到才 fallback 到 npm
• 生态意义
◦ ClawHub：官方审核、签名验证、信任溯源
◦ 减少 npm 恶意包、供应链攻击风险
◦ 支持 clawhub:<包名> 显式安装
示例对比（旧 → 新）// 旧（3.21 及以前）import { registerExtension } from ‘openclaw/extension-api’registerExtension({ name: ‘old-plugin’, onMessage: async (msg) => ({ reply: ‘hi’ })})
// 新（3.22）import { definePlugin, hooks } from ‘@openclaw/plugin-sdk’export default definePlugin({ name: ‘new-plugin’, setup() { hooks.on(‘message:received’, async (ctx) => { return { reply: ‘hi’ } }) }})
｜其他插件相关升级
• 跨工具兼容
◦ 支持直接导入 Claude Code、Cursor、Codex 插件包
◦ 自动映射外部技能到 OpenClaw 体系
• 新能力
◦ 插件可注册自定义 system-prompt（Memory 插件）
◦ 新增 plugin-sdk/testing 测试接口，支持单元测试
◦ 原生 skills search/install/update 命令链