ClawHub：快速搜尋並安裝 OpenClaw 技能擴充功能

每次開發 AI Agent 時，最煩人的莫過於要從頭寫各種功能，或者在不同的專案間手動複製貼上那些好用的 Skill。如果你也曾為了管理這些擴充功能而感到頭大，ClawHub 就是為了解決這些痛點而生的。

ClawHub 是 OpenClaw skills 和 plugins 的公開 Registry。

使用原生的 openclaw 指令來搜尋、安裝、更新來自 ClawHub 的 skills 並安裝 plugins。
當你需要 Registry 認證、發佈、刪除、取消刪除或同步工作流時，請使用獨立的 clawhub CLI。

原生 OpenClaw 流程

Skills：

openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all

Plugins：

openclaw plugins install clawhub:<package>
openclaw plugins update --all

在嘗試 npm 之前，也會先針對 ClawHub 嘗試純 npm 安全的 plugin 規範：

openclaw plugins install openclaw-codex-app-server

原生的 openclaw 指令會安裝到你目前的作用中 workspace，並保留來源 metadata，以便後續的 update 呼叫能維持在 ClawHub 上。

什麼是 ClawHub

一個專為 OpenClaw skills 和 plugins 打造的公開 Registry。
一個具備版本控制的 skill bundle 和 metadata 儲存庫。
一個提供搜尋、標籤和使用訊號的探索介面。

運作原理

使用者發佈一個 skill bundle（檔案 + metadata）。
ClawHub 儲存該 bundle，解析 metadata 並分配版本號。
Registry 為該 skill 建立索引，以便進行搜尋和探索。
使用者在 OpenClaw 中瀏覽、下載並安裝 skills。

你可以做什麼

發佈新的 skills 以及現有 skills 的新版本。
透過名稱、標籤或搜尋來發現 skills。
下載 skill bundles 並檢查其中的檔案。
檢舉濫用或不安全的 skills。
如果你是管理員，可以執行隱藏、取消隱藏、刪除或封鎖。

誰適合使用（新手友善）

如果你想幫你的 OpenClaw agent 增加新功能，ClawHub 是尋找和安裝 skills 最簡單的方式。你不需要知道後端如何運作，你可以：

用白話文搜尋 skills。
將 skill 安裝到你的 workspace。
之後用一個指令就能更新 skills。
透過發佈來備份你自己的 skills。

快速上手（非技術人員）

搜尋你需要的東西：
- openclaw skills search "calendar"
安裝一個 skill：
- openclaw skills install <skill-slug>
開啟新的 OpenClaw session，它就會載入新的 skill。
如果你想發佈或管理 Registry 認證，也要安裝獨立的 clawhub CLI。

安裝 ClawHub CLI

只有在需要 Registry 認證的工作流（例如發佈或同步）時才需要這個：

npm i -g clawhub

pnpm add -g clawhub

與 OpenClaw 的整合方式

原生的 openclaw skills install 會安裝到作用中 workspace 的 skills/ 目錄。openclaw plugins install clawhub:... 則會記錄一個正常的受管 plugin 安裝，加上用於更新的 ClawHub 來源 metadata。

獨立的 clawhub CLI 也會將 skills 安裝到你目前工作目錄下的 ./skills。如果配置了 OpenClaw workspace，除非你覆寫 --workdir（或 CLAWHUB_WORKDIR），否則 clawhub 會退而使用該 workspace。OpenClaw 會從 <workspace>/skills 載入 workspace skills，並在下一次 session 中採用它們。如果你已經在使用 ~/.openclaw/skills 或內建 skills，workspace skills 會優先使用。

關於 skills 如何載入、共享和管控的更多細節，請參考 Skills。

Skill 系統概覽

Skill 是一個具備版本的檔案 bundle，用來教導 OpenClaw 如何執行特定任務。每次發佈都會建立一個新版本，Registry 會保留版本歷史紀錄，方便使用者審核變更。

一個典型的 skill 包含：

一個 SKILL.md 檔案，包含主要說明和用法。
該 skill 使用的可選配置、腳本或支援檔案。
Metadata，例如標籤、摘要和安裝要求。

ClawHub 利用 metadata 來驅動探索功能，並安全地展示 skill 的能力。Registry 也會追蹤使用訊號（例如星星和下載量）來改進排名和能見度。

服務提供的功能

公開瀏覽 skills 及其 SKILL.md 內容。
搜尋功能由 embeddings（向量搜尋）驅動，而不僅僅是關鍵字。
使用 semver 進行版本控制，包含變更日誌和標籤（包括 latest）。
每個版本提供 zip 格式下載。
星星與評論功能，用於社群回饋。
審核機制，用於核准和審核。
CLI 友善的 API，用於自動化和腳本編寫。

安全與審核機制

ClawHub 預設是開放的。任何人都可以上傳 skills，但 GitHub 帳號必須至少建立一週才能發佈。這有助於在不阻礙合法貢獻者的情況下減緩濫用。

檢舉與審核：

任何登入的使用者都可以檢舉 skill。
檢舉必須提供原因並會被記錄。
每個使用者同時最多可以有 20 個有效的檢舉。
擁有超過 3 個不重複檢舉的 skills 預設會被自動隱藏。
管理員可以查看隱藏的 skills、取消隱藏、刪除或封鎖使用者。
濫用檢舉功能可能導致帳號被封鎖。

有興趣成為管理員嗎？請在 OpenClaw Discord 中詢問並聯繫管理員或維護者。

CLI 指令與參數

全域選項（適用於所有指令）：

--workdir <dir>：工作目錄（預設：目前目錄；若無則退而使用 OpenClaw workspace）。
--dir <dir>：Skills 目錄，相對於 workdir（預設：skills）。
--site <url>：網站基礎 URL（瀏覽器登入）。
--registry <url>：Registry API 基礎 URL。
--no-input：停用提示（非互動模式）。
-V, --cli-version：印出 CLI 版本。

認證：

clawhub login（瀏覽器流程）或 clawhub login --token <token>
clawhub logout
clawhub whoami

選項：

--token <token>：貼上 API token。
--label <label>：瀏覽器登入 token 儲存的標籤（預設：CLI token）。
--no-browser：不開啟瀏覽器（需要 --token）。

搜尋：

clawhub search "query"
--limit <n>：最大結果數。

安裝：

clawhub install <slug>
--version <version>：安裝特定版本。
--force：如果資料夾已存在則覆寫。

更新：

clawhub update <slug>
clawhub update --all
--version <version>：更新到特定版本（僅限單一 slug）。
--force：當本地檔案與任何已發佈版本都不匹配時強制覆寫。

列表：

clawhub list（讀取 .clawhub/lock.json）

發佈 skills：

clawhub skill publish <path>
--slug <slug>：Skill slug。
--name <name>：顯示名稱。
--version <version>：Semver 版本。
--changelog <text>：變更日誌文字（可以為空）。
--tags <tags>：逗號分隔的標籤（預設：latest）。

發佈 plugins：

clawhub package publish <source>
<source> 可以是本地資料夾、owner/repo、owner/repo@ref 或 GitHub URL。
--dry-run：建立精確的發佈計畫而不上傳任何內容。
--json：為 CI 輸出機器可讀的內容。
--source-repo, --source-commit, --source-ref：當自動偵測不足時的可選覆寫項。

刪除/取消刪除（僅限擁有者/管理員）：

clawhub delete <slug> --yes
clawhub undelete <slug> --yes

同步（掃描本地 skills + 發佈新/更新的內容）：

clawhub sync
--root <dir...>：額外的掃描根目錄。
--all：不經提示上傳所有內容。
--dry-run：顯示將要上傳的內容。
--bump <type>：更新的類型 patch|minor|major（預設：patch）。
--changelog <text>：非互動式更新的變更日誌。
--tags <tags>：逗號分隔的標籤（預設：latest）。
--concurrency <n>：Registry 檢查的並行數（預設：4）。

Agent 的常用工作流

搜尋 skills

clawhub search "postgres backups"

下載新 skills

clawhub install my-skill-pack

更新已安裝的 skills

clawhub update --all

備份你的 skills（發佈或同步）

針對單一 skill 資料夾：

clawhub skill publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest

一次掃描並備份多個 skills：

clawhub sync --all

從 GitHub 發佈 plugin

clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
clawhub package publish https://github.com/your-org/your-plugin

程式碼 plugins 必須在 package.json 中包含必要的 OpenClaw metadata：

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./index.ts"],
    "compat": {
      "pluginApi": ">=2026.3.24-beta.2",
      "minGatewayVersion": "2026.3.24-beta.2"
    },
    "build": {
      "openclawVersion": "2026.3.24-beta.2",
      "pluginSdkVersion": "2026.3.24-beta.2"
    }
  }
}

進階細節（技術性）

版本控制與標籤

每次發佈都會建立一個新的 semver SkillVersion。
標籤（如 latest）指向某個版本；移動標籤可以讓你執行回滾。
變更日誌附加在每個版本上，在同步或發佈更新時可以為空。

本地變更 vs Registry 版本

更新時會使用內容雜湊（content hash）將本地 skill 內容與 Registry 版本進行比較。如果本地檔案與任何已發佈版本都不匹配，CLI 會在覆寫前詢問（或在非互動式執行中要求使用 --force）。

同步掃描與備用根目錄

clawhub sync 會先掃描你目前的工作目錄。如果沒找到 skills，它會退而搜尋已知的舊版位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。這是為了在不需要額外 flags 的情況下找到較舊的 skill 安裝。

儲存與 Lockfile

已安裝的 skills 會記錄在工作目錄下的 .clawhub/lock.json。
認證 tokens 儲存在 ClawHub CLI 配置檔案中（可透過 CLAWHUB_CONFIG_PATH 覆寫）。

遙測（安裝計數）

當你在登入狀態下執行 clawhub sync 時，CLI 會發送一個極小的快照來計算安裝次數。你可以完全停用此功能：

export CLAWHUB_DISABLE_TELEMETRY=1

環境變數

CLAWHUB_SITE：覆寫網站 URL。
CLAWHUB_REGISTRY：覆寫 Registry API URL。
CLAWHUB_CONFIG_PATH：覆寫 CLI 儲存 token/配置的位置。
CLAWHUB_WORKDIR：覆寫預設工作目錄。
CLAWHUB_DISABLE_TELEMETRY=1：在執行 sync 時停用遙測。

下一步：

深入了解 Skills 如何運作
探索 OpenClaw Gateway 的整合

有任何設定上的問題嗎？快來問問我們的 AI Setup Assistant！

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。