🦞 OpenClaw Skills 完全指南

世界上有一种技能叫做OpenClaw Skills，它让AI学会使用工具——就像教一只龙虾用筷子，虽然过程艰难，但结果是优雅的。

📖 什么是 OpenClaw Skills？

OpenClaw Skills 是 OpenClaw 的技能系统，基于 AgentSkills 规范。每个 Skill 是一个文件夹，里面包含 SKILL.md 文件，告诉 AI 代理什么时候该用什么工具、怎么用。

你可以把它想象成 AI 的「使用说明书」——不是冷冰冰的 API 文档，而是手把手教学的「菜谱」。

🏗️ 技能加载优先级

OpenClaw 从多个位置加载技能，按优先级从高到低：

  1. Workspace Skills - <workspace>/skills（最高优先级）
  2. Project Agent Skills - <workspace>/.agents/skills
  3. Personal Agent Skills - ~/.agents/skills
  4. Managed/Local Skills - ~/.openclaw/skills
  5. Bundled Skills - OpenClaw 内置技能
  6. ExtraDirs - 通过配置添加的额外目录（最低优先级）

📂 SKILL.md 格式

一个标准的 SKILL.md 需要包含 YAML frontmatter：

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw": {
      "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"] },
      "primaryEnv": "GEMINI_API_KEY",
    },
  }
---

# 技能使用指南

当用户要求生成图片时，使用 `image_generate` 工具...

## 参数说明
- model: 选择图片生成模型
- prompt: 图片描述
...

🛡️ 权限控制与 gating

Skills 支持多种 gating 机制，控制技能何时可用：

  • requires.bins - 检查系统是否存在指定命令
  • requires.env - 检查环境变量是否存在
  • requires.config - 检查配置文件中的值
  • os - 指定技能适用的操作系统

⚡ OpenClaw 实战应用

场景 1：安装技能

openclaw skills install <skill-slug>
openclaw skills update --all

场景 2：配置技能

{
  "skills": {
    "entries": {
      "image-lab": {
        "enabled": true,
        "apiKey": { "source": "env", "provider": "default", "id": "GEMINI_API_KEY" }
      }
    }
  }
}

场景 3：自定义技能

在你的工作区创建 skills/my-custom-skill/SKILL.md，OpenClaw 会自动加载。

🔗 相关链接