OpenClaw 技能编写指北

技能是 OpenClaw 的扩展机制。写一个技能，就能让你的 AI 助手学会新能力。

技能目录结构

my-skill/├── SKILL.md          # 必需，核心配置文件├── scripts/          # 可选，可执行脚本├── references/       # 可选，参考文档└── assets/           # 可选，资源文件

只有 SKILL.md 是必需的，其他按需添加。

SKILL.md 格式

---name: my-skilldescription: 描述技能功能和触发条件tags: tag1, tag2---# 技能名称使用说明...

name

小写字母 + 连字符，如 pdf-toolkit、send-email。

description（关键）

这是触发技能的核心依据。写清楚两件事：

技能做什么
什么情况下触发

# 好的写法description: PDF处理工具。当用户需要合并PDF、拆分PDF、旋转PDF、提取文字时触发。# 差的写法description: 一个处理PDF的工具

正文内容

Markdown 格式，保持简洁：快速使用示例、参数说明、注意事项。

三种资源类型

scripts/ - 脚本

放可执行代码。适合需要精确执行、重复使用的逻辑。

scripts/├── process.py└── deploy.sh

脚本要处理错误，输出清晰结果。

references/ - 文档

放详细的参考材料。API 文档、数据库 schema、公司政策等。

references/└── api_docs.md

SKILL.md 里引用：

详见 [API文档](references/api_docs.md)

assets/ - 资源

放输出用的文件。模板、图片、字体等。

assets/└── email_template.html

安装技能

本地安装

# 查看工作目录openclaw config get workdir# 放到 skills 目录下cp-r my-skill ~/.openclaw/workspace/skills/

新会话自动加载。

ClawHub 安装

clawhub search pdfclawhub install pdf-toolkitclawhub list

实战示例

创建一个天气查询技能：

1. 创建目录

mkdir-p ~/.openclaw/workspace/skills/weather-query/scripts

2. SKILL.md

---name: weather-querydescription: 天气查询。当用户问天气、气温、明天天气、周末天气、要不要带伞时触发。---# 天气查询查询城市天气。## 使用python3 scripts/weather.py 城市

3. 脚本

#!/usr/bin/env python3import sys, urllib.request, jsoncity = sys.argv[1]iflen(sys.argv)>1else"北京"url =f"https://wttr.in/{city}?format=j1"with urllib.request.urlopen(url)as r:    data = json.loads(r.read().decode())    c = data['current_condition'][0]print(f"{city}: {c['temp_C']}°C, {c['weatherDesc'][0]['value']}")

4. 测试

python3 ~/.openclaw/workspace/skills/weather-query/scripts/weather.py 北京

新会话里问"北京天气"，自动触发技能。

常见问题

技能不生效？ 检查文件名是 SKILL.md（大写），检查目录位置，开始新会话。

如何调试？ 直接运行脚本或看日志：openclaw logs

要点总结

项	说明
SKILL.md	必需，核心文件
description	写清楚功能 + 触发条件
scripts	复用代码逻辑
references	存详细文档
assets	存输出资源

核心原则：简洁。只放必要信息，AI 不需要废话。

相关资源：docs.openclaw.ai | clawhub.com