OpenClaw Skills的加载优先级详解

在OpenClaw中，Skills（技能）的加载遵循明确的层级优先级规则。理解这一规则对于管理技能、解决冲突至关重要——当同名技能存在于不同位置时，系统只会加载优先级最高的那一个。

一、核心优先级顺序（由高到低）

Skills从以下三个核心位置加载，优先级顺序为：

1. 工作区 Skills（最高优先级）：路径为<workspace>/skills（例如~/.openclaw/workspace/skills）。这些技能仅供当前特定智能体使用，可实现精准的个性化能力控制。

2. 托管/本地 Skills（中等优先级）：路径为~/.openclaw/skills。这是所有智能体共享的全局技能目录，适合存放通用技能。

3. 内置 Skills（最低优先级）：随OpenClaw安装包自带，位于应用程序目录内。作为基础能力兜底。

总结规则：如果同一技能名称在多个位置存在，系统遵循工作区优先 > 托管目录优先 > 内置优先的覆盖逻辑。

二、额外加载路径（最低优先级）

除了上述三个核心位置，你还可以通过配置文件添加额外的技能文件夹，其优先级低于所有内置技能：

配置方法：在~/.openclaw/openclaw.json中设置skills.load.extraDirs数组。

{ "skills": { "load": { "extraDirs": ["~/Projects/my-skills", "/shared/skills"] } } }

三、单智能体 vs 多智能体的技能隔离

在多智能体（Agent Teams）场景下，优先级规则进一步延伸出共享与隔离的维度：

单智能体专有技能：放在<工作区>/skills中，仅供该智能体独享，优先级最高。

多智能体共享技能：放在~/.openclaw/skills中，同一机器上的所有智能体均可见，优先级中等。

团队通用技能包：可通过skills.load.extraDirs添加共享文件夹，供多个智能体使用，优先级最低。

四、插件发布的Skills

插件（Plugins）可以在启用时发布自己的技能，这些技能参与正常的优先级规则：

加载时机：插件启用时动态加载。

优先级判定：同样遵循工作区 > 托管 > 内置的优先级顺序。插件技能本质上相当于动态添加到相应位置的技能。

五、门控过滤：加载前的条件筛选

除了位置优先级，Skills在加载时还会经过门控机制过滤。只有满足条件的技能才会进入最终的“有资格加载”列表：

门控条件（在SKILL.md的metadata中定义）：

requires.bins：需要系统中存在特定命令行工具（如curl）。

requires.env：需要设置特定环境变量。

requires.config：需要配置文件中某选项为真值。

os：限制仅在特定操作系统（darwin/linux/win32）上加载。

特殊标记：若设置always: true，则跳过所有门控检查，始终包含该技能。

无metadata情况：如果没有定义任何门控条件，该技能始终有资格加载（除非被配置禁用）。

六、配置覆盖：在加载后禁用或注入环境变量

即使技能通过了位置优先级和门控过滤，你仍然可以在配置文件中对单个技能进行最终控制：

在~/.openclaw/openclaw.json的skills.entries下配置：

enabled: false：强制禁用该技能，无论它位于何处。

env / apiKey：为技能注入所需的环境变量。

注意：配置键默认匹配技能名称。如果技能定义了metadata.openclaw.skillKey，则需使用该键名。

七、会话快照与生效时机

了解加载优先级后，还需知道何时生效：

会话快照：OpenClaw在会话开始时对当前所有有资格的Skills进行快照，并在整个会话期间复用该列表。

更改生效：对Skills文件、配置或门控条件的更改，不会影响当前进行中的会话，需要启动一个新会话才会加载更新后的技能列表。

热重载（启用监视器时）：如果启用了Skills监视器（skills.load.watch: true），刷新后的技能列表会在下一个智能体轮次被获取。

八、完整优先级总结（流程图）

结合以上所有机制，一个技能最终是否被加载、加载的是哪个版本，由以下多级决策共同决定：

第1级 - 位置优先级：工作区技能 > 托管技能 > 内置技能（同名时高优先级覆盖低优先级）。

第2级 - 门控过滤：检查bins/env/config/os等条件，不满足则无资格加载。

第3级 - 配置覆盖：skills.entries中若设置enabled: false，则最终禁用。

第4级 - 生效时机：上述决策在新会话开始时生效（或热重载时下一轮次生效）。

《夸克》非常好用的免费AI浏览器

下载APP查看