Plugins 导读

Plugin SDK 就是一张“该从哪导入、能注册什么”的速查表

先看 import 约定:必须从具体子路径导入,别图省事用 `openclaw/plugin-sdk/slack` 这种品牌化捷径——那是留给内置插件的,新插件用了会踩坑。200+ 子路径按用途分组,写 channel 插件主看 `channel-core`,写 provider 插件主看 `provider-entry`,别在 `core` 里乱翻。

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

Plugin SDK 就是一张“该从哪导入、能注册什么”的速查表

先看 import 约定:必须从具体子路径导入,别图省事用 `openclaw/plugin-sdk/slack` 这种品牌化捷径——那是留给内置插件的,新插件用了会踩坑。200+ 子路径按用途分组,写 channel 插件主看 `channel-core`,写 provider 插件主看 `provider-entry`,别在 `core` 里乱翻。

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

第一站

🧭 先看清三件事:从哪进、能注册什么、最后怎么装进去

这页最值钱的是全景,不是某个单独 API 名字。

🪟

入口

插件从哪个文件开始被 OpenClaw 找到。

🧰

能力

能注册工具、通道、provider、hook 等。

🗺

映射

外部 bundle、manifest、SDK 彼此怎么对上号。

🎈

一句话

它是插件怎么被看见、怎么被接住的总说明。

第二站

🛠 命令 / 代码像在做什么

SDK 里的代码示例,其实是在教你把能力挂上系统的墙。

`definePluginEntry(...)`

像先报上名字,再递交自己的能力清单。

`registerTool(...)`

像把一个新工具正式放进工具箱。

`registerHook(...)`

像在关键路口安排一个小哨兵。

最后记住

🎈 Overview 不是细节题,而是“先看地图再出门”

把这一页看懂,后面的 manifest、entrypoints、runtime 和 testing 才不会各看各的像散片。