本文面向在本倉庫中開發(fā)、調(diào)試、打包進(jìn)應(yīng)用、發(fā)布到 ClawHub 的 OpenClaw Skill。

官方參考：

• OpenClaw：Skills
• OpenClaw：ClawHub

1. Skill 是什么、裝在哪里

• 每個 Skill 是一個目錄，根目錄必須有 SKILL.md（YAML frontmatter + Markdown 正文）。
• 用戶機(jī)器上，TsClaw / OpenClaw 使用的安裝路徑為 ~/.openclaw/skills/<slug>/（Windows 下為配置目錄下的 skills\<slug>\，與 src-tauri 中 get_skills_dir() 一致）。
• 正文和示例命令里通常寫 node ~/.openclaw/skills/<slug>/scripts/...，便于代理在運行時找到腳本。

2.SKILL.mdfrontmatter（openclaw 會解析的部分）

TsClaw 會從 SKILL.md 里讀出 name、description、version（可選） 以及 metadata.openclaw，用于：

• 技能列表、搜索展示；
• 判斷是否缺 環(huán)境變量 / API Key（primaryEnv、requires.env、optional.env）；
• 判斷是否缺 PATH 二進(jìn)制（requires.bins），并給出 missingBins；
• 可選 install：聲明如何安裝缺失依賴（brew / npm 等），供安裝器/UI 使用。

2.1metadata.openclaw常見字段

與倉庫內(nèi)實現(xiàn)一致（見 src-tauri/src/commands/skills.rs 中 OpenClawMetaRaw / SkillMetadata）：

2.2 示例（摘自本倉庫bundled-skills）

需要 API Key 的 Skill：

---
name: openclaw-translate
description: >
  多語言翻譯…… Use when: … NOT for: …
metadata:
  openclaw:
    primaryEnv: BAIDU_TRANSLATE_APPID
    requires:
      env:
        - BAIDU_TRANSLATE_APPID
        - BAIDU_TRANSLATE_SECRET
---

純本地、無 Key 的 Skill：

---
name: tianshu-xhs-note
description: >
  … Use when: … NOT for: …
metadata:
  openclaw:
    primaryEnv: ""
---

2.3description怎么寫（給模型「何時調(diào)用」用）

本倉庫內(nèi) Skill 的慣例（可與 OpenClaw 文檔一起對照）：

1. 一句話能力 + Use when: 典型用戶說法/場景。
2. 可選 NOT for: 寫清不要誤用的邊界，減少錯誤觸發(fā)。
3. 正文里再寫 When to Run、Workflow、參數(shù)表、示例命令，與 frontmatter 呼應(yīng)。

3. 本地開發(fā)流程

3.1 目錄放哪

• 本倉庫：常在 skills/<slug>/ 下迭代（與 scripts/download-bundled-skills.mjs 的「項目內(nèi)副本」邏輯一致）。
• 真機(jī)聯(lián)調(diào)：把同名目錄拷到 ~/.openclaw/skills/<slug>/，或安裝一次后再改文件，保證 OpenClaw / 天樹 讀到的就是你在測的版本。

3.2 腳本與依賴

• 腳本放在 scripts/，用 Node 的可執(zhí)行方式調(diào)用（本倉庫大量 Skill 已 Node 化，見 skills/SKILLS_ANALYSIS.md）。
• 若需要 npm 依賴，在 Skill 目錄放 package.json，用戶或應(yīng)用側(cè)需在對應(yīng)目錄執(zhí)行 npm install（例如 wechat-article-search 對 cheerio 的處理，download-bundled-skills.mjs 里有兜底注入 package.json 的邏輯）。
• 文檔中的示例路徑統(tǒng)一為 ~/.tsclaw/skills/...，避免只寫相對路徑導(dǎo)致代理換 cwd 后找不到。

3.3 自檢清單

• SKILL.md frontmatter 能被解析：metadata.openclaw 存在且 YAML 合法。
• name 與目錄名 / ClawHub slug 一致或符合你的發(fā)布命名約定。
• 在目標(biāo)平臺實際跑一遍腳本（macOS / Windows 路徑、引號轉(zhuǎn)義、--text vs --file）。

4. 打進(jìn) OpenClaw 安裝包（bundled-skills）

4.1 同步到src-tauri/bundled-skills/

1. 將 slug 加入 scripts/download-bundled-skills.mjs 里的 SKILLS 數(shù)組（若需要隨發(fā)行版打包）。
2. 運行（需網(wǎng)絡(luò)拉 ClawHub 時）：npm run skills:bundled 或 node scripts/download-bundled-skills.mjs。
3. 本地優(yōu)先：腳本會優(yōu)先從 ~/.openclaw/skills/<slug> 復(fù)制，其次 倉庫/skills/<slug>，都沒有再請求 ClawHub。適合你先本地改好再一鍵拷進(jìn) bundled-skills。

4.2 靜默更新已安裝用戶的內(nèi)置副本

應(yīng)用啟動時會對比：

• 包內(nèi) src-tauri/bundled-skills/BUNDLED_SKILLS_REVISION 的修訂號；
• 用戶目錄 ~/.openclaw/.bundled-skills-sync-app-version 里記錄的上次同步修訂。

僅當(dāng)你希望已安裝用戶在不升應(yīng)用 semver 的情況下覆蓋內(nèi)置 Skill 時：遞增 BUNDLED_SKILLS_REVISION（當(dāng)前實現(xiàn)見 skills.rs 中 schedule_auto_install_bundled_skills 注釋）。

5. 發(fā)布到 ClawHub（上傳 Skill）

5.1 CLI

1. 安裝并登錄：npm install -g clawhub，執(zhí)行 clawhub login。
2. 在 Skill 目錄或倉庫路徑執(zhí)行發(fā)布，例如本倉庫腳本中的形式：

clawhub publish "skills/${slug}" \
  --slug "$slug" \
  --name "顯示名稱" \
  --version 1.0.0 \
  --changelog "說明本次變更"

或使用 npx（見 scripts/publish-aiznt-skills.mjs）：

npx --yes clawhub@latest publish <目錄> --slug ... --name ... --version ... --changelog ... --tags ...

部分 Skill 使用目錄內(nèi) clawhub.json 維護(hù) name / version / tags 等，再被發(fā)布腳本讀?。?code>aiznt-* 系列）。

5.2 網(wǎng)頁上傳

ClawHub 支持在瀏覽器上傳壓縮包：https://clawhub.ai/upload（需按站點要求登錄，如 GitHub）。

5.3 與本倉庫相關(guān)的限制與坑

6. 與本倉庫其他腳本的關(guān)系（按需）

7. 小結(jié)檢查清單

開發(fā)

• SKILL.md 含 metadata.openclaw，且 description 含 Use when / NOT for（按需）
• 腳本路徑、環(huán)境變量名與文檔一致
• 在 ~/.tsclaw/skills/<slug> 下實測通過

進(jìn)包

• slug 已加入 download-bundled-skills.mjs 的 SKILLS（若需要內(nèi)置）
• 需要靜默推送更新時遞增 BUNDLED_SKILLS_REVISION

上架 ClawHub

• clawhub login 成功，版本號/changelog 正確
• 注意新 slug 與小時間窗口限流，失敗時分批重試

到此這篇關(guān)于OpenClaw Skill開發(fā)與發(fā)布全流程解析的文章就介紹到這了,更多相關(guān)OpenClaw Skill開發(fā)與發(fā)布內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論