Skills

Skills 是 OpenClaw 教智能体使用工具的方式。它们遵循 AgentSkills 风格目录结构，核心文件是带 frontmatter 的 SKILL.md，并在加载时按环境、配置和二进制存在情况进行门控。

Skills 配置插件工具总览

加载位置与优先级

Builtin

内置 Skills

随安装包发布，优先级最低。

Hosted

~/.openclaw/skills

同一台机器上的所有智能体可共享，适合作为“全局本地 Skills 仓库”。

Workspace

<workspace>/skills

优先级最高，只对当前工作区 / 当前智能体生效。

最小格式

SKILL.md frontmatter

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

门控 metadata 示例

metadata:
  {
    "openclaw": {
      "requires": {
        "bins": ["uv"],
        "env": ["GEMINI_API_KEY"],
        "config": ["browser.enabled"]
      },
      "primaryEnv": "GEMINI_API_KEY"
    }
  }

关键规则

同名 Skills 冲突时，优先级是 workspace > ~/.openclaw/skills > 内置。

skills.load.extraDirs 可以增加额外的 Skills 扫描目录，但优先级最低。

第三方 Skills 要按不受信任代码对待，启用前先审阅内容；涉及高风险工具时优先结合沙箱隔离。