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。
第一站
🚚 先别推倒重来,先把旧家的家具搬出来
Migration 不是“从零重写”,更像把旧插件拆成几箱:目录、命令、hook、配置、测试,再一个个搬。
📁 先看目录
哪里放 skill,哪里放 commands,哪里放 hooks,先把家当分类。
🧾 先看 manifest
旧盒子里的身份证先拿出来,看看新盒子认不认。
🧪 先跑测试
搬家后先试试门能不能开、灯能不能亮。
第二站
🛠 代码像在做什么
官方的迁移建议,本质是把老格式翻译成新格式,而不是把功能全部推倒。
`openclaw.plugin.json`
像新家门口的登记表,得先写给系统看。
`commands/` / `hooks/`
像把老抽屉里的纸条分成两沓,再按新规矩摆好。
`pnpm test` / `pnpm check`
像搬完家后把每扇门都推一遍,确认没有卡住。
最后记住
🎈 Migration 的目标不是“改得很猛”,而是“搬得稳”
这页最重要的提醒就是:先保住原能力,再慢慢换骨架。