OpenClaw Skills 工作原理与自定义

Skills 是 OpenClaw 扩展功能的核心。本文深入介绍 Skills 的工作原理以及如何自定义技能。

一、Skills 架构

1. 目录结构

skills/
└── my-skill/
    ├── SKILL.md        # 技能定义
    └── README.md        # 说明文档

2. SKILL.md 格式

---
name: my-skill
description: 这是一个示例技能
metadata:
  {
    "openclaw": {
      "requires": { "bins": ["curl"] }
    }
  }
---

# 技能说明

这个技能可以帮助你...

二、创建自定义 Skill

1. 基本结构

---
name: weather
description: 查询天气信息
metadata: { "openclaw": { "emoji": "🌤️" } }
---

## 使用方法

告诉我想查询哪个城市的天气

2. 配置环境变量

---
name: my-api-skill
description: 调用自定义 API
metadata:
  {
    "openclaw": {
      "requires": { "env": ["MY_API_KEY"] },
      "primaryEnv": "MY_API_KEY"
    }
  }
---

3. 配置二进制依赖

---
name: file-processor
description: 处理文件
metadata:
  {
    "openclaw": {
      "requires": { "bins": ["ffmpeg", "imagemagick"] }
    }
  }
---

三、技能加载位置

• 内置技能：随 OpenClaw 安装
• 本地技能：~/.openclaw/skills
• 工作区技能：workspace/skills

优先级：

工作区 > 本地 > 内置

四、配置技能

{
  "skills": {
    "entries": {
      "my-skill": {
        "enabled": true,
        "apiKey": { "source": "env", "provider": "default", "id": "MY_API_KEY" },
        "config": {
          "endpoint": "https://api.example.com"
        }
      }
    }
  }
}

五、调试技能

# 查看技能状态
openclaw skills list

# 测试技能
@openclaw /my-skill 参数

六、最佳实践

• 为技能编写清晰的说明文档
• 正确配置依赖要求
• 使用版本控制管理技能
• 定期更新和维护技能

七、总结

通过自定义 Skills，你可以将任何外部工具或 API 集成到 OpenClaw 中，极大扩展其功能。

本文由AI辅助整理发布