乐于分享
好东西不私藏

OpenClaw Skill 编写从零到一|喂饭级教程,小白也能学会

OpenClaw Skill 编写从零到一|喂饭级教程,小白也能学会

OpenClaw Skill 编写从零到一|喂饭级教程,小白也能学会

你是不是也有这样的烦恼:

部署了 OpenClaw,让它帮你干活,但每次都要重复说同样的话——”帮我搜热点”、”帮我写文章”、”帮我发公众号”……说了一遍又一遍,AI 还是记不住流程。

今天教你一个方法:写一个 Skill,让 AI 一次性记住所有流程,以后一句话就能触发。

更重要的是——不用写代码。只要你会写 Markdown,就能给 AI 加技能。

🌰 举个栗子:我给自己的 Agent 写了一个”公众号文章生成器”Skill,现在每天自动搜热点、写文章、排版、存草稿箱,全程不用动手。这个 Skill 的 SKILL.md 文件,就是用大白话写的操作手册。

📦 你需要准备什么?

  • 一台电脑(Mac / Windows / Linux 都行)
  • 已经部署好的 OpenClaw(不会部署?看公众号历史文章
  • 一个文本编辑器(VS Code、记事本、Typora 都行)
  • 会写 Markdown(不会?5 分钟就能学会)

准备好了吗?我们开始。

🎯 第一步:搞懂 Skill 是什么

结论先行:Skill 就是一份写给 AI 的操作手册。

你可以把它想象成你给新来的实习生写的工作流程文档:

  • 第一步做什么
  • 第二步做什么
  • 遇到什么情况怎么处理
  • 最后输出什么格式

AI 读到这份文档后,就会按照你写的流程执行任务。

⚠️ 重要区分:Skill 不是代码,不是插件,不是 API。它就是一个 Markdown 文件,用大白话告诉 AI “遇到什么情况,该做什么事”。

📁 第二步:创建 Skill 目录

打开终端,输入以下命令:

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

这行命令的意思是:在你的 OpenClaw 工作区里,创建一个叫 my-first-skill 的文件夹。

一个标准的 Skill 目录长这样:

my-first-skill/
├── SKILL.md          ← 必须有!这是给 AI 看的操作手册
├── scripts/          ← 可选:放辅助脚本
├── references/       ← 可选:放参考文档
└── assets/           ← 可选:放模板、图片等资源

只有 SKILL.md 是必须的,其他目录按需创建。

✍️ 第三步:写 SKILL.md(核心步骤)

用文本编辑器打开 SKILL.md,写入以下内容:

---
name: my-first-skill
description: |
  我的第一个 Skill。当用户说"帮我做 XXX"时触发。
  触发关键词:XXX、做 XXX、自动 XXX。
---

# My First Skill

## 触发条件
当用户说"帮我做 XXX"时,执行以下流程。

## 执行步骤

### 第一步:确认需求
问用户:你想做 XXX 的什么?

### 第二步:搜索素材
用 tavily_search 搜索相关内容。

### 第三步:生成结果
根据搜索结果,生成用户需要的内容。

### 第四步:输出格式
用 Markdown 格式输出,包含标题、正文、参考链接。

## 注意事项
- 不要说"您好"等客服用语
- 控制在 3-5 句话内
- 遇到问题立刻问用户

拆解一下:

🔹 YAML 头部(— 之间的部分)

  • name:Skill 的名字,必须和文件夹名一致
  • description:告诉 AI “什么时候该用这个 Skill”。写得越精准,AI 匹配越准确

⚠️ 踩坑提醒:description 写不准,AI 根本匹配不到你的 Skill,等于白做!多写几个触发关键词,覆盖用户可能说的话。

🔹 Markdown 正文

正文就是给 AI 的操作指令,用大白话写就行:

  • 触发条件:什么时候用这个 Skill
  • 执行步骤:第一步、第二步、第三步……
  • 注意事项:边界情况、禁忌、输出格式要求

🧪 第四步:测试 Skill

保存文件后,重启 OpenClaw:

openclaw gateway restart

然后在聊天里说触发词,比如”帮我做 XXX”,看看 AI 是否按你写的流程执行。

💡 调试技巧:如果 AI 没触发你的 Skill,检查 description 里有没有包含用户说的关键词。如果触发了但执行不对,检查步骤写得够不够清晰。

🚀 第五步:分享你的 Skill

觉得好用?可以分享到 ClawHub(OpenClaw 的技能市场),让全世界都能用:

# 提交到 ClawHub
openclaw skills publish my-first-skill

也可以直接发给朋友,让他们把文件夹复制到 ~/.openclaw/workspace/skills/ 目录下就能用。

❓ 常见问题

Q1:Skill 和 MCP 有什么区别?

MCP 是连接外部工具的标准协议(比如连接数据库、API),解决”能不能连”的问题。
Skill 是教 AI 如何使用工具完成任务,解决”怎么做”的问题。

简单说:MCP 是”手”,Skill 是”操作手册”。

Q2:Skill 放在哪里?

OpenClaw 会从以下位置扫描 Skill(优先级从高到低):

  1. ~/.openclaw/workspace/skills/ ← 推荐放这里
  2. ~/.openclaw/skills/ ← 所有 Agent 共享
  3. 内置 Skill(系统自带)

Q3:怎么写 description 才能让 AI 准确匹配?

多写触发关键词,覆盖用户可能说的话。比如:

description: |
  每日技术日报生成与推送。自动搜索当天技术热点新闻,
  生成中文摘要日报,推送到 Slack 频道。
  触发条件:用户要求生成技术日报、每日新闻摘要、技术热点汇总,
  或定时任务触发每日日报生成。
  关键词:日报、技术新闻、热点、每日摘要、tech digest。

Q4:Skill 写错了怎么办?

直接修改 SKILL.md 文件,保存后重启 OpenClaw 即可生效。不需要重新部署,不需要写代码。

🎯 总结一下

写 Skill 的五步法:

  1. 找到你重复做了 3 次以上的事
  2. 自己先手动跑通一遍完整流程
  3. 用大白话把流程写成 SKILL.md
  4. 重启测试,不行就改
  5. 觉得好用?分享到 ClawHub

你攒的 Skill 越多,AI 就越像你的私人员工。

今天就动手写你的第一个 Skill 吧!

🤝 加入 OpenClaw 交流群

📌 QQ 频道:OpenClaw 龙虾交流中心
频道号:pd42833652

📱 个人微信:添加栗子老师一对一答疑
微信号:xsl250lq