ClawHub

ClawHub 是 OpenClaw 的公開技能庫。這是一個免費服務：所有技能都是公開的，任何人都可以瀏覽、分享和重複使用。一個技能就是一個包含 SKILL.md 檔案的資料夾（可搭配輔助文字檔案）。你可以在網站上瀏覽技能，也可以用 CLI 搜尋、安裝、更新和發布技能。

網站：clawhub.ai

ClawHub 是什麼

• OpenClaw 技能的公開登錄庫。
• 技能套件和元資料的版本化儲存區。
• 提供搜尋、標籤和使用量指標的探索介面。

運作方式

1. 使用者發布技能套件（檔案 + 元資料）。
2. ClawHub 儲存套件、解析元資料並指派版本號。
3. 登錄庫建立索引供搜尋和探索使用。
4. 使用者在 OpenClaw 中瀏覽、下載並安裝技能。

你可以做什麼

• 發布新技能和既有技能的新版本。
• 透過名稱、標籤或搜尋來探索技能。
• 下載技能套件並檢視其檔案。
• 檢舉不當或不安全的技能。
• 如果你是管理員，可以隱藏、取消隱藏、刪除或封鎖。

適合誰使用（新手友善）

如果你想為 OpenClaw 代理添加新功能，ClawHub 是最簡單的方式。你不需要了解後端如何運作，只需要：

• 用自然語言搜尋技能。
• 將技能安裝到你的工作區。
• 之後用一條指令更新技能。
• 發布你自己的技能作為備份。

快速上手（非技術人員）

1. 安裝 CLI（見下節）。
2. 搜尋你需要的東西：
   • clawhub search "calendar"
3. 安裝技能：
   • clawhub install <skill-slug>
4. 開啟新的 OpenClaw 工作階段讓它載入新技能。

安裝 CLI

擇一安裝：

npm i -g clawhub

pnpm add -g clawhub

與 OpenClaw 的整合方式

CLI 預設將技能安裝到目前工作目錄下的 ./skills。如果已設定 OpenClaw 工作區，clawhub 會以該工作區為後備，除非你用 --workdir（或 CLAWHUB_WORKDIR）覆寫。OpenClaw 從 <workspace>/skills 載入工作區技能，會在下一次工作階段中生效。如果你已使用 ~/.openclaw/skills 或隨附的技能，工作區技能的優先順序較高。

技能載入、共用和管控的詳細資訊請參閱 技能。

技能系統概覽

技能是一個版本化的檔案套件，教導 OpenClaw 如何執行特定任務。每次發布會建立新版本，登錄庫保留版本歷史供使用者稽核變更。

典型的技能包含：

• 一個 SKILL.md 檔案，描述主要說明和用法。
• 可選的設定、腳本或技能使用的輔助檔案。
• 元資料，如標籤、摘要和安裝需求。

ClawHub 利用元資料來驅動探索功能，並安全地公開技能的能力。登錄庫也追蹤使用量指標（如星號和下載次數）以改善排名和曝光度。

服務提供的功能

• 公開瀏覽技能及其 SKILL.md 內容。
• 搜尋由嵌入向量驅動（向量搜尋），不僅是關鍵字。
• 版本管理支援 semver、變更日誌和標籤（包括 latest）。
• 下載每個版本的 zip 檔。
• 星號和留言供社群回饋。
• 審核機制用於核准和稽核。
• CLI 友善的 API支援自動化和腳本。

安全性和審核

ClawHub 預設為開放。任何人都可以上傳技能，但 GitHub 帳號必須建立至少一週才能發布。這有助於減緩濫用，同時不阻擋正當的貢獻者。

檢舉和審核：

• 任何已登入的使用者都可以檢舉技能。
• 檢舉原因為必填並會被記錄。
• 每個使用者同時最多可有 20 個有效檢舉。
• 累積超過 3 個不同使用者的檢舉，技能預設會被自動隱藏。
• 管理員可以檢視隱藏的技能、取消隱藏、刪除或封鎖使用者。
• 濫用檢舉功能可能導致帳號被封鎖。

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

CLI 指令和參數

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

• --workdir <dir>：工作目錄（預設：目前目錄；後備為 OpenClaw 工作區）。
• --dir <dir>：技能目錄，相對於 workdir（預設：skills）。
• --site <url>：網站基底 URL（瀏覽器登入用）。
• --registry <url>：登錄庫 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）

發布：

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

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

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

同步（掃描本地技能 + 發布新增 / 更新）：

• clawhub sync
• --root <dir...>：額外的掃描根目錄。
• --all：不提示直接上傳全部。
• --dry-run：顯示將會上傳的內容。
• --bump <type>：更新時的版本遞增方式 patch|minor|major（預設：patch）。
• --changelog <text>：非互動更新的變更日誌。
• --tags <tags>：逗號分隔的標籤（預設：latest）。
• --concurrency <n>：登錄庫檢查並行數（預設：4）。

代理的常見工作流程

搜尋技能

clawhub search "postgres backups"

下載新技能

clawhub install my-skill-pack

更新已安裝的技能

clawhub update --all

備份你的技能（發布或同步）

單一技能資料夾：

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

一次掃描並備份多個技能：

clawhub sync --all

進階細節（技術面）

版本管理和標籤

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

本地變更與登錄庫版本的比對

更新時會透過內容雜湊將本地技能內容與登錄庫版本進行比對。如果本地檔案與任何已發布版本都不符，CLI 會在覆寫前詢問（或在非互動模式中需要 --force）。

同步掃描和後備根目錄

clawhub sync 先掃描目前的 workdir。如果找不到技能，會後備到已知的舊版位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。這是為了在不需要額外旗標的情況下找到舊的技能安裝。

儲存和鎖定檔案

• 已安裝的技能記錄在 workdir 下的 .clawhub/lock.json 中。
• 驗證 token 儲存在 ClawHub CLI 設定檔中（可透過 CLAWHUB_CONFIG_PATH 覆寫）。

遙測（安裝計數）

當你在登入狀態下執行 clawhub sync，CLI 會傳送最小化的快照以計算安裝次數。你可以完全停用：

export CLAWHUB_DISABLE_TELEMETRY=1

環境變數

• CLAWHUB_SITE：覆寫網站 URL。
• CLAWHUB_REGISTRY：覆寫登錄庫 API URL。
• CLAWHUB_CONFIG_PATH：覆寫 CLI 儲存 token / 設定的位置。
• CLAWHUB_WORKDIR：覆寫預設的 workdir。
• CLAWHUB_DISABLE_TELEMETRY=1：停用 sync 的遙測。