第1章 · 概念入门阅读时间 10 分钟

1.7 核心概念四：Plugin（插件）是什么

通过本文你将全面了解核心概念四：Plugin（插件）是什么的核心概念、实际应用方法和最佳实践。

概述

一、一句话理解 Plugin

Plugin = 让 OpenClaw 能够连接外部平台的能力包

Channel（飞书、钉钉）是通过 Plugin 接入的工具（搜索、文件操作）也可以通过 Plugin 扩展

Plugin 是 OpenClaw 的基础设施扩展，而 Skill 是应用层扩展。

二、Plugin 和 Channel 的关系

很多人搞不清楚 Plugin 和 Channel 的关系：

Plugin（插件） = 实现某种能力的代码包 Channel（渠道） = 通过 Plugin 实现的"入口"

飞书 Channel ──由──→ openclaw-lark Plugin 实现钉钉 Channel ──由──→ dingtalk Plugin 实现企业微信 Channel ──由──→ wecom Plugin 实现

Channel 依赖 Plugin 才能工作。

三、你系统里安装的 Plugin

查看配置文件：

{
  "plugins": {
    "enabled": true,
    "installs": {
      "openclaw-lark": {        // 飞书插件
        "version": "2026.3.18"
      },
      "wecom": {                // 企业微信插件
        "version": "2026.3.19"
      },
      "dingtalk": {             // 钉钉插件
        "version": "3.3.0"
      },
      "dingtalk-connector": {   // 钉钉连接器
        "version": "0.8.0"
      },
      "qqbot": {               // QQ 机器人
        "version": "1.5.0"
      }
    }
  }
}

这些 Plugin 共同支撑了你系统现在的多渠道能力。

四、Plugin 和 Skill 的区别

这是最重要的区别，很多人搞混：

对比项	Plugin	Skill
层次	基础设施层	应用层
作用	让 OpenClaw 能连接某平台	告诉 AI 怎么用工具
类比	给大脑装上"眼睛"	教大脑"怎么看"
是否必须	某些功能必须安装 Plugin	可选，不装也能跑
配置方式	修改 `openclaw.json`	在 `skills/` 目录放文件
数量	几个到十几个	可以很多个

五、用一个例子说清楚

场景：你想让 AI 在钉钉群里发消息

Plugin 要做的事：

安装 dingtalk Plugin
    ↓
配置钉钉的 AppID 和 AppSecret
    ↓
Plugin 连接到钉钉服务器
    ↓
Channel 接收消息、发送消息

Skill 要做的事（如果你想自定义回复逻辑）：

写一个 dingtalk-skill.md
    ↓
告诉 AI："当用户在钉钉群里问XXX时，调用YYY工具"

Plugin = 让钉钉能连通 Skill = 告诉 AI 怎么用钉钉

六、Plugin 的来源

Plugin 有几种来源：

来源	说明	例子
官方内置	OpenClaw 自带	openclaw-lark
npm 安装	从 npm 仓库安装	@soimy/dingtalk
本地路径	自己写的或本地测试的	/home/spyc/qqbot
压缩包	打包好的插件文件	dashscope-cfg.tar.gz

七、安装 Plugin 的命令

OpenClaw 提供了插件管理命令：

# 查看已安装的插件
openclaw plugins list
# 安装插件
openclaw plugins install <插件名># 卸载插件
openclaw plugins uninstall <插件名>

八、Plugin 出问题了怎么办

如果某个 Channel 不工作，先检查 Plugin 状态：

# 检查 Gateway 状态 openclaw gateway status

# 查看插件加载情况 openclaw doctor

doctor 命令会检查所有 Plugin 的连接状态，并给出诊断报告。

九、常见问题

Q: Plugin 可以自己写吗？

A: 可以。需要了解 OpenClaw 的 Plugin SDK，类似于开发一个 App。

Q: Plugin 和 Skill 同时存在，优先级谁高？

A: Plugin 是底层能力，Skill 是应用层规则。AI 收到消息后，先看 Skill 匹配，再调用 Plugin 执行。

Q: Plugin 安装后不生效？

A: 重启 Gateway：openclaw gateway restart。Plugin 需要加载后才能使用。

Q: Plugin 冲突怎么办？

A: 检查 Plugin 加载顺序，有些 Plugin 有依赖关系，修改配置文件中的顺序可能解决。

十、下一步学什么

1.8 核心概念五：Skill（技能）是什么 → 深入理解 Skill，这是让 AI 真正"能做实事"的关键
第五章 Skill 开发 → 如何编写自己的 Skill

如有疑问，欢迎在群内提问！