技能目录的加载顺序与覆盖规则

Skill 不是给 OpenClaw 新超能力，而是教它把现有能力用得更像样。

想改默认 skill，不用去拆系统肚子。最简单的办法，就是在你自己的工作区里放一份同名版本，让它盖过去。

插件可以带 skill，但别以为它带来的就一定会生效。真正拍板的，还是前面那套“离工作区越近越优先”的规则。

插件带来的 skill 像随盒小卡片，本地 skill 像你自己写的班规。

• openclaw skills install <skill-slug>：像去小卖部点名买一盒技能，然后把它放到你当前项目桌上。
• openclaw skills update --all：像检查你桌上这些技能说明书是不是都出了新版，有的话就一起换新。
• clawhub sync --all：更像店员在整理货架、同步库存，不只是单纯给你装一个技能。

ClawHub 是找 skill 的地方，openclaw skills install 是把它拎回家的动作。

如果一个 skill 会碰高风险工具，或者输入来源不可靠，那就尽量让它在沙箱里跑。这样像让它在围栏里活动，不会满院子乱跑。

第三方 skill 要当代码看，不要当贴纸看。

• --- 到 --- 这一段：像技能盒子的封面标签，先写名字，再写它是干嘛的。
• name: image-lab：像在盒子外面写上这套本领叫什么。
• description: ...：像在盒子外面补一句“这盒东西大概是拿来做什么的”。
• user-invocable: true：像告诉系统“这个 skill 可不可以直接摆到前台，给用户自己点着用”。
• command-dispatch: tool：像说“这个按钮按下去别先开会讨论了，直接去叫那个工具干活”。

SKILL.md 就像技能身份证和使用说明写在同一张纸上。

• requires.bins：像检查“你要玩的这套工具，家里有没有那把扳手”。
• requires.env：像检查“这把门钥匙你带没带”。
• requires.config：像检查“这扇门是不是已经被允许打开”。
• primaryEnv：像告诉系统“如果你要找主钥匙，就优先找这一把”。

• "image-lab": { enabled: true }：像说“这盒技能今天可以上桌”。
• apiKey: {...}：像把保险柜钥匙交给这一个 skill 用，不是发给全世界看。
• env: { GEMINI_API_KEY: "..." }：像在这个 skill 开工前，把它需要的那张小纸条塞进口袋。
• config: { model: "nano-pro" }：像跟它说“你今天干活时，就按这个口味来”。

你可以把 skill 当现成玩具买回来，也可以在自己家里再给它调开关、贴标签、换电池。

• watch: true：像叫一个值日生盯着技能文件夹，一有变化就举手报告。
• watchDebounceMs: 250：像告诉值日生“别每一笔都喊，等 250 毫秒再统一说”，免得太吵。

改了 skill 想马上生效，要么开新会话，要么让 watcher 帮你中途换新名单。