Skip to content

skills-development.md

Latest commit

 

History

History
171 lines (122 loc) · 2.85 KB

skills-development.md

File metadata and controls

171 lines (122 loc) · 2.85 KB
Raw

OpenClaw 技能开发指南 🛠️

从零开始开发你的第一个 OpenClaw 技能

📋 目录

技能结构

一个完整的 OpenClaw 技能包含以下文件：

my-skill/
├── SKILL.md              # 必需 - 技能定义
├── README.md             # 推荐 - 详细说明
├── package.json          # 推荐 - 项目配置
├── .clawhubignore        # 可选 - 发布忽略规则
├── scripts/              # 推荐 - 脚本目录
│   ├── main.py           # 主脚本
│   └── utils.py          # 工具函数
├── references/           # 可选 - 参考文档
│   └── guide.md
└── assets/               # 可选 - 资源文件
    └── logo.png

SKILL.md 详解

基本格式

---
name: 技能名称
version: 1.0.0
description: 一句话描述技能功能
author: 作者名
tags: [标签 1, 标签 2, 标签 3]
---

# 技能名称

## 触发词

- 关键词 1
- 关键词 2
- 关键词 3

## 功能描述

详细描述技能的功能和用途...

## 使用方法

### 示例 1

用户：帮我做某事 AI: [技能自动触发]


### 示例 2

用户：另一个命令 AI: [技能响应]


## 配置项（可选）

如果技能需要配置：

```json
{
  "apiKey": "你的 API 密钥",
  "endpoint": "API 地址"
}

依赖项（可选）

  • Python 3.8+
  • requests 库
  • 其他依赖...

注意事项

  • 使用限制
  • 安全提醒
  • 其他需要注意的地方

更新日志

v1.0.0

  • 初始版本

### Frontmatter 字段说明

| 字段 | 必需 | 说明 |
|------|------|------|
| name | ✅ | 技能名称（唯一标识） |
| version | ✅ | 版本号（语义化版本） |
| description | ✅ | 简短描述 |
| author | ✅ | 作者名 |
| tags | ❌ | 标签列表，便于搜索 |
| license | ❌ | 许可证（默认 MIT） |

---

## 开发流程

### 步骤 1: 创建技能目录

```bash
# 在 workspace 中创建技能目录
mkdir -p ~/.openclaw/workspace/skills/weather-skill
cd ~/.openclaw/workspace/skills/weather-skill

步骤 2: 创建 SKILL.md

cat > SKILL.md << 'EOF'
---
name: weather-skill
version: 1.0.0
description: 天气查询技能
author: 你的名字
tags: [天气，查询，生活]
---

# 天气查询技能 🌤️

## 触发词

- 天气
- 气温
- 预报
- 下雨

## 功能描述

查询指定城市的当前天气和未来预报。

## 使用方法

用户：北京天气怎么样？ AI: [查询并返回天气信息]

用户：上海明天会下雨吗？ AI: [查询并返回预报]


## 注意事项

- 需要网络连接
- 数据来源于 wttr.in