スキル
スキル：管理対象 vs ワークスペース、ゲーティングルール、設定/環境変数の接続
OpenClaw は ''''AgentSkills'' 互換''のスキルフォルダーを使用して、エージェントにツールの使用方法を教えます。各スキルは ''SKILL.md'' を含むディレクトリで、YAML フロントマターと指示が含まれています。OpenClaw は''バンドルされたスキル''とオプションのローカルオーバーライドをロードし、環境、設定、バイナリの存在に基づいてロード時にフィルタリングします。
場所と優先順位
スキルは<strong>3つ</strong>の場所からロードされます：
1. <strong>バンドルされたスキル</strong>：インストールに同梱（npm パッケージまたは OpenClaw.app）
2. '<strong>'管理対象/ローカルスキル'</strong>'：'<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'~/.openclaw/skills'</code>'
3. '<strong>'ワークスペーススキル'</strong>'：'<code className="bg-white/10 px-1.5 py-0.5 rounded text-emerald-300 text-sm">'<workspace>/skills'</code>'
スキル名が競合する場合、優先順位は：
''<workspace>/skills''（最高）→ ''~/.openclaw/skills'' → バンドルされたスキル（最低）
Additionally, you can configure extra skill folders (lowest precedence) via
''skills.load.extraDirs'' in ''~/.openclaw/openclaw.json''.
エージェントごと vs 共有スキル
<strong>マルチエージェント</strong>設定では、各エージェントが独自のワークスペースを持ちます。つまり：
- ''エージェントごとのスキル''は ''<workspace>/skills'' にあり、そのエージェントのみが使用できます。
- ''共有スキル''は ''~/.openclaw/skills''（管理対象/ローカル）にあり、
同じマシン上の<strong>すべてのエージェント</strong>に表示されます。
- ''共有フォルダー''は ''skills.load.extraDirs'' で追加できます（最低
優先順位）、複数のエージェントで使用する共通スキルパックが必要な場合。
同じスキル名が複数の場所に存在する場合、通常の優先順位が
適用されます：ワークスペースが優先、次に管理対象/ローカル、次にバンドル。
プラグイン + スキル
プラグインは ''skills'' ディレクトリをリストすることで独自のスキルを出荷できます
''openclaw.plugin.json''（プラグインルートからの相対パス）。プラグインスキルは
プラグインが有効になるとロードされ、通常のスキル優先順位ルールに参加します。
プラグインの設定エントリで ''metadata.openclaw.requires.config'' でゲートできます。
発見/設定については ''プラグイン'' を、それらのスキルが教えるツール
サーフェスについては ''ツール'' を参照してください。
ClawHub（インストール + 同期）
ClawHub は OpenClaw の公開スキルレジストリです。以下で閲覧：
https://clawhub.com。スキルの発見、インストール、更新、バックアップに使用します。
完全なガイド：''ClawHub''。
一般的なフロー：
- スキルをワークスペースにインストール：
- ''clawhub install <skill-slug>''
- インストール済みスキルをすべて更新：
- ''clawhub update --all''
- 同期（スキャン + 更新の公開）：
- ''clawhub sync --all''
デフォルトでは、''clawhub'' は現在の作業ディレクトリの ''./skills'' にインストール
（または設定された OpenClaw ワークスペースにフォールバック）。OpenClaw は次のセッションで
''<workspace>/skills'' としてそれをピックアップします。
セキュリティノート
- サードパーティのスキルを信頼できないコードとして扱います。有効にする前に読んでください。
- 信頼できない入力やリスクの高いツールにはサンドボックス実行を推奨。''サンドボックス'' を参照。
- ''skills.entries.*.env'' と ''skills.entries.*.apiKey'' はシークレットを''ホスト''プロセスに注入
（サンドボックスではなく）。シークレットをプロンプトとログから除外してください。
- より広範な脅威モデルとチェックリストについては、''セキュリティ'' を参照。
フォーマット（AgentSkills + Pi 互換）
''SKILL.md'' は少なくとも以下を含む必要があります：
ノート：
- レイアウト/意図については AgentSkills 仕様に従います。
- 組み込みエージェントが使用するパーサーは<strong>単一行</strong>のフロントマターキーのみをサポートします。
- ''metadata'' は''単一行 JSON オブジェクト''である必要があります。
- 指示で ''{baseDir}'' を使用してスキルフォルダーパスを参照します。
- オプションのフロントマターキー：
- ''homepage'' — macOS スキル UI で「ウェブサイト」として表示される URL。
- ''user-invocable'' — ''true|false''（デフォルト：''true''）。
- ''disable-model-invocation'' — ''true|false''（デフォルト：''false''）。
ゲーティング（ロード時フィルター）
OpenClaw は ''metadata''（単一行 JSON）を使用して''ロード時にスキルをフィルタリング''します：
''metadata.openclaw'' の下のフィールド：
- ''always: true'' — 常にスキルを含める（他のゲートをスキップ）。
- ''emoji'' — macOS スキル UI で使用されるオプションの絵文字。
- ''homepage'' — macOS スキル UI で「ウェブサイト」として表示されるオプションの URL。
- ''os'' — プラットフォームのオプションリスト（''darwin''、''linux''、''win32''）。
- ''requires.bins'' — リスト；各が ''PATH'' に存在する必要があります。
- ''requires.anyBins'' — リスト；少なくとも1つが ''PATH'' に存在する必要があります。
- ''requires.env'' — リスト；環境変数が存在する''または''設定で提供される必要があります。
- ''requires.config'' — 真である必要がある ''openclaw.json'' パスのリスト。
- ''primaryEnv'' — ''skills.entries.<name>.apiKey'' に関連付けられた環境変数名。
- ''install'' — macOS スキル UI で使用されるオプションのインストーラー仕様配列。
設定オーバーライド
バンドル/管理スキルはトグルでき、環境値を提供できます：
ノート：スキル名にハイフンが含まれる場合、キーを引用してください（JSON5 は引用キーを許可）。
設定キーはデフォルトで<strong>スキル名</strong>と一致します。スキルが
''metadata.openclaw.skillKey'' を定義している場合、''skills.entries'' の下でそのキーを使用します。
ルール：
- ''enabled''（デフォルト：''true''）— ''false'' に設定して無効化。
- ''apiKey'' — ''primaryEnv''（設定されている場合）または ''<SKILLNAME>_API_KEY'' として注入。
- ''env'' — 注入する追加環境変数のマップ。
- ''config'' — スキルに公開される設定値のマップ。