Skills 是 OpenClaw 教 Agent 使用工具和流程的机制。一个 skill 通常是一个包含 SKILL.md 的文件夹，里面写明“什么时候使用、如何使用、注意什么”。
Skills 解决什么问题？
如果每次都在 Prompt 里解释工具用法，成本高且不稳定。Skills 把可复用知识沉淀成文件：
- 怎么调用某个 CLI
- 怎么配置某个 API
- 哪些任务应该使用特定工具
- 哪些安全边界不能越过
- 工作流的固定步骤是什么
这样 Agent 在需要时可以加载对应技能。
加载位置和优先级
OpenClaw 会从多个位置加载 skills，优先级大致是：
- 当前 workspace 的
skills/ - 当前 workspace 的
.agents/skills/ - 个人
~/.agents/skills/ - 共享
~/.openclaw/skills/ - OpenClaw bundled skills
- 额外配置的 skill folders
同名 skill 冲突时，高优先级覆盖低优先级。团队项目可以把项目专用技能放在 workspace 中，个人工具放在用户级目录。
Per-agent vs Shared Skills
多 Agent 环境中，每个 Agent 有自己的 workspace：
- per-agent skills：只影响该 Agent
- shared skills：机器上所有 Agent 可见
- project skills：当前项目优先加载
如果你有一个只给内容发布 Agent 使用的技能，应放在该 Agent 的 workspace；如果是通用工具技能，可以放在共享目录。
metadata gating
Skill 可以通过 metadata 声明依赖：
- 需要某个二进制存在
- 需要某个环境变量
- 需要某个配置项为真
- 只在特定 OS 生效
好处是：不满足条件的 skill 不会加载，避免 Agent 学到一个当前环境不可用的工具。
ClawHub 安装与更新
ClawHub 是 OpenClaw 的公开技能注册表。常见操作：
bash
openclaw skills install <skill-slug>
openclaw skills update --all安装后通常需要新会话或重启 gateway，让 Agent 重新加载技能。
安全注意事项
第三方 skill 本质上是会影响 Agent 行为的指令，不能盲目信任。
建议：
- 安装前阅读
SKILL.md - 对会执行命令的 skill 更谨慎
- 不把密钥写进 skill 正文
- 使用 config/env 注入敏感信息
- 对不可信输入使用沙箱
- 定期更新和清理不用的 skills
来源：OpenClaw 官方文档 - Skills | 整理：ClaudeEagle