ClawHub

ClawHub

ClawHub 是 OpenClaw Skills 與外掛的公開登錄檔。

• 使用原生 openclaw 命令搜尋、安裝及更新 Skills，並從 ClawHub 安裝外掛。
• 使用獨立的 clawhub 命令列介面進行登錄檔驗證、發布，以及刪除／取消刪除工作流程。

網站：clawhub.ai

快速開始

使用 OpenClaw 搜尋並安裝 Skills：

openclaw skills search "calendar"
openclaw skills install @openclaw/demo
openclaw skills update --all

使用 OpenClaw 搜尋並安裝外掛：

openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all

需要經登錄檔驗證的工作流程（例如發布或刪除／取消刪除）時，請安裝 ClawHub 命令列介面：

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

ClawHub 託管的內容

介面	儲存內容	常用命令
Skills	包含 SKILL.md 及支援檔案的版本化文字套件組合	openclaw skills install @openclaw/demo
程式碼外掛	包含相容性中繼資料的 OpenClaw 外掛套件	openclaw plugins install clawhub:<package>
套件組合外掛	用於 OpenClaw 發布的封裝外掛套件組合	clawhub package publish <source>

ClawHub 會追蹤語意化版本、latest 等標籤、變更記錄、檔案、下載次數、星號，以及安全性掃描摘要。公開頁面會顯示目前的登錄檔狀態，讓使用者能在安裝前檢查 Skill 或外掛。

原生 OpenClaw 流程

原生 OpenClaw 命令會安裝至目前使用中的 OpenClaw 工作區，並保存來源中繼資料，讓後續更新命令可繼續使用 ClawHub。

若外掛安裝應透過 ClawHub 解析，請使用 clawhub:<package>。在啟動切換期間，符合 npm 安全格式且未指定來源的外掛規格可能會透過 npm 解析；若必須明確指定來源，npm:<package> 則維持僅使用 npm。

在執行封存檔安裝前，外掛安裝會驗證宣告的 pluginApi 與 minGatewayVersion 相容性。套件版本發布 ClawPack 成品時，OpenClaw 會優先使用確切上傳的 npm-pack .tgz、驗證 ClawHub 摘要標頭與下載位元組，並記錄成品中繼資料以供後續更新使用。

ClawHub 命令列介面

ClawHub 命令列介面用於需要登錄檔驗證的工作：

clawhub login
clawhub whoami
clawhub search "postgres backups"
clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0
clawhub package explore --family code-plugin
clawhub package inspect episodic-claw
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin

命令列介面也提供 Skill 安裝／更新命令，可用於直接操作登錄檔的工作流程：

clawhub install @openclaw/demo
clawhub update @openclaw/demo
clawhub update --all
clawhub list

這些命令會將 Skills 安裝至目前工作目錄下的 ./skills，並將已安裝版本記錄於 .clawhub/lock.json。

發布

從包含 SKILL.md 的本機資料夾發布 Skills：

clawhub skill publish <path>

常用發布選項：

• --slug <slug>：已發布 Skill 的 URL 名稱。
• --name <name>：顯示名稱。
• --version <version>：語意化版本。
• --changelog <text>：變更記錄文字。
• --tags <tags>：以逗號分隔的標籤，預設為 latest。

從本機資料夾、owner/repo、owner/repo@ref 或 GitHub URL 發布外掛：

clawhub package publish <source>

使用 --dry-run 可建立確切的發布計畫而不上傳；使用 --json 則可取得適合 CI 的輸出。

程式碼外掛必須在 package.json 中包含必要的 OpenClaw 相容性中繼資料，包括 openclaw.compat.pluginApi 與 openclaw.build.openclawVersion。完整命令參考請參閱命令列介面，Skill 中繼資料請參閱 Skill 格式。

安全性與內容管理

ClawHub 預設為開放：任何人都能上傳，但發布者的 GitHub 帳號必須達到上傳門檻要求的註冊時間。公開詳細資料頁面會在安裝或下載前摘要顯示最新的掃描狀態。

ClawHub 會對已發布的 Skills 與外掛版本執行自動檢查。遭掃描暫緩或封鎖的版本可能會從公開目錄與安裝介面消失，但其擁有者仍可在 /dashboard 中查看。

已登入的使用者可以檢舉 Skills 與套件。內容管理員可以審查檢舉、隱藏或還原內容，以及封鎖濫用帳號。政策與執行細節請參閱安全性、安全性稽核、內容管理與帳號安全及可接受的使用方式。

遙測與環境

登入後執行 clawhub install 時，命令列介面可能會盡力傳送安裝事件，讓 ClawHub 計算彙總安裝次數。可透過以下設定停用：

export CLAWHUB_DISABLE_TELEMETRY=1

實用的環境覆寫設定：

變數	效果
CLAWHUB_SITE	覆寫用於瀏覽器登入的網站 URL。
CLAWHUB_REGISTRY	覆寫登錄檔 API URL。
CLAWHUB_CONFIG_PATH	覆寫命令列介面儲存權杖／設定狀態的位置。
CLAWHUB_WORKDIR	覆寫預設工作目錄。
CLAWHUB_DISABLE_TELEMETRY=1	停用安裝遙測。

如需更深入的參考資料，請參閱遙測、HTTP API及疑難排解。