教程 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 工具推荐。

立即关注