Plugin バンドル

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

バンドルが存在する理由

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

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

# Local directoryopenclaw plugins install ./my-bundle # Archiveopenclaw plugins install ./my-bundle.tgz # Claude marketplaceopenclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

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

現時点では、すべてのバンドル機能が OpenClaw で実行されるわけではありません。 動作するものと、検出はされるがまだ接続されていないものは次のとおりです。

現在サポート対象

Skills コンテンツ

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

つまり、Claude の Markdown コマンドファイルは通常の OpenClaw Skills ローダーを通じて動作します。Cursor のコマンド Markdown も同じ経路で動作します。

フックパック

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

埋め込み 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 は、デフォルトでは sse、要求された場合は streamable-http を使って実行中の MCP サーバーに接続します。

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

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

ツール命名

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.json 自動化、outputStyles
• Cursor .cursor/agents、.cursor/hooks.json、.cursor/rules
• 機能レポートを超える Codex インライン/アプリメタデータ

バンドル形式

検出の優先順位

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 よりも狭い信頼境界を持ちます。

• OpenClaw は任意のバンドルランタイムモジュールをインプロセスで読み込まない
• Skills とフックパックのパスは Plugin ルート内に留まる必要がある（境界チェック済み）
• 設定ファイルは同じ境界チェックで読み取られる
• サポート対象の stdio MCP サーバーはサブプロセスとして起動される場合がある

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

トラブルシューティング

関連

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