乐于分享
好东西不私藏

一文读懂OpenClaw:Skill/Tool/Plugin/Extension,还有插件路径全解析

一文读懂OpenClaw:Skill/Tool/Plugin/Extension,还有插件路径全解析

先搞懂核心:四大概念的底层逻辑

咱们把OpenClaw比作一只可进化的智能小龙虾,原本只有钳子、触须、基础肢体,通过各类模块不断升级能力,四大概念的区别一眼就能看清:

1. Plugin / Extension:自身长出的「新器官」

核心定位:属于OpenClaw原生能力扩展,是身体的一部分,而非外部物品。
在OpenClaw体系里,Plugin和Extension几乎同义,不用刻意区分,统一指代「能力扩展模块」。
通俗比喻:小龙虾原本只有笨拙的钳子,长出一双灵巧的人手,这双手就是Plugin/Extension;像qqbot、wecom这类通讯模块,也属于这类「原生器官」。

2. Tool:可以借用的「外部道具」

核心定位:独立于OpenClaw之外的外部资源,自身无法主动使用,必须依托对应器官(Plugin)才能调用。
通俗比喻:剪刀、彩笔、API接口、文件系统都属于Tool。小龙虾没有「灵巧人手」这个Plugin时,根本拿不起剪刀;有了对应器官,才能操控外部工具完成操作。

3. Skill:完成任务的「行为逻辑」

核心定位:不是器官、也不是工具,而是调度器官+工具完成目标的整套流程,支持嵌套复用。
通俗比喻:想用纸做手工,需要眼睛观察、人手操作、肢体配合,这套连贯动作就是「做手工Skill」;更复杂的「哄孩子Skill」,还能直接调用「做手工Skill」「做鬼脸Skill」,实现技能组合。

一句话总结关系

Plugin/Extension是身体硬件

Tool是外部道具

Skill是指挥硬件+道具做事的大脑指令

实操必看:OpenClaw插件路径与安装机制

概念理清后,落地安装插件时,目录存放、发现规则是高频疑问,这里把精准规则整理完毕,直接照着用就行。

一、两大核心目录:分工完全不同

OpenClaw设置了两个关键插件目录,一个系统托管,一个用户自定义,千万别混用:
✅ extensions/目录:系统自动管理的「标准插件库」
  • 核心用途:npm/命令行安装的插件专属目录,全程自动托管,无需手动干预
  • 默认安装路径:OpenClaw插件默认安装地址就是该目录
  • 存放内容:通过openclaw plugins install命令安装的插件;qqbot、wecom等npm安装的官方/社区插件;自动管理的依赖、版本和标准化结构
✅ plugins/目录:用户手动管理的「自定义插件库」
  • 核心用途:留给用户自主放置插件的目录,适合个性化场景
  • 适用场景:开发调试中的插件、本地修改后的定制插件、特殊用途的专属插件
  • 目录为空说明:当前没有手动放置任何自定义插件

二、插件发现机制:自动搜索全路径

OpenClaw会主动扫描多个路径加载插件,不用手动配置,搜索顺序如下:
  1. extensions/ 目录(默认安装目录)
  2. plugins/ 目录(用户手动目录)
  3. workspace 工作区根目录
  4. 全局扩展根目录
  5. 系统内置扩展模块

核心要点速记(收藏这部分就够)

  • Plugin/Extension:自身器官,能力扩展,存放在extensions/
  • Tool:外部工具,依托插件才能使用
  • Skill:执行流程,调度器官+工具完成任务,支持嵌套
  • extensions/:命令安装、系统托管,qqbot/wecom都在这
  • plugins/:手动放置、自定义开发,空目录代表无本地插件
看完这篇,是不是彻底理清OpenClaw的核心概念和插件规则啦?后续实操遇到插件安装、调用问题,对照这篇文章就能快速排查~

互动时刻:你在使用OpenClaw时,还遇到过哪些概念困惑?欢迎留言交流~