插件开发总览

迁移来源：docs/PLUGIN_DEVELOPMENT_GUIDE.md

这篇不是“先跑起来”，而是“把 Workova 插件体系先看完整”。

插件体系总览

Workova 当前把插件分成 3 类：

• skill：技能、提示增强、总结类能力
• tool：命令、工具、外部服务调用
• channel：聊天渠道、IM 机器人、消息接入

当前已经支持什么

• 本地扫描插件目录
• 识别 plugin.manifest.json
• 兼容 openclaw.plugin.json
• 在 Agent 页面绑定插件
• 根据 config_schema 渲染配置表单
• 自动注册插件命令
• 插件安装、导入、删除和基本校验

最重要的安全边界

当前插件系统最重要的一条红线是：

插件不能修改 LLM 渠道。

也就是说，插件不应该去覆盖这些能力：

• provider
• api_key
• base_url
• model_gateway
• llm_provider
• llm_override

原因也很直接：
模型路由必须由平台统一控制，不能让插件绕过这个边界。

目录结构建议

最简单的插件目录：

your-plugin/
  plugin.manifest.json

更完整一点的目录：

your-plugin/
  plugin.manifest.json
  bin/
  assets/
  README.md

推荐开发顺序

1. 先确定插件类型
2. 先写 manifest
3. 再补配置 schema
4. 再补命令或渠道逻辑
5. 最后做调试和文档说明

如果你现在只想先跑通

先回到：

• 插件开发快速上手

如果你想直接复制现成模板

继续看：

• 插件开发入口
• plugin.manifest 参数说明
• 官方插件模板