Get started
ClawHub 的運作方式
ClawHub 的運作方式
ClawHub 是 OpenClaw Skills 與外掛的登錄層。它讓使用者能夠探索套件、讓發布者能夠發布版本，並為 OpenClaw 提供足夠的中繼資料，以安全地安裝及更新這些套件。
登錄記錄
每個公開項目都是一筆登錄記錄，包含：
- 擁有者與 slug 或套件名稱
- 一個或多個已發布版本
- 中繼資料、摘要、檔案與來源註明
- 變更記錄與標籤資訊，例如
latest - 下載、安裝與加星號訊號
- 安全性掃描與審核狀態
項目頁面是使用者在安裝前，檢視某項 Skill 或外掛所宣稱功能的標準位置。
Skills
Skill 是以 SKILL.md 為核心的版本化文字套件組合。它可以包含支援檔案、範例、範本與指令碼。
ClawHub 會讀取 SKILL.md frontmatter，以瞭解 Skill 名稱、說明、需求、環境變數與中繼資料。準確的中繼資料十分重要，因為它能協助使用者決定是否安裝該 Skill，並協助自動化掃描偵測宣告行為與觀察到的行為之間是否不一致。
請參閱 Skill 格式。
外掛
外掛是已封裝的 OpenClaw 擴充功能。ClawHub 會儲存套件中繼資料、相容性資訊、原始碼連結、成品與版本記錄。
當 OpenClaw 從 ClawHub 安裝外掛時，會在安裝前檢查所宣告的相容性中繼資料。套件記錄可包含 API 相容性、最低閘道版本、主機目標、環境需求與成品摘要。
若要讓登錄成為唯一真實來源，請使用明確的 ClawHub 安裝來源：
openclaw plugins install clawhub:<package>發布
發布會建立一筆新的不可變版本記錄。發布者使用 clawhub 命令列介面進行需要驗證身分的登錄工作流程：
clawhub skill publish ./my-skillclawhub package publish <source> --family code-plugin --dry-runclawhub package publish <source> --family code-plugin請使用試執行，在上傳前預覽解析後的承載內容。接著，公開頁面會顯示已發布的中繼資料、檔案、來源註明與掃描狀態。
安裝與更新
OpenClaw 安裝命令會使用 ClawHub 作為套件來源：
openclaw skills install @openclaw/demoopenclaw plugins install clawhub:<package>OpenClaw 會記錄安裝來源中繼資料，以便日後更新時能解析同一個登錄套件。ClawHub 命令列介面也支援直接安裝及更新 Skill 的工作流程，適合希望在完整 OpenClaw 工作區之外使用登錄管理 Skill 資料夾的使用者。
安全性狀態
ClawHub 開放發布內容，但版本仍須經過上傳關卡、自動化檢查、使用者檢舉與管理員處置。
公開頁面會在掃描摘要可用時加以顯示。遭保留、隱藏或封鎖的內容可能會從公開搜尋與安裝流程中消失，但擁有者仍可看見這些內容以進行診斷。
請參閱安全性、安全性稽核、內容審核與帳號安全及可接受的使用方式。
API 存取
ClawHub 提供公開唯讀 API，可用於探索、搜尋、取得套件詳細資料與下載。第三方目錄可以使用這些 API，但必須連結回標準 ClawHub 項目、遵守速率限制，並避免暗示其獲得背書。
