Skills（技能）是 OpenClaw 的模块化扩展系统。每个 Skill 是一个包含 SKILL.md 的目录，用来告诉 Agent 在什么场景下如何调用工具。

Skills 如何工作

SKILL.md (Markdown 指令) -> 加载到 Agent 系统提示 -> Agent 按规则调用工具

Skills 不是传统插件，不需要编译。核心价值是把可复用流程沉淀为可审阅、可版本化的 Markdown 指令。

三种技能来源与优先级

来源路径优先级
工作空间技能<workspace>/skills/最高
本地安装技能~/.openclaw/skills/中
内置技能OpenClaw 安装包低

安装第三方技能（ClawHub）

ClawHub 已有 1700+ 社区技能，可直接安装。

clawhub install <skill-slug>
clawhub install <skill-slug> --version 1.2.0
clawhub update --all
clawhub list

安全检查（必须做）

公开市场存在恶意 Skills 风险，安装前请先审查 SKILL.md 与来源可信度。

  • 优先官方或社区验证过的技能。
  • 不信任技能放到沙箱环境运行。
  • 不要在 Skill 文本里硬编码 Token 或私钥。

技能配置示例

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: { extraDirs: ["~/my-skills"] },
    entries: {
      "nano-banana-pro": {
        enabled: true,
        env: { GEMINI_API_KEY: "xxx" }
      },
      "sag": { enabled: false }
    }
  }
}

自定义 Skill 最小模板

---
name: my-greeting
description: 自定义问候技能
---

当用户说“打招呼”时：
1. 根据时间输出问候语
2. 优先使用用户名称呼
3. 保持简短友好