メインコンテンツへスキップ

​
ClawHub

ClawHubはOpenClaw SkillsとPluginの公開registryです。
  • スキルの検索/インストール/更新、およびClawHubからのPluginインストールには、 ネイティブのopenclawコマンドを使用します。
  • registry認証、公開、削除、削除取り消し、または同期ワークフローが必要な場合は、 別のclawhub CLIを使用します。
サイト: clawhub.ai

​
ネイティブOpenClawフロー

Skills: 
openclaw skills search "calendar"
openclaw skills install <skill-slug>
openclaw skills update --all
Plugins: 
openclaw plugins install clawhub:<package>
openclaw plugins update --all
npmで安全な素のPlugin specも、npmより前にClawHubに対して試行されます。 
openclaw plugins install openclaw-codex-app-server
ネイティブopenclawコマンドは、アクティブなワークスペースへインストールし、 後続のupdate呼び出しがClawHub上に留まれるように、ソース メタデータを永続化します。 Pluginインストールでは、archiveインストール実行前に広告されたpluginApiとminGatewayVersion 互換性をバリデーションするため、非互換hostではパッケージを部分的にインストールするのではなく、 早い段階でfail closedします。 openclaw plugins install clawhub:...は、インストール可能なPluginファミリーだけを受け付けます。 ClawHubパッケージが実際にはskillである場合、OpenClawは停止し、代わりに openclaw skills install <slug>を案内します。

​
ClawHubとは何か

  • OpenClaw SkillsとPluginの公開registry。
  • スキルバンドルとメタデータのバージョン管理された保存先。
  • 検索、タグ、利用シグナルのための発見画面。

​
仕組み

  1. ユーザーがスキルバンドル（ファイル + メタデータ）を公開します。
  2. ClawHubがバンドルを保存し、メタデータを解析し、バージョンを割り当てます。
  3. registryがそのスキルを検索と発見のためにインデックス化します。
  4. ユーザーがOpenClawでスキルを閲覧、ダウンロード、インストールします。

​
できること

  • 新しいスキルと既存スキルの新バージョンを公開する。
  • 名前、タグ、または検索でスキルを見つける。
  • スキルバンドルをダウンロードし、そのファイルを確認する。
  • 悪意のある、または安全でないスキルを報告する。
  • モデレーターであれば、非表示、再表示、削除、または禁止を行う。

​
どんな人向けか（初心者向け）

OpenClaw agentに新しい能力を追加したい場合、ClawHubはSkillsを見つけてインストールする最も簡単な方法です。バックエンドの仕組みを知る必要はありません。できること:
  • 平易な言葉でSkillsを検索する。
  • ワークスペースにSkillをインストールする。
  • 後で1つのコマンドでSkillsを更新する。
  • 自分のSkillsを公開してバックアップする。

​
クイックスタート（非技術者向け）

  1. 必要なものを検索します:
    • openclaw skills search "calendar"
  2. Skillをインストールします:
    • openclaw skills install <skill-slug>
  3. 新しいOpenClawセッションを開始して、新しいSkillを読み込ませます。
  4. 公開やregistry認証の管理もしたい場合は、別の clawhub CLIもインストールしてください。

​
ClawHub CLIのインストール

これは、公開/同期のようなregistry認証付きワークフローでのみ必要です。 
npm i -g clawhub

pnpm add -g clawhub

​
OpenClawの中での位置付け

ネイティブのopenclaw skills installは、アクティブワークスペースのskills/ ディレクトリにインストールします。openclaw plugins install clawhub:...は、通常の管理対象 Pluginインストールに加えて、更新用のClawHubソースメタデータを記録します。 匿名のClawHub Pluginインストールも、privateパッケージではfail closedします。 コミュニティやその他の非公式チャンネルからは引き続きインストールできますが、OpenClawは 有効化前にソースと検証を確認できるよう運用者へ警告します。 別のclawhub CLIも、現在の作業ディレクトリ配下の./skillsにSkillsをインストールします。OpenClawワークスペースが設定されている場合、clawhubは --workdir（または CLAWHUB_WORKDIR）で上書きしない限り、そのワークスペースへフォールバックします。OpenClawは <workspace>/skillsからワークスペースSkillsを読み込み、次のセッションでそれらを拾います。すでに ~/.openclaw/skillsまたはバンドル済みSkillsを使っている場合、ワークスペースSkillsが優先されます。 Skillsがどのように読み込まれ、共有され、制御されるかの詳細は Skillsを参照してください。

​
Skillシステム概要

Skillは、OpenClawに特定のタスクの実行方法を教える、ファイルのバージョン管理されたバンドルです。 公開のたびに新しいバージョンが作成され、registryはユーザーが変更を監査できるよう バージョン履歴を保持します。 典型的なSkillには次が含まれます。
  • 主な説明と使い方を記載したSKILL.mdファイル。
  • Skillで使用される任意の設定、スクリプト、または補助ファイル。
  • タグ、要約、インストール要件のようなメタデータ。
ClawHubは、発見を支え、Skillの能力を安全に公開するためにメタデータを使用します。 registryはまた、ランキングと可視性を改善するために利用シグナル（starsやdownloadsなど）も追跡します。

​
サービスが提供するもの（機能）

  • SkillsとそのSKILL.md内容の公開閲覧。
  • キーワードだけではない、embeddings（ベクトル検索）による検索。
  • semver、changelog、タグ（latestを含む）によるバージョン管理。
  • バージョンごとのzipとしてのダウンロード。
  • コミュニティフィードバックのためのstarsとコメント。
  • 承認と監査のためのモデレーションhook。
  • 自動化とスクリプト向けのCLIフレンドリーなAPI。

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

ClawHubはデフォルトでオープンです。誰でもSkillをアップロードできますが、公開するには GitHubアカウントが少なくとも1週間以上経過している必要があります。これにより、 正当な貢献者を妨げずに悪用を抑制します。 報告とモデレーション:
  • サインインしているユーザーなら誰でもSkillを報告できます。
  • 報告理由は必須で、記録されます。
  • 各ユーザーは同時に最大20件のアクティブ報告を持てます。
  • 3件を超えるユニーク報告が付いたSkillは、デフォルトで自動的に非表示になります。
  • モデレーターは、非表示Skillの閲覧、再表示、削除、またはユーザー禁止を行えます。
  • 報告機能の悪用は、アカウント禁止の対象になることがあります。
モデレーターに興味がありますか？OpenClaw Discordで相談し、 モデレーターまたはメンテナーに連絡してください。

​
CLIコマンドとパラメーター

グローバルオプション（すべてのコマンドに適用）:
  • --workdir <dir>: 作業ディレクトリ（デフォルト: 現在のディレクトリ。OpenClawワークスペースへフォールバック）。
  • --dir <dir>: workdirからの相対Skillsディレクトリ（デフォルト: skills）。
  • --site <url>: サイトベースURL（ブラウザーログイン）。
  • --registry <url>: registry 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を読み取ります）
Skill公開:
  • clawhub skill publish <path>
  • --slug <slug>: Skill slug。
  • --name <name>: 表示名。
  • --version <version>: Semverバージョン。
  • --changelog <text>: Changelogテキスト（空でも可）。
  • --tags <tags>: カンマ区切りタグ（デフォルト: latest）。
Plugin公開:
  • clawhub package publish <source>
  • <source>には、ローカルフォルダー、owner/repo、owner/repo@ref、またはGitHub URLを指定できます。
  • --dry-run: 何もアップロードせず、正確な公開計画を構築します。
  • --json: CI向けに機械可読出力を生成します。
  • --source-repo、--source-commit、--source-ref: 自動検出だけでは不十分な場合の任意の上書き。
削除/削除取り消し（owner/adminのみ）:
  • clawhub delete <slug> --yes
  • clawhub undelete <slug> --yes
同期（ローカルSkillsをスキャンして新規/更新を公開）:
  • clawhub sync
  • --root <dir...>: 追加のスキャンroot。
  • --all: プロンプトなしで全件アップロード。
  • --dry-run: 何がアップロードされるかを表示。
  • --bump <type>: 更新時のpatch|minor|major（デフォルト: patch）。
  • --changelog <text>: 非対話型更新用changelog。
  • --tags <tags>: カンマ区切りタグ（デフォルト: latest）。
  • --concurrency <n>: registryチェック数（デフォルト: 4）。

​
agent向けの一般的なワークフロー

​
Skillsを検索する

clawhub search "postgres backups"

​
新しいSkillsをダウンロードする

clawhub install my-skill-pack

​
インストール済みSkillsを更新する

clawhub update --all

​
Skillsをバックアップする（公開または同期）

単一の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/your-plugin@v1.0.0
clawhub package publish https://github.com/your-org/your-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ソースへフォールバックできますが、 ビルド済み実行時entryを用意しておくと、起動、doctor、Pluginロード経路での実行時TypeScript コンパイルを避けられます。

​
詳細（技術的）

​
バージョン管理とタグ

  • 公開のたびに新しいsemver SkillVersionが作成されます。
  • タグ（latestなど）はバージョンを指し、タグを動かすことでロールバックできます。
  • Changelogはバージョンごとに付与され、同期や更新公開では空でも構いません。

​
ローカル変更とregistryバージョン

更新では、ローカルSkill内容をコンテンツハッシュでregistryバージョンと比較します。ローカルファイルが 公開済みバージョンのどれとも一致しない場合、CLIは上書き前に確認を求めます（または非対話型実行では --forceが必要です）。

​
同期スキャンとフォールバックroot

clawhub syncはまず現在のworkdirをスキャンします。Skillが見つからない場合、 既知の従来ロケーション（たとえば~/openclaw/skillsや~/.openclaw/skills）へフォールバックします。これは、 追加フラグなしで古いSkillインストールを見つけるためのものです。

​
保存先とlockfile

  • インストール済みSkillsは、workdir配下の.clawhub/lock.jsonに記録されます。
  • 認証トークンはClawHub CLI設定ファイルに保存されます（CLAWHUB_CONFIG_PATHで上書き可能）。

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

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

​
環境変数

  • CLAWHUB_SITE: サイトURLを上書き。
  • CLAWHUB_REGISTRY: registry API URLを上書き。
  • CLAWHUB_CONFIG_PATH: CLIがトークン/設定を保存する場所を上書き。
  • CLAWHUB_WORKDIR: デフォルトworkdirを上書き。
  • CLAWHUB_DISABLE_TELEMETRY=1: sync時のテレメトリーを無効化。