快速入門

ClawHub 是 OpenClaw Skills 與外掛的登錄庫。

將項目安裝到 OpenClaw 時，請使用 OpenClaw。登入、發布、管理自己的清單，或使用登錄庫專屬工作流程時，請使用 clawhub 命令列介面。

尋找並安裝 Skill

從 OpenClaw 搜尋：

openclaw skills search "calendar"

安裝 Skill：

openclaw skills install @openclaw/demo

更新已安裝的 Skills：

openclaw skills update --all

OpenClaw 會記錄 Skill 的來源，讓後續更新能繼續透過 ClawHub 解析。

尋找並安裝外掛

從 OpenClaw 搜尋：

openclaw plugins search "calendar"

使用明確的 ClawHub 來源安裝由 ClawHub 託管的外掛：

openclaw plugins install clawhub:<package>

更新已安裝的外掛：

openclaw plugins update --all

若要讓 OpenClaw 透過 ClawHub 而非 npm 或其他來源解析套件，請使用 clawhub: 前綴。

登入以進行發布

安裝 ClawHub 命令列介面：

npm i -g clawhub# 或pnpm add -g clawhub

使用 GitHub 登入：

clawhub loginclawhub whoami

無頭環境可以使用來自 ClawHub 網頁 UI 的 API 權杖：

clawhub login --token clh_...

發布 Skill

Skill 是一個資料夾，其中包含必要的 SKILL.md 檔案，也可包含選用的支援檔案。

clawhub skill publish ./my-skill \  --slug my-skill \  --name "My Skill" \  --changelog "Initial release"

此命令會略過未變更的內容。新的 Skills 從 1.0.0 開始；後續變更會自動發布下一個修補版本。使用 --dry-run 進行預覽，或使用 --version 選擇明確的版本。

發布前，請檢查 SKILL.md 中的中繼資料。宣告必要的環境變數、工具及權限，讓使用者能在安裝前瞭解該 Skill 的需求。請參閱 Skill 格式。

對於包含多個 Skills 的儲存庫，可重複使用的 GitHub 工作流程會針對 skills/ 下的每個直接 Skill 資料夾呼叫 skill publish：

jobs:  preview:    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main    with:      dry_run: true

發布外掛

從本機資料夾、GitHub 儲存庫、GitHub ref 或現有封存檔發布外掛：

clawhub package publish <source> --family code-plugin --dry-runclawhub package publish <source> --family code-plugin

請先使用 --dry-run，在不發布的情況下預覽解析後的套件中繼資料、相容性欄位、來源歸屬及上傳計畫。

程式碼外掛必須在 package.json 中包含 OpenClaw 相容性中繼資料，包括 openclaw.compat.pluginApi 和 openclaw.build.openclawVersion。

安裝前檢查

安裝前，請使用 ClawHub 網頁或命令列介面詳細資料命令，檢查中繼資料、來源連結、版本、變更記錄及掃描狀態：

clawhub inspect @openclaw/democlawhub package inspect <package>

公開清單會顯示最新的掃描狀態。遭審核暫緩或封鎖的版本，在問題解決前可能會從搜尋及安裝介面中隱藏。