教程 24

教程 24 — OpenClaw Skill Creator 教程:从零写出高质量 Skill 并发布到 ClawHub(2026)

目标:使用 Skill Creator Skill 的引导流程,从零编写一个高质量 Skill,并发布到 ClawHub 供全球用户安装。


Skill Creator 是什么?

@chindden/skill-creator 是 ClawHub 上用于创作 Skill 的元工具(59k 下载)。它本身是一个 Skill,安装后会提供一套交互式引导流程,帮你完成:

  • 确定 Skill 的名称、功能描述和触发关键词
  • 生成符合规范的 SKILL.md 文件
  • 配置工具调用(tool use)权限
  • 测试和调试
  • 打包发布到 ClawHub

写一个 openclaw skill 不需要会编程,Skill Creator 会把你的自然语言描述转换成规范格式。


第一步:安装 Skill Creator

/install @chindden/skill-creator

验证:

pnpm openclaw skills list
# 列表中应出现 skill-creator

第二步:启动创作流程

在 WebChat 或 Telegram 中发送:

/skill-creator

Skill Creator 会进入引导对话,依次询问:

1. 你的 Skill 要完成什么任务?(用一句话描述)
2. 用户会用什么关键词触发它?(如 /weather、/报天气)
3. 需要调用哪些工具?(搜索、浏览器、文件读写、HTTP 请求…)
4. 输出格式是什么?(纯文字、Markdown、代码块…)

按引导回答即可,Skill Creator 会在对话末尾生成完整的 SKILL.md 草稿。


第三步:了解 SKILL.md 格式规范

openclaw skill yaml 格式的核心文件是 SKILL.md,结构如下:

---
name: weather-daily
version: 1.0.0
description: 每日天气播报,获取指定城市未来 3 天天气并格式化输出
triggers:
  - /weather
  - /天气
  - 帮我查天气
tools:
  - web_search
  - http_request
outputs:
  - markdown
author: your-github-username
---
 
## 行为指令
 
当用户触发本 Skill 时:
1. 提取用户输入中的城市名称,默认使用"北京"
2. 调用 `web_search` 查询 "{城市} 未来3天天气预报"
3. 提取温度、天气状况、风力数据
4. 以 Markdown 表格格式输出,包含今天/明天/后天三列
5. 在表格下方附上穿衣建议(不超过 2 句)

openclaw skill 添加工具调用 tool use 只需在 tools 字段列出工具名,OpenClaw 会在运行时自动注入权限。


第四步:实战——手把手写"每日天气播报"Skill

启动 Skill Creator 后,按如下内容回答引导问题:

任务描述:
查询任意城市的未来 3 天天气,用表格展示温度和天气状况,
附上简短穿衣建议。

触发关键词:
/weather、/天气、"帮我查天气"、"今天天气怎么样"

需要的工具:
web_search(查询天气数据)

输出格式:
Markdown 表格 + 纯文字建议

Skill Creator 生成草稿后,确认内容并执行:

/skill-creator confirm

Skill Creator 会把 SKILL.md 写入本地 ~/.openclaw/skills/weather-daily/ 目录。


第五步:本地测试 Skill

Skill 写入后立即可以测试:

/weather 上海

如果输出不符合预期,发送修改指令:

/skill-creator edit weather-daily
修改:表格增加"降水概率"一列,穿衣建议改为中英文双语

Skill Creator 会更新 SKILL.md 并重新载入。调试 openclaw 自定义 skill 和内置 skill 的主要区别在于:自定义 Skill 可以随时修改,内置 Skill 需要等官方更新。


第六步:发布到 ClawHub

发布步骤:

1. 创建 GitHub 仓库,命名格式建议 openclaw-skill-weather

2. 在仓库根目录添加 clawhub.yaml

name: weather-daily
version: 1.0.0
description: 每日天气播报,支持任意城市,中英文双语输出
author: your-github-username
homepage: https://github.com/your-github-username/openclaw-skill-weather
skill_file: SKILL.md
tags:
  - weather
  - productivity
  - chinese

3. 把 SKILL.md 复制到仓库根目录,提交并推送:

git add SKILL.md clawhub.yaml
git commit -m "feat: initial release v1.0.0"
git push origin main

4. 在 ClawHub 提交审核

/skill-creator publish your-github-username/openclaw-skill-weather

clawhub 发布 skill 审核流程通常 24-72 小时,审核内容包括:Skill 是否执行恶意操作、工具调用权限是否过度申请、描述是否准确。


第七步:版本迭代

更新 Skill 时,修改 clawhub.yaml 中的 version 字段,重新推送并发布:

# 修改 clawhub.yaml: version: 1.1.0
git add .
git commit -m "feat: add precipitation column"
git push origin main

用户已安装的 Skill 会在下次 OpenClaw 启动时收到更新提示。


常见问题

写一个 OpenClaw Skill 需要会编程吗?

不需要。Skill 的核心是 SKILL.md 中的自然语言行为指令,Skill Creator 会引导你用对话的方式填写所有字段。工具调用(如搜索、HTTP 请求)只需在 tools 列表中声明,不需要写任何代码。如果你需要复杂的数据处理逻辑,可以在行为指令中用自然语言描述,OpenClaw 会自行解释执行。

发布到 ClawHub 的 Skill 有什么审核要求?

审核主要检查三点:第一,Skill 不能执行危险操作(如删除系统文件、访问敏感路径);第二,申请的工具权限必须与功能描述匹配,不能过度索取;第三,description 和行为指令必须准确描述 Skill 的实际功能,不能误导用户。通过审核后 Skill 会在 ClawHub 搜索中公开显示。

Skill Creator 和 Lesson 03 的自定义技能有什么区别?

教程 03 的自定义技能是直接修改 OpenClaw 配置文件中的 custom_skills 字段,适合简单的个人快捷指令,不能分发给他人。Skill Creator 创建的 Skill 有完整的 SKILL.md 规范格式,可以发布到 ClawHub 供全球用户安装,支持版本管理和工具权限声明,适合希望分享或商业化自己工作流的用户。

发布的 Skill 能设置成私有吗?

可以。在 clawhub.yaml 中设置 visibility: private,Skill 不会出现在公开搜索中。私有 Skill 只能通过直接链接(如 @your-username/skill-name)安装。团队内部使用的 Skill 建议设为私有,避免暴露内部工作流逻辑。


下一步

  • 教程 25 — 用 API Gateway Skill 零配置接入 100+ 外部服务
  • 教程 03 — 了解自定义技能的基础概念

关注我们,获取最新 AI 动态

在 X 上关注 @lanmiaoai,第一时间获取教程更新、AI 工具推荐。

立即关注