Plugin バンドル

OpenClaw は、Codex、Claude、Cursor という 3 つの外部エコシステムから Plugin をインストールできます。これらは バンドル と呼ばれ、OpenClaw が Skills、フック、MCP ツールなどのネイティブ機能にマッピングするコンテンツとメタデータのパックです。

バンドルが存在する理由

多くの有用な Plugin が Codex、Claude、Cursor 形式で公開されています。作成者にネイティブ OpenClaw Plugin として書き直すことを求める代わりに、OpenClaw はこれらの形式を検出し、サポート対象のコンテンツをネイティブ機能セットにマッピングします。Claude コマンドパックや Codex Skills バンドルをインストールして、すぐに使用できます。

バンドルをインストールする

# ローカルディレクトリopenclaw plugins install ./my-bundle # アーカイブopenclaw plugins install ./my-bundle.tgz # Claude マーケットプレイスopenclaw plugins marketplace list <source>openclaw plugins install <plugin> --marketplace <source>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

OpenClaw がバンドルからマッピングするもの

現在、すべてのバンドル機能が OpenClaw で実行されるわけではありません。以下に、動作するものと、検出はされるもののまだ接続されていないものを示します。

現在サポートされている機能

Skills コンテンツ

• バンドルの Skills ルートは、通常の OpenClaw Skills ルートとして読み込まれます。
• Claude の commands/ ルートは、追加の Skills ルートとして扱われます。
• Cursor の .cursor/commands/ ルートは、追加の Skills ルートとして扱われます。

Claude の Markdown コマンドファイルと Cursor のコマンド Markdown は、どちらも通常の OpenClaw Skills ローダーを通じて動作します。

フックパック

バンドルのフックルートが動作するのは、通常の OpenClaw フックパックレイアウト（HOOK.md と handler.ts または handler.js）を使用している場合のみです。現在、これは主に Codex 互換の場合に該当します。

組み込み OpenClaw 向け MCP

• 有効化されたバンドルは、MCP サーバー設定を提供できます。
• OpenClaw はバンドルの MCP 設定を、有効な組み込み OpenClaw 設定に mcpServers としてマージします。
• OpenClaw は、stdio サーバーを起動するか HTTP サーバーに接続することで、組み込み OpenClaw エージェントのターン中に対応するバンドル MCP ツールを公開します。
• coding および messaging ツールプロファイルには、デフォルトでバンドル MCP ツールが含まれます。エージェントまたは Gateway で無効にするには、tools.deny: ["bundle-mcp"] を使用します。
• プロジェクトローカルの組み込みエージェント設定は、バンドルのデフォルト設定の後に引き続き適用されるため、必要に応じてワークスペース設定でバンドルの MCP エントリを上書きできます。
• バンドル MCP ツールカタログは登録前に決定的にソートされるため、上流の listTools() の順序が変わっても、プロンプトキャッシュのツールブロックが不必要に変動しません。

トランスポート

MCP サーバーでは、stdio または HTTP トランスポートを使用できます。

Stdio は子プロセスを起動します。

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP は実行中の MCP サーバーに接続します。streamable-http が要求されていない場合、デフォルトは sse です。

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• transport には "streamable-http" または "sse" を指定できます。省略時のデフォルトは sse です。
• type: "http" は CLI ネイティブの下流形式です。OpenClaw の設定では transport: "streamable-http" を使用してください。openclaw mcp set と openclaw doctor --fix は、一般的な別名を正規化します。
• 使用できる URL スキームは http: と https: のみです。
• headers の値では ${ENV_VAR} 補間がサポートされます。
• command と url の両方を持つサーバーエントリは拒否されます。
• URL の認証情報（ユーザー情報およびクエリパラメーター）は、ツールの説明とログから秘匿化されます。
• connectionTimeoutMs は、stdio と HTTP の両方のトランスポートに対するデフォルトの 30 秒の接続タイムアウトを上書きします。リクエストタイムアウトのデフォルトは 60 秒で、requestTimeoutMs で上書きできます。

ツール名

OpenClaw は、バンドル MCP ツールを serverName__toolName 形式のプロバイダーで安全に使用できる名前で登録します。たとえば、memory_search ツールを公開する、キーが "vigil-harbor" のサーバーは、vigil-harbor__memory_search として登録されます。

• A-Za-z0-9_- 以外の文字は - に置き換えられます。
• 先頭が英字以外になる断片には英字の接頭辞が付けられるため、12306 のような数字のサーバーキーもプロバイダーで安全に使用できるツール接頭辞になります。
• サーバー接頭辞は最大 30 文字です。
• ツール名全体は最大 64 文字です。
• 空のサーバー名には mcp が使用されます。
• サニタイズ後の名前が衝突する場合は、数字の接尾辞で区別されます。
• 最終的に公開されるツールの順序は安全な名前によって決定的に定まり、組み込みエージェントの反復ターンでもキャッシュが安定します。
• プロファイルフィルタリングでは、1 つのバンドル MCP サーバーのすべてのツールが bundle-mcp によって所有される Plugin として扱われるため、プロファイルの許可/拒否リストでは、公開された個々のツール名または bundle-mcp Plugin キーのいずれかを参照できます。

組み込み OpenClaw 設定

バンドルが有効な場合、Claude の settings.json は組み込み OpenClaw のデフォルト設定としてインポートされます。OpenClaw は適用前に、次のシェル上書きキーをサニタイズします。

• shellPath
• shellCommandPrefix

組み込み OpenClaw LSP

• 有効化された Claude バンドルは、LSP サーバー設定を提供できます。
• OpenClaw は .lsp.json と、マニフェストで宣言されたすべての lspServers パスを読み込みます。
• バンドルの LSP 設定は、有効な組み込み OpenClaw の LSP デフォルト設定にマージされます。
• 現在実行できるのは、対応する stdio ベースの LSP サーバーのみです。非対応のトランスポートも openclaw plugins inspect <id> には表示されます。

検出されるが実行されない機能

以下は認識されて診断情報に表示されますが、OpenClaw は実行しません。

• Claude の agents、hooks/hooks.json オートメーション、outputStyles
• Cursor の .cursor/agents、.cursor/hooks.json、.cursor/rules
• 機能レポート以外の Codex .app.json メタデータ

バンドル形式

検出の優先順位

OpenClaw は最初にネイティブ Plugin 形式を確認します。

1. openclaw.plugin.json、または openclaw.extensions を持つ有効な package.json — ネイティブ Plugin として扱われます
2. バンドルマーカー（.codex-plugin/、.claude-plugin/、または Claude/Cursor のデフォルトレイアウト）— バンドルとして扱われます

ディレクトリに両方が含まれている場合、OpenClaw はネイティブのパスを使用します。これにより、デュアル形式のパッケージがバンドルとして部分的にインストールされるのを防ぎます。

ランタイム依存関係とクリーンアップ

• サードパーティーの互換バンドルには、起動時の npm install 修復は適用されません。これらは openclaw plugins install を通じてインストールし、必要なものをすべてインストール済み Plugin ディレクトリに含める必要があります。
• OpenClaw が所有するバンドル済み Plugin は、コアに軽量な形で同梱されるか、Plugin インストーラーを通じてダウンロードできます。Gateway の起動時に、それらのためにパッケージマネージャーが実行されることはありません。
• openclaw doctor --fix は、古いローカルのバンドル済み Plugin インストール記録を削除します。また、設定から引き続き参照されているものの、ローカル Plugin インデックスに存在しないダウンロード可能な Plugin を復旧できます。

セキュリティ

バンドルは、ネイティブ Plugin よりも信頼境界が狭くなっています。

• OpenClaw は、任意のバンドルランタイムモジュールをプロセス内に読み込みません。
• Skills とフックパックのパスは Plugin ルート内に収まる必要があります（境界チェックあり）。
• 設定ファイルは同じ境界チェックを使用して読み込まれます。
• 対応する stdio MCP サーバーは、サブプロセスとして起動される場合があります。

これにより、バンドルはデフォルトでより安全になりますが、サードパーティー製バンドルについては、公開される機能に関して信頼済みコンテンツとして扱う必要があります。

トラブルシューティング

関連項目

• Plugin のインストールと設定
• Plugin の構築 - ネイティブ Plugin を作成する
• Plugin マニフェスト - ネイティブマニフェストのスキーマ