ClawHub

ClawHub は OpenClaw のパブリックスキルレジストリです。すべてのスキルが公開・オープンで、誰でも閲覧・共有・再利用できる無料サービスです。スキルは SKILL.md ファイル（および補助テキストファイル）を含むフォルダにすぎません。Web アプリでスキルを閲覧したり、CLI を使ってスキルの検索、インストール、更新、公開を行えます。

サイト: clawhub.ai

ClawHub とは

  • OpenClaw スキルのパブリックレジストリ。
  • バージョン管理されたスキルバンドルとメタデータのストア。
  • 検索、タグ、利用シグナルによるディスカバリー。

仕組み

  1. ユーザーがスキルバンドル（ファイル＋メタデータ）を公開する。
  2. ClawHub がバンドルを保存し、メタデータを解析して、バージョンを割り当てる。
  3. レジストリがスキルを検索・ディスカバリー用にインデックスする。
  4. ユーザーがスキルを閲覧・ダウンロードし、OpenClaw にインストールする。

できること

  • 新しいスキルと既存スキルの新バージョンを公開。
  • 名前、タグ、検索でスキルを発見。
  • スキルバンドルをダウンロードしてファイルを確認。
  • 不適切または安全でないスキルを報告。
  • モデレーターであれば、非表示、表示復元、削除、BAN を実行。

対象者（初心者向け）

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 はデフォルトでオープンです。誰でもスキルをアップロードできますが、公開には作成後 1 週間以上経過した GitHub アカウントが必要です。これにより、正当な貢献者をブロックすることなく悪用を抑制できます。

報告とモデレーション:

  • ログイン済みのユーザーなら誰でもスキルを報告可能。
  • 報告理由は必須で記録される。
  • 各ユーザーが一度に持てるアクティブな報告は最大 20 件。
  • ユニークな報告が 3 件を超えたスキルはデフォルトで自動的に非表示。
  • モデレーターは非表示のスキルを閲覧、表示復元、削除、またはユーザーを BAN 可能。
  • 報告機能の悪用はアカウント BAN の対象。

モデレーターになることに興味がある場合は、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>: 特定バージョンに更新（単一 slug のみ）。
  • --force: ローカルファイルが公開済みバージョンと一致しない場合に上書き。

一覧:

  • clawhub list（.clawhub/lock.json を読み込み）

公開:

  • clawhub publish <path>
  • --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 に記録。
  • 認証トークンは ClawHub CLI 設定ファイルに保存（CLAWHUB_CONFIG_PATH でオーバーライド可能）。

テレメトリ（インストール数）

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

export CLAWHUB_DISABLE_TELEMETRY=1

環境変数

  • CLAWHUB_SITE: サイト URL のオーバーライド。
  • CLAWHUB_REGISTRY: レジストリ API URL のオーバーライド。
  • CLAWHUB_CONFIG_PATH: CLI のトークン/設定の保存場所をオーバーライド。
  • CLAWHUB_WORKDIR: デフォルト workdir のオーバーライド。
  • CLAWHUB_DISABLE_TELEMETRY=1: sync 時のテレメトリを無効化。
arrow_back
前へ
Skills Config
次へ
Plugin
arrow_forward