OpenClaw Skills 系统详解：为你的 AI 助手赋予超能力

OpenClaw 的 Skills 系统是其最强大的扩展机制之一。通过 Skills，你可以为 AI Agent 增加新能力——从调用外部 API 到控制本地工具，从图像生成到代码执行。

什么是 Skills？#

OpenClaw 使用兼容 AgentSkills 规范的 Skill 目录来教 Agent 如何使用工具。每个 Skill 是一个包含 SKILL.md 文件的目录，SKILL.md 里有 YAML frontmatter 和使用说明。

OpenClaw 会加载内置 Skills 并叠加你的本地自定义 Skills。

Skills 加载位置与优先级#

Skills 从三个地方加载（优先级从高到低）：

1. 工作区 Skills：<workspace>/skills（最高优先级）
2. 托管/本地 Skills：~/.openclaw/skills
3. 内置 Skills：随安装包附带（最低优先级）

同名 Skill 时，高优先级的会覆盖低优先级的。

多 Agent 场景下的 Skills#

在多 Agent 架构中，每个 Agent 有自己的工作区，因此：

• Agent 专属 Skills：存放在该 Agent 的 <workspace>/skills，只对该 Agent 可见
• 共享 Skills：存放在 ~/.openclaw/skills，对同机器上的所有 Agent 可见
• 也可以通过 skills.load.extraDirs 配置额外共享目录

ClawHub：Skills 公共仓库#

ClawHub 是 OpenClaw 的公共 Skills 注册表，你可以在这里发现、安装、更新 Skills。

# 安装一个 Skill
clawhub install <skill-slug>

# 更新所有已安装的 Skills
clawhub update --all

# 同步（扫描并发布更新）
clawhub sync --all

SKILL.md 格式#

每个 SKILL.md 至少需要包含：

---
name: my-skill-name
description: 这个 Skill 的功能描述
---

（技能使用说明和指令）

可选的 frontmatter 字段：

• homepage：技能官网 URL
• user-invocable：是否作为用户斜杠命令暴露（默认 true）
• disable-model-invocation：是否从模型提示中排除（默认 false）
• command-dispatch：设为 tool 时，斜杠命令直接派发到工具，跳过模型

Skill 门控（按条件加载）#

通过 metadata 字段实现条件加载：

---
name: gemini-skill
description: 使用 Gemini CLI 进行编程辅助
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["gemini"], "env": ["GEMINI_API_KEY"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

metadata.openclaw.requires 支持的条件：

配置文件中启用/禁用 Skills#

在 ~/.openclaw/openclaw.json 中管理 Skills：

{
  "skills": {
    "entries": {
      "gemini-skill": {
        "enabled": true,
        "apiKey": "your-api-key",
        "env": {
          "GEMINI_API_KEY": "your-key-here"
        }
      },
      "some-other-skill": { "enabled": false }
    }
  }
}

Skills 自动热加载#

默认情况下，OpenClaw 监听 Skill 目录变化，SKILL.md 文件修改后自动刷新 Skills 列表：

{
  "skills": {
    "load": {
      "watch": true,
      "watchDebounceMs": 250
    }
  }
}

Token 消耗影响#

Skills 注入到系统提示中的 Token 成本是确定性的：

• 基础开销（有至少 1 个 Skill 时）：195 字符
• 每个 Skill：97 字符 + name/description/location 字段长度

计算公式：

安全注意事项#

• 将第三方 Skills 视为不可信代码，启用前务必仔细阅读
• 对不可信输入和高风险工具，优先使用沙箱运行
• skills.entries.*.env 和 skills.entries.*.apiKey 会将密钥注入到主机进程，注意保密

原文：Skills - OpenClaw | 来源：OpenClaw 官方文档