スキル

ClawHub

ClawHubは、OpenClawのための公開スキルレジストリです。これは無料サービスです：すべてのスキルは公開されており、誰でも共有や再利用のために閲覧できます。スキルは、SKILL.mdファイル（および補助的なテキストファイル）を含む単なるフォルダです。Webアプリでスキルを閲覧したり、CLIを使用してスキルを検索、インストール、更新、公開したりできます。サイト: 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のインストール

いずれかを選択：

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はデフォルトでオープンです。誰でもスキルをアップロードできますが、公開するには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>: 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時のテレメトリーを無効化。

スキル設定プラグイン