插件开发入口

本页帮助您回答两个问题：是否需要做插件，以及应该做哪种插件。

什么时候需要插件

在开始开发插件前，先确认您的需求是否真的需要插件：

需求	推荐方案	说明
一段可复用的操作说明或提示词	Skill（技能）	通过 SKILL.md 定义，无需代码
接入一个现成的外部工具服务	MCP	通过 MCP 协议接入，标准化程度更高
定义命令、渠道适配或需要 manifest 声明	Plugin（插件）	需要完整的开发流程

TIP

如果您只需要一段可复用的能力描述，用 Skill 就够了。如果只需要调用一个外部 API，优先用 MCP。只有当需要定义 manifest、注册命令或对接消息渠道时，才进入插件开发。

插件类型

类型	定位	典型场景	复杂度
tool	命令型扩展	本地脚本封装、固定回复、CLI 工具	低
channel	渠道接入	钉钉、飞书、Telegram 消息对接	高
skill	技能桥接	OpenClaw 兼容、技能类扩展	中

如何选择

• 需要给 Agent 增加可调用的命令 → tool
• 需要对接外部消息平台 → channel
• 需要兼容 OpenClaw 协议或桥接技能 → skill

兼容模式

插件 manifest 中的 compatibilityMode 字段控制接入方式：

模式	说明
native	Workova 原生方式（默认）
openclaw	兼容 OpenClaw 桥接协议，需同时提供 openclaw 配置段
skill_bridge	通过技能桥接兼容层接入

Skill vs MCP vs Plugin

维度	Skill	MCP	Plugin
定义方式	SKILL.md 文件	MCP 服务配置	plugin.manifest.json
需要编码	否	否（使用现有服务）	是
能力范围	提示词和规则	外部工具调用	命令、渠道、完整扩展
管理方式	技能页面管理	MCP 页面管理	插件安装/启用/禁用
适合场景	沉淀可复用能力	接入标准工具	平台级深度集成

推荐阅读顺序

1. 插件快速上手 — 5 分钟创建第一个插件
2. 插件完整指南 — 渠道插件、安全边界、调试方法
3. Manifest 参数说明 — 所有字段的完整定义
4. 官方插件模板 — 复制模板快速起步

INFO

第一次开发插件，建议从 tool 类型开始——只需一个 plugin.manifest.json 文件即可运行。