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

# ClawHub

> ClawHub は OpenClaw の公開スキル レジストリです。これは無料のサービスです。すべてのスキルは公開され、オープンであり、共有および再利用のために誰でも見ることができます。

ClawHub は **OpenClaw の公開スキル レジストリ**です。これは無料のサービスです。すべてのスキルは公開され、オープンであり、共有および再利用のために誰でも見ることができます。スキルは、`SKILL.md` ファイル (およびサポートするテキスト ファイル) を含む単なるフォルダーです。 Web アプリでスキルを参照したり、CLI を使用してスキルを検索、インストール、更新、公開したりできます。

サイト: [clawhub.ai](https://clawhub.ai)

## ClawHub とは

* OpenClaw スキルの公開レジストリ。
* スキルバンドルとメタデータのバージョン管理されたストア。
* 検索、タグ、および使用状況シグナルのためのディスカバリ サーフェス。

## 仕組み

1. ユーザーがスキル バンドル (ファイル + メタデータ) を公開します。
2. ClawHub はバンドルを保存し、メタデータを解析し、バージョンを割り当てます。
3. レジストリは、検索と検出のためにスキルにインデックスを付けます。
4. ユーザーは OpenClaw でスキルを参照、ダウンロード、インストールします。

## あなたにできること

* 新しいスキルと既存のスキルの新しいバージョンを公開します。
* 名前、タグ、または検索によってスキルを見つけます。
* スキル バンドルをダウンロードし、そのファイルを検査します。
* 悪用的または危険なスキルを報告します。
* モデレーターの場合は、非表示、再表示、削除、または禁止を行います。

## 対象者 (初心者向け)

OpenClaw エージェントに新しい機能を追加したい場合は、ClawHub を使用するのがスキルを見つけてインストールする最も簡単な方法です。バックエンドがどのように機能するかを知る必要はありません。あなたはできる：- わかりやすい言葉でスキルを検索します。

* ワークスペースにスキルをインストールします。
* 1 つのコマンドで後でスキルを更新します。
* 自分のスキルを公開してバックアップします。

## クイック スタート (非技術的)

1. CLI をインストールします (次のセクションを参照)。
2. 必要なものを検索します。
   * `clawhub search "calendar"`
3. スキルをインストールします。
   * `clawhub install <skill-slug>`
4. 新しい OpenClaw セッションを開始して、新しいスキルを習得します。

## CLI をインストールする

1 つ選択してください:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm i -g clawhub
```

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm add -g clawhub
```

## OpenClaw にどのように適合するか

デフォルトでは、CLI は現在の作業ディレクトリの下の `./skills` にスキルをインストールします。 OpenClaw ワークスペースが構成されている場合、`--workdir` (または `CLAWHUB_WORKDIR`) をオーバーライドしない限り、`clawhub` はそのワークスペースにフォールバックします。 OpenClaw は、`<workspace>/skills` からワークスペース スキルをロードし、**次** セッションでそれらを取得します。すでに `~/.openclaw/skills` またはバンドルされたスキルを使用している場合は、ワークスペース スキルが優先されます。

スキルのロード、共有、ゲート制御の方法の詳細については、を参照してください。
[スキル](/tools/skills)。

## スキルシステム概要

スキルは、OpenClaw にスキルの実行方法を教える、バージョン管理されたファイルのバンドルです。
特定のタスク。発行するたびに新しいバージョンが作成され、レジストリには
ユーザーが変更を監査できるようにバージョンの履歴を保存します。

典型的なスキルには次のようなものがあります。- 主な説明と使用法を含む `SKILL.md` ファイル。

* スキルで使用されるオプションの構成、スクリプト、またはサポート ファイル。
* タグ、概要、インストール要件などのメタデータ。

ClawHub はメタデータを使用して検出を強化し、スキル機能を安全に公開します。
レジストリは、改善のために使用状況のシグナル (スターやダウンロードなど) も追跡します。
ランキングと知名度。

## サービスが提供するもの (機能)

* スキルとその `SKILL.md` コンテンツの **パブリック ブラウジング**。
* **検索** キーワードだけでなく埋め込み (ベクトル検索) を利用します。
* サーバー、変更ログ、およびタグ (`latest` を含む) による **バージョン管理**。
* **ダウンロード** はバージョンごとに zip 形式で行われます。
* **スターとコメント** コミュニティのフィードバック用。
* **モデレーション** 承認と監査のためのフック。
* **CLI フレンドリーな API** による自動化とスクリプト作成。

## セキュリティとモデレーション

ClawHub はデフォルトで開いています。スキルは誰でもアップロードできますが、GitHub アカウントが必要です
公開までに少なくとも 1 週間は必要です。これにより、ブロックせずに悪用を遅らせることができます
正当な貢献者。

報告とモデレーション:- サインインしているユーザーは誰でもスキルを報告できます。

* 報告理由は必須であり、記録されます。
* 各ユーザーは一度に最大 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 トークンを貼り付けます。
* `--label <label>`: ブラウザーのログイン トークン用に保存されたラベル (デフォルト: `CLI token`)。
* `--no-browser`: ブラウザを開かないでください (`--token` が必要です)。

検索:

* `clawhub search "query"`
* `--limit <n>`: 最大の結果。

インストール：- `clawhub install <slug>`

* `--version <version>`: 特定のバージョンをインストールします。
* `--force`: フォルダーが既に存在する場合は上書きします。

更新:

* `clawhub update <slug>`
* `clawhub update --all`
* `--version <version>`: 特定のバージョンに更新します (単一のスラッグのみ)。
* `--force`: ローカル ファイルがどの公開バージョンにも一致しない場合は上書きします。

リスト:

* `clawhub list` (`.clawhub/lock.json` と読み取られます)

公開:

* `clawhub publish <path>`
* `--slug <slug>`: スキルスラッグ。
* `--name <name>`: 表示名。
* `--version <version>`: セムバーのバージョン。
* `--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)。

## エージェントの一般的なワークフロー

### スキルを検索する

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub search "postgres backups"
```

### 新しいスキルをダウンロードする

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub install my-skill-pack
```

### インストールされているスキルを更新する

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub update --all
```

### スキルをバックアップする (公開または同期)単一のスキル フォルダーの場合

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0 --tags latest
```

多くのスキルを一度にスキャンしてバックアップするには:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawhub sync --all
```

## 高度な詳細 (技術的)

### バージョン管理とタグ

* 公開するたびに、新しい **semver** `SkillVersion` が作成されます。
* タグ (`latest` など) はバージョンを指します。タグを移動すると、ロールバックできます。
* 変更ログはバージョンごとに添付され、更新の同期または公開時には空にすることができます。

### ローカルの変更とレジストリのバージョン

更新では、コンテンツ ハッシュを使用して、ローカル スキルのコンテンツとレジストリ バージョンを比較します。ローカル ファイルがどの公開バージョンにも一致しない場合、CLI は上書きする前に質問します (または、非対話型実行では `--force` が必要です)。

### 同期スキャンとフォールバック ルート

`clawhub sync` は、最初に現在の作業ディレクトリをスキャンします。スキルが見つからない場合は、既知の従来の場所 (`~/openclaw/skills` や `~/.openclaw/skills` など) にフォールバックします。これは、追加のフラグなしで古いスキルのインストールを検索するように設計されています。

### ストレージとロックファイル

* インストールされたスキルは、workdir の下の `.clawhub/lock.json` に記録されます。
* 認証トークンは ClawHub CLI 構成ファイルに保存されます (`CLAWHUB_CONFIG_PATH` によってオーバーライドされます)。

### テレメトリ (インストール数)

ログイン中に `clawhub sync` を実行すると、CLI はインストール数を計算するために最小限のスナップショットを送信します。これを完全に無効にすることもできます。

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

## 環境変数- `CLAWHUB_SITE`: サイト URL をオーバーライドします

* `CLAWHUB_REGISTRY`: レジストリ API URL をオーバーライドします。
* `CLAWHUB_CONFIG_PATH`: CLI がトークン/構成を保存する場所をオーバーライドします。
* `CLAWHUB_WORKDIR`: デフォルトの workdir をオーバーライドします。
* `CLAWHUB_DISABLE_TELEMETRY=1`: `sync` のテレメトリを無効にします。