前言
ClawHub 上没有你想要的功能?自己写一个。
不需要会写代码,不需要懂 API,会写 Markdown 就够了。
这篇文章从头到尾走一遍:Skill 是什么、怎么写、怎么调试、写好了怎么发布。我自己在用的 trend-scout Skill 就是这么做出来的,全程拿它当真实例子。

很多人第一反应觉得 Skill 是浏览器插件那种东西——安装完有个程序在后台跑。
实际上不是。
Skill 更像是给 AI 的一份操作说明书。你在 里写清楚三件事:
- 什么时候用这个技能
- 用的时候按什么步骤走
- 最终输出什么格式
OpenClaw 的 AI 读到这份说明,遇到对应情况就知道该怎么处理了。
举个具体例子。
我给博客做了一个 trend-scout Skill,作用是定期扫描 V2EX、Hacker News、GitHub Trending、少数派、小众软件,找出适合写成文章的热门话题。
每次触发时,AI 读 里的流程,拉各个平台的数据,过滤掉不相关的内容,最后整理成选题建议发给我。
这个 Skill 没有「安装后台服务」这回事。它就是一个文件夹,里面有说明文档和几个辅助脚本。OpenClaw 启动时自动扫描 skills 目录,把找到的 Skill 注册进来,AI 就知道有这个能力了。
最简单的 Skill 长这样:
复杂一点,带脚本和参考资料:
GPT plus 代充 只需 145
放在哪里? 默认位置是 。OpenClaw 启动时自动扫描这个目录下的所有子文件夹,找到 就注册。放进去就生效,不需要手动配置。
一个标准的 分三个部分:frontmatter、触发条件、工作流程。
frontmatter 里最关键的是 。OpenClaw 在决定「要不要用这个 Skill」时,主要靠这段描述判断。
写清楚两件事:适合什么场景,以及不适合什么场景。后者经常被忽略,但很重要——AI 不知道边界的话,会在不该用的时候乱用。
GPT plus 代充 只需 145
用自然语言写就行,目的是让 AI 知道这个 Skill 的使用时机。
工作流程写得越具体,AI 执行得越准。 「拉数据、过滤、输出」这种三步骤太模糊,不如直接写跑哪个脚本、用什么 API、遇到什么情况用什么 fallback。
光看 trend-scout 这种复杂的可能有点晕,我再做一个最小版本演示。
需求: 每天早上自动生成一份简报,包含上海天气和 V2EX 热帖,推送到 Telegram。
第一步,建文件夹:
GPT plus 代充 只需 145
第二步,写 SKILL.md:
第三步,重启 gateway 让 Skill 生效:
GPT plus 代充 只需 145
然后在 Telegram 里对 OpenClaw 说「给我今天的简报」,它就会按 Workflow 里的步骤跑,拉天气、拉热帖、整合成格式推给你。
整个流程大概 10 分钟,没写一行逻辑代码。
如果想让它每天自动跑,加一条 cron:
纯文字说明有时候不够用。比如「批量拉 8 个平台的 API」,每次让 AI 手写 curl 太慢,结果格式也不统一。
这时候写一个辅助脚本,让 AI 直接调用就干净多了。
我的 干一件事:依次请求各平台,把结果存成 JSON 文件放到 ,再让 AI 读 JSON 来分析。
关键片段:
GPT plus 代充 只需 145
脚本放在 子目录,在 SKILL.md 的 Workflow 里直接引用路径:
AI 看到这行,会用 exec 工具直接跑这个脚本,不需要你再解释参数。
⚠️ 踩坑提醒: 脚本里如果用了 python3,要先确认服务器上装了。写完之后先手动跑一遍,确认输出正常,再写进 Skill。我当时 GitHub Trending 那段 HTML 解析代码跑不起来,排查了半天才发现是正则表达式写错了。
写完发现 AI 不用这个 Skill,或者用错了,检查这四个地方:
① description 写得太模糊
AI 判断要不要用 Skill,靠的是 frontmatter 里的 description。如果写「处理各种任务」这种宽泛的话,AI 不知道该不该用,通常选择不用。
改成「当用户说 XX 时使用,不适用于 XX」这种明确格式。
② 文件夹结构不对
必须直接放在 skills 子目录下,不能再嵌套一层。
- ✅ 正确:
- ❌ 错误:
③ 改完没重启
OpenClaw 在启动时扫描 skills 目录,改完 需要重启 gateway:
GPT plus 代充 只需 145
④ 脚本没有执行权限
如果 Skill 带了 shell 脚本,要给执行权限:
调试技巧: 直接在 OpenClaw 对话里说「用 daily-brief Skill 生成简报」,强制指定 Skill,看执行过程哪步出了问题。
Skill 写好了,如果觉得对别人也有用,可以发布到 ClawHub。
第一步,装 CLI:
GPT plus 代充 只需 145
第二步,在 Skill 文件夹里初始化:
它会问几个问题:Skill 名称、简介、版本号、分类。填完会生成一个 。
第三步,登录并发布:
GPT plus 代充 只需 145
发布成功后,别人就可以用 安装你的 Skill 了。
ClawHub 会做安全扫描(VirusTotal + OpenClaw 双重检测),通过后显示绿色安全标记。
⚠️ 发布前检查: 里有没有硬编码的个人信息——API Key、服务器 IP、个人路径——这些要替换成占位符或从环境变量读取。
踩坑之后总结的经验,直接拿去用:
① 流程步骤写命令,不写意图
「搜索相关资料」不如「用 web_search 搜索 ‘{关键词} site:github.com’」。前者 AI 会自由发挥,后者会按你说的做。
② 一定要加 NOT for
在 description 里写清楚这个 Skill 不适合什么场景,防止 AI 误触发。我的 trend-scout 里写了「NOT for: 分析已有流量数据」,就是因为最开始 AI 总是在我问流量数据的时候也跑这个 Skill。
③ Output Format 单独写一节
如果要求固定格式输出(比如推送 Telegram),把格式模板明确写出来,连 emoji 都可以指定,AI 会按格式来。
④ 辅助文件放 references/
不要把大段参考内容(比如 100 行的信息源列表)直接堆在 里,放到 子目录,在 Workflow 里引用路径。这样 保持简洁,AI 读起来也快。
自己写 Skill 门槛很低,主要是把流程想清楚、写清楚,剩下的交给 AI 执行。
想了解更多细节、获取专属支持,可访问一步API官网:https://yibuapi.com 或添加客服微信:xuexiv5876 YibuDev,随时咨询交流~
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/236737.html