如何写一个 SKILL.md：OpenClaw 自定义技能完全指南

写一个 SKILL.md 是使用 OpenClaw 最有成就感的事之一——你可以把自己的工作流程教给 AI，让它完全按你的方式做事。而且完全不需要写代码，只要能用中文说清楚步骤就够了。

SKILL.md 是什么？

SKILL.md 是一个 Markdown 格式的指令文件，告诉你的 OpenClaw Agent 如何处理特定任务。当你发送的消息匹配技能的触发词时，Agent 会自动加载并执行这套指令。

可以把它理解为你写给 AI 的「标准操作手册（SOP）」。

基本文件结构

一个技能至少需要：

我的技能/
  SKILL.md

高级技能可以包含更多文件：

我的技能/
  SKILL.md           # 必须：主指令文件
  helper.py          # 可选：Python 辅助脚本
  template.md        # 可选：输出模板
  data.json          # 可选：参考数据

YAML Frontmatter（元数据）

每个 SKILL.md 最顶部是 YAML 格式的元数据，放在两个 --- 之间：

---
name: daily-report
description: 生成每日工作总结，包含完成事项、待办和重点信息
version: 1.0.0
author: your-name
triggers:
  - "今日总结"
  - "生成日报"
  - "帮我写日报"
  - "每日汇报"
dependencies:
  - calendar
  - gmail
---

字段说明：

字段	是否必须	说明
name	是	唯一标识符（小写字母+连字符）
description	是	技能功能描述（在 ClawHub 上显示）
version	建议填写	语义版本号（如 1.0.0）
triggers	建议填写	激活此技能的触发短语
dependencies	可选	此技能依赖的其他技能

指令区写法

frontmatter 之后，用 Markdown 写指令内容。结构要清晰：

# 每日日报技能

## 适用场景
当用户要求生成日报、每日总结或工作汇报时使用。

## 需要收集的信息
1. 今日完成了哪些工作（从日历和任务记录中获取）
2. 明日计划（询问用户或从日历获取）
3. 需要特别说明的事项（可选）

## 操作步骤
1. 检查日历技能，获取今日已完成的会议和事项
2. 询问用户：「今天还有哪些工作完成了？」
3. 询问用户：「明天有什么重点计划？」
4. 按照以下格式生成日报

## 输出格式

**每日工作总结 [日期]**

**✅ 今日完成：**
- [事项1]
- [事项2]

**📋 明日计划：**
- [计划1]
- [计划2]

**💬 备注：**
[特别说明，如无则填「无」]

## 注意事项
- 语言风格：正式、简洁
- 如果日历数据获取失败，跳过该部分并说明
- 总字数控制在 200 字以内

完整示例：价格谈判技能

以下是一个实用的技能示例——帮助自由职业者草拟涨价回复：

---
name: rate-negotiator
description: 帮助用户回复低价邀约，草拟专业的还价邮件
version: 1.0.0
triggers:
  - "帮我还价"
  - "这个报价太低了"
  - "草拟拒绝低价的回复"
  - "帮我谈单价"
---

# 报价谈判技能

## 适用场景
当用户收到低于期望的报价，需要专业地回复并提出反报价时。

## 操作步骤
1. 询问用户：对方报价多少？你的目标报价是多少？项目范围是什么？
2. 收集信息后，起草一封专业的反报价邮件：
   - 感谢对方的报价（简短，不过度）
   - 说明自己的价值/交付内容（聚焦结果，不是小时数）
   - 清楚报出反报价
   - 给对方一个「好说」的台阶（如：付款方式灵活）
3. 呈现草稿供用户确认，再做修改

## 语气原则
- 自信、专业，不道歉、不退缩
- 不说「我知道这可能有点贵」之类的话
- 重点强调你能带来的价值，而非你的成本

在哪里放你的技能

完成编写后，把技能文件夹放到：

• Mac/Linux: ~/.openclaw/skills/技能名称/
• Windows: %USERPROFILE%\.openclaw\skills\技能名称\

然后重启 OpenClaw：

openclaw restart

测试你的技能

1. 重启 OpenClaw 后，发 /skills 确认技能出现在列表中
2. 用触发词激活技能，看 Agent 是否按预期执行
3. 根据结果优化 SKILL.md，再次重启测试

反复迭代直到满意为止——这个过程不需要写代码，只需改写文字指令。

发布到 ClawHub（可选）

如果你想把技能分享给社区：

clawhub login
clawhub publish ./我的技能

ClawHub 团队会审核内容安全性，通常 1-3 个工作日内完成。审核通过后，全球 OpenClaw 用户都可以安装你的技能。

---

相关阅读：Skills 入门 · SOUL.md 配置指南