ClawHub
ClawHub ガイド:公開スキルレジストリ + CLI ワークフロー
ClawHub は ''OpenClaw の公開スキルレジストリ''です。無料サービスです:すべてのスキルは公開、オープン、誰でも表示可能で、共有と再利用が可能です。スキルは ''SKILL.md'' ファイル(とサポートテキストファイル)を含むフォルダです。Web アプリでスキルを閲覧するか、CLI を使用してスキルを検索、インストール、更新、公開できます。
サイト:''clawhub.com''
対象者(初心者向け)
OpenClaw エージェントに新しい機能を追加したい場合、ClawHub はスキルを見つけてインストールする最も簡単な方法です。バックエンドの仕組みを知る必要はありません。次のことができます:
- 自然言語でスキルを検索。
- スキルをワークスペースにインストール。
- 後で1つのコマンドでスキルを更新。
- 自分のスキルを公開してバックアップ。
クイックスタート(非技術的)
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''(または ''--workdir'')を上書きしない限り、''CLAWHUB_WORKDIR'' はそのワークスペースにフォールバックします。OpenClaw は ''<workspace>/skills'' からワークスペーススキルをロードし、''次の''セッションで認識します。すでに ''~/.openclaw/skills'' またはバンドルスキルを使用している場合、ワークスペーススキルが優先されます。
スキルのロード、共有、ゲート方法の詳細については、
''スキル''を参照してください。
サービスが提供する機能
- スキルとその ''SKILL.md'' コンテンツの''公開閲覧''。
- キーワードだけでなく、エンベディング(ベクトル検索)による検索。
- semver、チェンジログ、タグ(''latest'' を含む)による''バージョン管理''。
- バージョンごとの zip としてのダウンロード。
- コミュニティフィードバックのためのスターとコメント。
- 承認と監査のためのモデレーションフック。
- 自動化とスクリプトのためのCLI フレンドリーな API。
CLI コマンドとパラメータ
グローバルオプション(すべてのコマンドに適用):
- ''--workdir <dir>'':作業ディレクトリ(デフォルト:現在のディレクトリ;OpenClaw ワークスペースにフォールバック)。
- ''--dir <dir>'':スキルディレクトリ、作業ディレクトリからの相対パス(デフォルト:''skills'')。
- ''--site <url>'':サイトベース URL(ブラウザログイン)。
- ''--registry <url>'':レジストリ API ベース URL。
- ''--no-input'':プロンプトを無効化(非対話型)。
- ''-V, --cli-version'':CLI バージョンを印刷。
Auth:
- ''clawhub login''(ブラウザフロー)または ''clawhub login --token <token>''
- ''clawhub logout''
- ''clawhub whoami''
オプション:
- ''--token <token>'':API トークンを貼り付け。
- ''--label <label>'':ブラウザログイントークンに保存されるラベル(デフォルト:''CLI token'')。
- ''--no-browser'':ブラウザを開かない(''--token'' が必要)。
Search:
- ''clawhub search "query"''
- ''--limit <n>'': Max results.
インストール:
- ''clawhub install <slug>''
- ''--version <version>'':特定のバージョンをインストール。
- ''--force'':フォルダが既に存在する場合は上書き。
Update:
- ''clawhub update <slug>''
- ''clawhub update --all''
- ''--version <version>'':特定のバージョンに更新(単一 slug のみ)。
- ''--force'':ローカルファイルが公開バージョンと一致しない場合は上書き。
リスト:
- ''clawhub list''(''.clawhub/lock.json'' を読み取り)
Publish:
- ''clawhub publish <path>''
- ''--slug <slug>'':スキル slug。
- ''--name <name>'': Display 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
Advanced details (technical)
#
バージョン管理とタグ
- 各公開は新しい ''semver'' ''SkillVersion'' を作成します。
- タグ(''latest'' など)はバージョンを指します;タグを移動するとロールバックできます。
- チェンジログは各バージョンに添付され、同期または更新公開時に空でもかまいません。
#
ローカル変更とレジストリバージョン
更新はコンテンツハッシュを使用してローカルスキルコンテンツをレジストリバージョンと比較します。ローカルファイルが公開バージョンと一致しない場合、CLI は上書き前に確認します(または非対話型実行では ''--force'' が必要)。
#
同期スキャンとフォールバックルート
''clawhub sync'' は最初に現在の作業ディレクトリをスキャンします。スキルが見つからない場合、既知のレガシー場所(例:''~/openclaw/skills'' や ''~/.openclaw/skills'')にフォールバックします。これは追加フラグなしで古いスキルインストールを見つけるように設計されています。
#
ストレージとロックファイル
- インストール済みスキルは作業ディレクトリ下の ''.clawhub/lock.json'' に記録されます。
- 認証トークンは ClawHub CLI 設定ファイルに保存されます(''CLAWHUB_CONFIG_PATH'' で上書き)。
#
テレメトリ(インストール数)
ログイン中に ''clawhub sync'' を実行すると、CLI はインストール数を計算するために最小スナップショットを送信します。これを完全に無効にできます:
export CLAWHUB_DISABLE_TELEMETRY=1
Environment variables
- ''CLAWHUB_SITE'':サイト URL を上書き。
- ''CLAWHUB_REGISTRY'':レジストリ API URL を上書き。
- ''CLAWHUB_CONFIG_PATH'':CLI がトークン/設定を保存する場所を上書き。
- ''CLAWHUB_WORKDIR'':デフォルトの作業ディレクトリを上書き。
- ''CLAWHUB_DISABLE_TELEMETRY=1'':''sync'' でテレメトリを無効化。