Skills

ClawHub

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

使用原生 openclaw 指令來搜尋、安裝與更新 Skills，以及從 ClawHub 安裝 Plugin。
使用獨立的 clawhub CLI 進行登錄檔驗證、發布、刪除/還原刪除與同步工作流程。

快速開始

搜尋

openclaw skills search "calendar"

安裝

openclaw skills install <skill-slug>

使用

啟動新的 OpenClaw 工作階段 - 它會載入新的 skill。

發布（選用）

若要使用需登錄檔驗證的工作流程（發布、同步、管理），請安裝獨立的 clawhub CLI：

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

原生 OpenClaw 流程

Skills

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

原生 openclaw 指令會安裝到你的作用中工作區，並保留來源中繼資料，讓之後的 update 呼叫可持續使用 ClawHub。

Plugins

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

plugins search 會查詢 ClawHub Plugin 目錄，並列印可直接安裝的套件名稱。當你想使用 ClawHub 解析時，請使用 clawhub:<package>。在啟動切換期間，裸露的 npm 安全 Plugin 規格會從 npm 安裝：

openclaw plugins install openclaw-codex-app-server

npm:<package> 也僅限 npm，當規格可能產生歧義時很有用：

openclaw plugins install npm:openclaw-codex-app-server

Plugin 安裝會在封存安裝執行前驗證宣告的 pluginApi 與 minGatewayVersion 相容性，因此不相容的主機會提早安全失敗，而不是部分安裝套件。當套件版本發布 ClawPack 成品時， OpenClaw 會優先使用精確上傳的 npm-pack .tgz、驗證 ClawHub digest 標頭與下載位元組，並記錄成品類型、npm integrity、npm shasum、tarball 名稱與 ClawPack digest 中繼資料，供之後更新使用。沒有 ClawPack 中繼資料的舊版套件仍使用舊版套件封存驗證路徑。

ClawHub 是什麼

OpenClaw Skills 與 Plugin 的公開登錄檔。
Skill 套件組與中繼資料的版本化儲存區。
用於搜尋、標籤與使用訊號的探索介面。

典型的 skill 是一個版本化檔案套件組，包含：

含主要描述與用法的 SKILL.md 檔案。
Skill 使用的選用設定、指令碼或支援檔案。
標籤、摘要與安裝需求等中繼資料。

ClawHub 使用中繼資料來支援探索，並安全公開 skill 功能。登錄檔會追蹤使用訊號（星標、下載）以改善排名與可見性。每次發布都會建立新的 semver 版本，且登錄檔會保留版本歷史，讓使用者可稽核變更。

工作區與 skill 載入

獨立的 clawhub CLI 也會將 Skills 安裝到目前工作目錄下的 ./skills。如果已設定 OpenClaw 工作區，除非你覆寫 --workdir （或 CLAWHUB_WORKDIR），否則 clawhub 會退回使用該工作區。 OpenClaw 會從 <workspace>/skills 載入工作區 Skills，並在下一個工作階段載入它們。

如果你已經使用 ~/.openclaw/skills 或內建 Skills，工作區 Skills 會優先。若要深入了解 Skills 如何載入、共享與門控，請參閱 Skills。

服務功能

功能	備註
公開瀏覽	Skills 及其 `SKILL.md` 內容可公開檢視。
搜尋	由嵌入向量支援（向量搜尋），不只是關鍵字。
版本控制	Semver、變更記錄與標籤（包括 `latest`）。
下載	每個版本一個 Zip。
星標與留言	社群回饋。
安全掃描摘要	詳細頁會在安裝或下載前顯示最新掃描狀態。
掃描器詳細頁	VirusTotal、ClawScan 與靜態分析結果都有深層連結。
擁有者復原儀表板	發布者可從 `/dashboard` 查看因掃描保留的自有內容。
擁有者要求重新掃描	擁有者可針對誤判復原要求有限次重新掃描。
審核	核准與稽核。
CLI 友善 API	適合自動化與指令碼。

安全與審核

ClawHub 預設開放 - 任何人都可以上傳 Skills，但 GitHub 帳號必須至少建立一週才能發布。這會減緩濫用，同時不封鎖合法貢獻者。

安全掃描

ClawHub 會對已發布的 Skills 與 Plugin 版本執行自動化安全檢查。公開詳細頁會摘要目前結果，掃描器列則連結到 VirusTotal、ClawScan 與靜態分析的專用詳細頁。

因掃描保留或封鎖的版本可能無法出現在公開目錄與安裝介面上，但其擁有者仍可在 /dashboard 中看到。

回報

任何已登入使用者都可以回報 skill。
回報原因為必填並會被記錄。
每位使用者同一時間最多可有 20 份作用中回報。
擁有超過 3 份不重複回報的 Skills 預設會自動隱藏。

審核

審核員可以檢視隱藏的 Skills、取消隱藏、刪除，或封鎖使用者。
濫用回報功能可能導致帳號遭封鎖。
有興趣成為審核員？請在 OpenClaw Discord 詢問，並聯絡審核員或維護者。

ClawHub CLI

只有在使用發布/同步等需登錄檔驗證的工作流程時，你才需要它。

全域選項

"--workdir

"--dir

"--site

"--registry

--no-inputboolean

停用提示（非互動式）。

-V, --cli-versionboolean

列印 CLI 版本。

指令

驗證（登入 / 登出 / whoami）

clawhub login              # browser flow
clawhub login --token <token>
clawhub logout
clawhub whoami

登入選項：

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

搜尋

clawhub search "query"

搜尋 Skills。若要探索 Plugin/套件，請使用 clawhub package explore。

--limit <n> - 最大結果數。

瀏覽 / 檢查 Plugins

clawhub package explore --family code-plugin
clawhub package explore "episodic-claw" --family code-plugin
clawhub package inspect episodic-claw

package explore 與 package inspect 是 ClawHub CLI 用於 Plugin/套件探索與中繼資料檢查的介面。原生 OpenClaw 安裝仍使用 openclaw plugins install clawhub:<package>。

選項：

--family skill|code-plugin|bundle-plugin - 篩選套件家族。
--official - 只顯示官方套件。
--executes-code - 只顯示會執行程式碼的套件。
--version <version> / --tag <tag> - 檢查特定套件版本。
--versions, --files, --file <path> - 檢查套件歷史與檔案。
--json - 機器可讀輸出。

安裝 / 更新 / 列出

clawhub install <slug>
clawhub update <slug>
clawhub update --all
clawhub list

選項：

--version <version> - 安裝或更新到特定版本（update 上僅限單一 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 skill rescan <slug>
clawhub skill rescan <slug> --yes --json

clawhub package rescan <name>
clawhub package rescan <name> --yes --json

重新掃描指令需要已登入的擁有者 token，並以最新已發布 skill 版本或 Plugin 版本為目標。在非互動式執行中，請傳入 --yes。

JSON 回應包含目標種類、名稱、版本、重新掃描狀態，以及該版本或發行版剩餘/最大要求次數。

刪除 / 還原刪除（擁有者或管理員）

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"

尋找 Plugin

clawhub package explore --family code-plugin
clawhub package explore "memory" --family code-plugin
clawhub package inspect episodic-claw

安裝

clawhub install my-skill-pack

全部更新

clawhub update --all

發布單一 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/[email protected]
clawhub package publish https://github.com/your-org/your-plugin

Plugin 套件中繼資料

程式碼 Plugin 必須在 package.json 中包含必要的 OpenClaw 中繼資料：

{
  "name": "@myorg/openclaw-my-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./src/index.ts"],
    "runtimeExtensions": ["./dist/index.js"],
    "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"
    }
  }
}

已發布的套件應隨附已建置的 JavaScript，並將 runtimeExtensions 指向該輸出。Git checkout 安裝在沒有已建置檔案時仍可退回使用 TypeScript 原始碼，但已建置的 runtime 項目可避免在啟動、doctor 和 Plugin 載入路徑中進行 runtime TypeScript 編譯。

版本控管、lockfile 和 telemetry

版本控管與標籤

每次發布都會建立新的 semver SkillVersion。
標籤（例如 latest）會指向某個版本；移動標籤可讓你回復版本。
Changelog 會依版本附加；同步或發布更新時可以為空。

本機變更與 registry 版本

更新會使用內容雜湊，比較本機 skill 內容與 registry 版本。如果本機檔案不符合任何已發布版本，CLI 會在覆寫前詢問（或在非互動式執行中要求使用 --force）。

同步掃描與後備根目錄

clawhub sync 會先掃描你目前的 workdir。如果找不到任何 Skills，則會退回掃描已知的舊版位置（例如 ~/openclaw/skills 和 ~/.openclaw/skills）。這是為了在不需要額外旗標的情況下找到較舊的 skill 安裝。

儲存與 lockfile

已安裝的 Skills 會記錄在你 workdir 底下的 .clawhub/lock.json。
Auth token 會儲存在 ClawHub CLI 設定檔中（可透過 CLAWHUB_CONFIG_PATH 覆寫）。

Telemetry（安裝次數）

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

export CLAWHUB_DISABLE_TELEMETRY=1

環境變數

變數	效果
`CLAWHUB_SITE`	覆寫網站 URL。
`CLAWHUB_REGISTRY`	覆寫 registry API URL。
`CLAWHUB_CONFIG_PATH`	覆寫 CLI 儲存 token/設定的位置。
`CLAWHUB_WORKDIR`	覆寫預設 workdir。
`CLAWHUB_DISABLE_TELEMETRY=1`	在 `sync` 時停用 telemetry。

ClawHub

快速開始

搜尋

安裝

使用

發布（選用）

原生 OpenClaw 流程

Skills

Plugins

ClawHub 是什麼

工作區與 skill 載入

服務功能

安全與審核

ClawHub CLI

全域選項

指令

常見工作流程

搜尋

尋找 Plugin

安裝

全部更新

發布單一 skill

同步多個 Skills

從 GitHub 發布 Plugin

Plugin 套件中繼資料

版本控管、lockfile 和 telemetry

環境變數

相關

Ask OpenClaw

# 快速開始

搜尋

安裝

使用

發布（選用）

# 原生 OpenClaw 流程

Skills

Plugins

# ClawHub 是什麼

# 工作區與 skill 載入

# 服務功能

# 安全與審核

# ClawHub CLI

# 全域選項

# 指令

# 常見工作流程

搜尋

尋找 Plugin

安裝

全部更新

發布單一 skill

同步多個 Skills

從 GitHub 發布 Plugin

# Plugin 套件中繼資料

# 版本控管、lockfile 和 telemetry

# 環境變數

# 相關

快速開始

原生 OpenClaw 流程

ClawHub 是什麼

工作區與 skill 載入

服務功能

安全與審核

ClawHub CLI

全域選項

指令

常見工作流程

Plugin 套件中繼資料

版本控管、lockfile 和 telemetry

環境變數

相關