前言¶

在 skillhub.cn 上架技能，往往要同時處理幾件事：發佈目錄裏不能帶真實 API Key、CLI 在 Windows 與 WSL 下行爲不一致、路徑格式和登錄方式搞錯就會反覆 401。官方文檔分散在網頁與安裝說明裏，Agent 若缺少一份按步驟執行的筆記，容易漏檢或把運行環境路徑寫進公開包。

下面介紹社區 Skill「SkillHub.cn 技能發佈指南（OpenClaw 實戰版）」：它把在 skillhub.cn 一鍵發佈技能的完整流程寫進 SKILL.md，其他 Agent 按文檔執行即可，作者聲明無需再查其他資料。本文依據 SkillHub 頁面元數據與該 Skill 正文整理，供選型與安裝參考。

這是什麼¶

一句話定位：面向 skillhub.cn 的技能發佈 SOP（標準操作步驟）Skill，基於通用 SKILL.md 格式，強調「發佈包」與「運行包」分離。

• 座標：@user_310a65be/openclaw-skillhub-publish-guide
• 版本：2.0.0（來源：community）
• 分類：knowledge-management
• 發佈者：user_310a65be
• 標籤：requires_api_key=true（發佈與 CLI 登錄需要 SkillHub API Key / Token）
• 簡介：在 skillhub.cn 一鍵發佈技能的完整操作筆記，其他 Agent 照着做即可，無需查閱任何其他資料
• SkillHub 頁面：https://www.skillhub.cn/skills/user_310a65be/openclaw-skillhub-publish-guide
• 資源地址：https://api.skillhub.cn/user_310a65be/openclaw-skillhub-publish-guide

文檔內寫明實戰驗證過 deepseek-bridge、skill-sedimentation 等發佈案例（含 skillId），主體場景爲 OpenClaw 工作區 + Windows 下通過 WSL 調用 bash 腳本版 CLI。

核心功能¶

以下內容均來自該 Skill 正文，只列可覈對的能力點。

發佈包與運行包分離¶

原則：Token 從 credential vault 運行時讀取，不得寫入發佈包；公開平臺上傳的 Key 無法刪除。

Windows 下 CLI 選型說明¶

Skill 對比 npm 全局安裝（@astron-team/skillhub / clawhub，使用 --token）與 WSL bash 腳本安裝（curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --cli-only，使用 --key）。文檔結論：Windows 發佈應使用 WSL 腳本版 CLI，npm 版在 Windows 上易出現認證 401。

端到端發佈流程¶

文檔按步驟覆蓋：

1. WSL 內安裝 CLI（僅首次）
2. 在 https://skillhub.cn/dashboard/keys 創建 API key（格式 skh_xxx，僅顯示一次）
3. skillhub login --key <Token>（示例要求通過 wsl 調用）
4. 整理發佈包目錄（SKILL.md、核心腳本、可選 README.md）及 Frontmatter 模板
5. 代碼中 Key 用環境變量佔位（Python / JavaScript 示例）
6. 發佈前 5 項自檢清單（無硬編碼 Key、無真實路徑泄露等）
7. skillhub publish "<WSL 路徑>" --changelog "..."（路徑需爲 /mnt/d/... 形式）
8. 瀏覽器或 CLI 驗證；可選通過 sessions_send 通知 main Agent

常見錯誤對照表¶

Skill 內置錯誤信息、原因與處理（如 401 認證、未知 flag、409 slug 衝突、誤傳 skill.zip、路徑格式等），便於 Agent 按表排查。

安裝與啓用¶

SkillHub 通用安裝說明見 https://skillhub.cn/install/skillhub.md。先做 CLI 檢查，再裝到當前 Agent 的 skills 目錄（必須用 --dir，否則默認 ./skills/ 可能不被識別）。

檢查 / 安裝 SkillHub CLI¶

command -v skillhub && skillhub --version

未安裝時（完整安裝或僅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安裝本 Skill¶

網頁給出的安裝提示爲：按 skillhub.md 安裝座標 @user_310a65be/openclaw-skillhub-publish-guide。

skillhub install @user_310a65be/openclaw-skillhub-publish-guide --dir <當前 Agent 的 skills 目錄>

常用客戶端 skills 目錄（摘自官方安裝文檔）：

• Claude Code：~/.claude/skills/
• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或項目下 .agents/skills/

OpenClaw 及其變體使用各自工作區下的 skills 目錄；以你當前環境爲準。

安裝後讓 Agent 讀取該目錄下的 SKILL.md 即可加載發佈指南。發佈操作本身仍需 SkillHub API Key，並在 WSL 內完成登錄與 publish（見下文典型用法）。

典型用法¶

1. 登錄（Skill 內 Windows + WSL 示例）¶

在 SkillHub 控制台創建 Token 後，在 WSL 中執行（路徑以你機器上 which skillhub 爲準）：

wsl /home/huawei/.local/bin/skillhub login --key <你的Token>

成功時示例輸出包含當前賬號 @user_310a65be。

2. 準備發佈包 Frontmatter¶

---
slug: <slug>
displayName: <技能顯示名>
version: 1.0.0
summary: <一句話描述>
license: MIT
---

3. 發佈命令¶

路徑必須爲 WSL 可識別的 Unix 風格（文檔示例）：

wsl /home/huawei/.local/bin/skillhub publish "/mnt/d/openclaw-data/workspace/skills/<slug>" --changelog "首次發佈 v1.0.0"

若提示版本已存在，需先提高 SKILL.md 中的 version 再重試。

4. 驗證¶

瀏覽器打開文檔給出的技能頁模式，或使用帶 registry 的搜索命令（正文示例使用 https://skill.xfyun.cn/api/v1/skills.json）。

經過上面的步驟，Agent 可把「整理包 → 自檢 → publish → 驗證」串成固定流水線，而不是每次重新拼命令。

適用場景與注意¶

適合誰

• 在 OpenClaw 工作流裏維護技能、需要反覆向 skillhub.cn 發佈版本的開發者或 Agent
• 希望把發佈 checklist、CLI 坑位、錯誤表固化成 Skill，交給其他 Agent 執行的場景

限制與注意

• 文檔以 Windows + WSL 爲主線；Linux/macOS 用戶可借鑑流程，但需自行替換 wsl 前綴與路徑示例（如 /mnt/d/...、示例中的固定 home 路徑）。
• 標籤 requires_api_key=true：發佈前必須在控制台創建並妥善保存 Token；勿將 Token 寫入上傳的發佈包。
• Skill 內 credential vault、OpenClaw 會話通知等路徑與 API 與具體部署綁定，遷移環境時要改爲你自己的 vault 與 sessionKey。
• SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 1327 次，安裝計數爲 0；數據以平臺展示爲準，會隨時間變化。

結尾¶

若你的痛點是「公開上架技能時怕泄密、怕 CLI 認證失敗、怕路徑格式不對」，這份 OpenClaw 實戰版 Skill 把原則、步驟和排錯表寫進一份 SKILL.md，適合作爲團隊內 Agent 的發佈手冊。安裝座標 @user_310a65be/openclaw-skillhub-publish-guide，詳情見 https://www.skillhub.cn/skills/user_310a65be/openclaw-skillhub-publish-guide 。