开发自定义技能 – OpenClaw 教程

⏱️ 预计 30 分钟 📊 难度：进阶 ✅ 需要基础编程知识

OpenClaw 使用 AgentSkills 兼容的技能框架。每个技能是一个包含 SKILL.md 的目录。

1 技能目录结构

技能加载优先级：

<workspace>/skills/ - 当前 agent 专属
~/.openclaw/skills/ - 所有 agent 共享
内置技能 - 随 OpenClaw 安装

Terminal

mkdir -p ~/.openclaw/workspace/skills/my-skill

2 创建 SKILL.md

SKILL.md

---
name: my-skill
description: 我的自定义技能
metadata:
  { "openclaw": { "emoji": "🚀" } }
---

# 使用说明

当用户需要 xxx 时：
1. 步骤一
2. 步骤二

## 示例
...

3 添加门控条件（可选）

SKILL.md

---
name: my-skill
description: 需要 Python 的技能
metadata:
  {
    "openclaw": {
      "requires": {
        "bins": ["python3"],
        "env": ["MY_API_KEY"]
      }
    }
  }
---

4 配置技能参数

openclaw.json

{
  skills: {
    entries: {
      "my-skill": {
        enabled: true,
        env: { MY_API_KEY: "xxx" },
        config: { endpoint: "https://..." }
      }
    }
  }
}

5 测试技能

Terminal

openclaw skills list

新会话中技能自动加载。通过对话触发："请使用 my-skill 帮我..."

💡 更多技能：浏览 clawhub.com 发现社区技能。