用途:指导从零构建 OpenClaw 插件,通过 npm 包注册扩展点,扩展智能体运行时。
主要能力:可注册工具(发送给模型 API 的类型化函数)、通道(Slack、Discord、REST 等通信接口)、模型提供方、语音提供方、图像生成器,以及在插件内打包技能;可编写 openclaw.plugin.json 清单;可配置工具分组、allow/deny 列表、按提供方的限制,以及 full/coding/messaging/minimal 工具配置档;支持以 npm 外部包形式发布。
适用场景:新建插件、注册扩展点、编辑清单、打包技能、配置权限、发布或迁移到 Plugin SDK。不适用于构建不带插件打包的独立技能(用 build-skills)、优化 MCP 服务器(用 optimize-mcp-server)、与 OpenClaw 无关的 Node.js/TypeScript 开发及 OpenClaw 自身配置。
使用方式:先确认 Plugin SDK 实际导入路径与本地运行环境;区分 npm 包名与清单运行时名;按需阅读 references/guides 与 references/patterns 下文件。本地验证可用: openclaw plugins install -l /abs/path/to/openclaw-plugin-example openclaw plugins enable example 随后运行 openclaw doctor、openclaw status 确认插件可见与各扩展点行为。以上 CLI 仅在目标运行时实际提供对应命令时使用,否则应停在清单/构建验证阶段并索取本地加载路径,相关资料未提供替代配置方式。
限制与要求:不得在源码中硬编码密钥,应通过 metadata.openclaw.requires.config 做配置门控;工具必须写描述,参数需在 handler 中再次校验;deny 优先于 allow;务必在包内包含 openclaw.plugin.json。插件名与工具名用 kebab-case。资料未提供具体版本、价格或 SDK 包名。