Plugins 导读

旧插件SDK即将移除,你的插件需要迁移到新的按需导入架构

旧版 `openclaw/plugin-sdk/compat` 和 `openclaw/extension-api` 已弃用,未来大版本将彻底移除。先对照“常见导入路径表”找到你当前使用的旧路径,替换为对应的新子路径(如 `plugin-sdk/channel-core`)。注意:不要使用表中未列出的渠道品牌路径(如 `plugin-sdk/slack`),它们只是内部快捷方式,不是稳定API。

先讲这一页到底在解决什么

旧插件SDK即将移除,你的插件需要迁移到新的按需导入架构

旧版 `openclaw/plugin-sdk/compat` 和 `openclaw/extension-api` 已弃用,未来大版本将彻底移除。先对照“常见导入路径表”找到你当前使用的旧路径,替换为对应的新子路径(如 `plugin-sdk/channel-core`)。注意:不要使用表中未列出的渠道品牌路径(如 `plugin-sdk/slack`),它们只是内部快捷方式,不是稳定API。

原文共 11 节,先看 Start Here 路径:/plugins/sdk-migration 查看官方原文

第一站

🚚 先别推倒重来,先把旧家的家具搬出来

Migration 不是“从零重写”,更像把旧插件拆成几箱:目录、命令、hook、配置、测试,再一个个搬。

📁 先看目录

哪里放 skill,哪里放 commands,哪里放 hooks,先把家当分类。

🧾 先看 manifest

旧盒子里的身份证先拿出来,看看新盒子认不认。

🧪 先跑测试

搬家后先试试门能不能开、灯能不能亮。

第二站

🛠 代码像在做什么

官方的迁移建议,本质是把老格式翻译成新格式,而不是把功能全部推倒。

`openclaw.plugin.json`

像新家门口的登记表,得先写给系统看。

`commands/` / `hooks/`

像把老抽屉里的纸条分成两沓,再按新规矩摆好。

`pnpm test` / `pnpm check`

像搬完家后把每扇门都推一遍,确认没有卡住。

最后记住

🎈 Migration 的目标不是“改得很猛”,而是“搬得稳”

这页最重要的提醒就是:先保住原能力,再慢慢换骨架。