openclaw按优先级顺序加载技能：工作区路径（最高）、本地全局路径（中）、内置路径（最低），同名技能以高优先级路径版本为准；支持配置extradirs扩展路径，多代理环境下路径可见性依层级隔离或共享。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 OpenClaw 时发现某个 Skill 未被识别或被意外覆盖，则可能是由于技能加载路径配置与优先级规则未被正确理解。以下是 OpenClaw 技能加载路径及其优先级关系的详细说明：
一、OpenClaw 加载技能的三种核心路径
OpenClaw 按固定顺序扫描并加载技能，路径优先级从高到低严格分层，同名技能以高优先级路径中的版本为准。该机制确保用户定制可无侵入式覆盖系统默认行为。
1、工作区技能路径（最高优先级）：位于
2、本地全局技能路径（中优先级）：位于 ~/.openclaw/skills/。此目录下所有技能对本机全部代理（Agent）可见，适用于跨工作区复用的通用能力。
3、内置技能路径（最低优先级）：随 OpenClaw 安装包分发，嵌入于 npm 包或 OpenClaw.app 内部。仅当同名技能在前两级路径均不存在时才会启用。
二、额外技能目录的配置方式
除上述三类标准路径外，OpenClaw 支持通过配置文件声明额外技能扫描目录，其优先级低于本地全局路径，但高于内置技能，适用于团队共享技能包或私有插件集的集中管理。
1、编辑配置文件 ~/.openclaw/openclaw.json。
2、在 skills.load.extraDirs 字段中添加数组形式的路径列表，支持绝对路径与波浪线展开（如 "~/Projects/oss/some-skill-pack/skills"）。
3、确保路径末尾不带斜杠，且每个路径内含合法 Skill 目录结构（含 SKILL.md）。
4、保存后重启 OpenClaw 或触发热重载（若 skills.load.watch 设为 true）。
三、多代理环境下的路径可见性规则
在 Multi-Agent 场景中，不同代理对技能路径的访问权限存在隔离与共享双重机制，直接影响技能的实际可用范围。
1、工作区路径（
2、本地全局路径（~/.openclaw/skills/） 与 extraDirs 中声明的路径：二者均为全局共享，所有本机运行的代理均可加载和使用其中技能。
3、智能体内嵌路径（~/.openclaw/workspace/.agent/skills/）：该路径专属于特定 Agent 实例，优先级高于工作区路径，但仅对该 Agent 生效，不参与全局竞争。
四、同名技能冲突处理机制
当多个路径中存在名称完全一致的 Skill（由 SKILL.md 中 name 字段定义），OpenClaw 严格依据加载路径优先级执行覆盖，不合并、不报错、不提示。
1、系统首先完成全路径扫描，构建候选技能集合。
2、对每个 skillKey（默认为目录名，若 metadata.openclaw.skillKey 存在则以其为准）仅保留最高优先级路径下的实例。
3、低优先级路径中同名技能被静默忽略，不会出现在技能列表或斜杠命令补全中。
4、可通过 openclaw skills list --verbose 命令查看当前生效技能及其来源路径。
五、路径验证与调试方法
当技能未按预期加载时，需逐层确认路径有效性与结构合规性，避免因隐藏文件、权限或元数据错误导致加载失败。
1、检查目标路径是否存在且可读：ls -la ~/.openclaw/workspace/skills/my-skill/。
2、确认 SKILL.md 文件存在且头部 YAML Frontmatter 格式合法（单行 JSON，metadata 为有效对象）。
3、验证 name 字段值是否与调用时使用的 skillKey 一致（区分大小写）。
4、运行 openclaw skills validate my-skill 检查依赖项（bins/env/config）是否满足。
