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(优先级从高到低):
~/.openclaw/workspace/skills/← 推荐放这里~/.openclaw/skills/← 所有 Agent 共享- 内置 Skill(系统自带)
Q3:怎么写 description 才能让 AI 准确匹配?
多写触发关键词,覆盖用户可能说的话。比如:
description: |
每日技术日报生成与推送。自动搜索当天技术热点新闻,
生成中文摘要日报,推送到 Slack 频道。
触发条件:用户要求生成技术日报、每日新闻摘要、技术热点汇总,
或定时任务触发每日日报生成。
关键词:日报、技术新闻、热点、每日摘要、tech digest。
Q4:Skill 写错了怎么办?
直接修改 SKILL.md 文件,保存后重启 OpenClaw 即可生效。不需要重新部署,不需要写代码。
🎯 总结一下
写 Skill 的五步法:
- 找到你重复做了 3 次以上的事
- 自己先手动跑通一遍完整流程
- 用大白话把流程写成 SKILL.md
- 重启测试,不行就改
- 觉得好用?分享到 ClawHub
你攒的 Skill 越多,AI 就越像你的私人员工。
今天就动手写你的第一个 Skill 吧!
🤝 加入 OpenClaw 交流群
📌 QQ 频道:OpenClaw 龙虾交流中心
频道号:pd42833652
📱 个人微信:添加栗子老师一对一答疑
微信号:xsl250lq
夜雨聆风