Skip to main content

​
技能

OpenClaw 使用与 AgentSkills 兼容 的技能文件夹来教导代理如何使用工具。每个技能是一个目录,包含带有 YAML 头信息和说明的 SKILL.md 文件。

​
位置与优先级

技能从 三个 位置加载:
1

内置技能

随安装包一起提供(npm 包或 OpenClaw.app)
2

托管/本地技能

~/.openclaw/skills
3

工作区技能

<workspace>/skills
如果技能名称冲突,优先级顺序为: <workspace>/skills(最高)→ ~/.openclaw/skills → 内置技能(最低)

​
ClawHub(安装 + 同步)

ClawHub 是 OpenClaw 的公共技能注册表,浏览网址:https://clawhub.com。 常用流程: 
# 在你的工作区安装技能
clawhub install <skill-slug>

# 更新所有已安装技能
clawhub update --all

# 同步(扫描 + 发布更新)
clawhub sync --all

​
访问控制(加载时过滤)

OpenClaw 在加载时根据 metadata(单行 JSON)过滤技能: 
---
name: nano-banana-pro
description: 通过 Gemini 3 Pro Image 生成或编辑图像
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

​
配置覆盖

内置/托管技能可以开启/关闭并提供环境变量: 
{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

​
安全提示

  • 第三方技能请视为 不受信任的代码,启用前务必阅读。
  • 对于不受信任输入和高风险工具,优先使用沙箱运行。

​
相关链接