> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClawHub

# ClawHub

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

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

網站：[clawhub.ai](https://clawhub.ai)

## 快速開始

使用 OpenClaw 搜尋並安裝 Skills：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw skills search "calendar"
openclaw skills install @openclaw/demo
openclaw skills update --all
```

使用 OpenClaw 搜尋並安裝外掛：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins search "calendar"
openclaw plugins install clawhub:<package>
openclaw plugins update --all
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 命令列介面用於需要登錄檔驗證的工作：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 安裝／更新命令，可用於直接操作登錄檔的工作流程：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub install @openclaw/demo
clawhub update @openclaw/demo
clawhub update --all
clawhub list
```

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

## 發布

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub skill publish <path>
```

常用發布選項：

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub package publish <source>
```

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

程式碼外掛必須在 `package.json` 中包含必要的 OpenClaw 相容性中繼資料，包括 `openclaw.compat.pluginApi` 與 `openclaw.build.openclawVersion`。完整命令參考請參閱[命令列介面](/zh-TW/clawhub/cli)，Skill 中繼資料請參閱 [Skill 格式](/zh-TW/clawhub/skill-format)。

## 安全性與內容管理

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

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

已登入的使用者可以檢舉 Skills 與套件。內容管理員可以審查檢舉、隱藏或還原內容，以及封鎖濫用帳號。政策與執行細節請參閱[安全性](/zh-TW/clawhub/security)、[安全性稽核](/zh-TW/clawhub/security-audits)、[內容管理與帳號安全](/zh-TW/clawhub/moderation)及[可接受的使用方式](/zh-TW/clawhub/acceptable-usage)。

## 遙測與環境

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export CLAWHUB_DISABLE_TELEMETRY=1
```

實用的環境覆寫設定：

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

如需更深入的參考資料，請參閱[遙測](/zh-TW/clawhub/telemetry)、[HTTP API](/zh-TW/clawhub/http-api)及[疑難排解](/zh-TW/clawhub/troubleshooting)。