Plugins 导读
插件系统内部架构：能力模型与兼容性
这一页是OpenClaw插件系统的深度架构参考，不是入门教程。核心是“能力模型”（Capability Model）：每个原生插件通过注册一个或多个能力类型（如文本推理、语音、频道等）来声明自己的功能。如果你要开发新插件，先看“能力类型”表格，明确你的插件该注册哪个能力；最容易搞错的是“钩子（hook）插件”和“能力插件”的区别——钩子插件不注册任何能力，只通过钩子介入流程，虽然仍受支持，但官方推荐新插件优先使用能力注册。
先讲这一页到底在解决什么
插件系统内部架构：能力模型与兼容性
这一页是OpenClaw插件系统的深度架构参考，不是入门教程。核心是“能力模型”（Capability Model）：每个原生插件通过注册一个或多个能力类型（如文本推理、语音、频道等）来声明自己的功能。如果你要开发新插件，先看“能力类型”表格，明确你的插件该注册哪个能力；最容易搞错的是“钩子（hook）插件”和“能力插件”的区别——钩子插件不注册任何能力，只通过钩子介入流程，虽然仍受支持，但官方推荐新插件优先使用能力注册。
第一站
🧩 插件不是一块代码，而是一整套“从报到到上岗”的流程
官方把内部结构摊开，是为了让你知道：插件真正运行时，哪些步骤先发生，哪些步骤后发生。
🪪
身份
先登记自己是谁。
🧰
能力
再说明自己能做什么。
🚦
生命周期
最后说明什么时候启动、什么时候退出。
第二站
🛠 代码像在做什么
这页很多图和表，其实在讲同一件事：消息进来以后，谁先看、谁后看、谁最后决定。
`register`
像在前台登记新员工。
`capabilities`
像员工证上的技能标签。
`runtime`
像上班后真的能用到的工具间。
最后记住
🎈 Architecture 不是为了难，而是为了让插件长得不乱
骨架讲清楚了，后面做 manifest、runtime、testing 才不会混成一团。