Plugin バンドル

​

バンドルが存在する理由

​

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

# ローカルディレクトリ
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 list
openclaw plugins inspect <id>

openclaw gateway restart

​

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

​

現在対応しているもの

​

スキルコンテンツ

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

​

フックパック

​

埋め込み OpenClaw の MCP

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

トランスポート

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

{
  "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 で上書きできます。

ツールの命名

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

​

埋め込み OpenClaw 設定

• shellPath
• shellCommandPrefix

​

埋め込み OpenClaw LSP

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

​

検出されるが実行されないもの

• Claude の agents、hooks/hooks.json 自動化、outputStyles
• Cursor の .cursor/agents、.cursor/hooks.json、.cursor/rules
• 機能レポート以外の Codex .app.json メタデータ

​

バンドル形式

​

検出の優先順位

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

​

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

• サードパーティ製の互換バンドルでは、起動時の 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 マニフェスト - ネイティブマニフェストのスキーマ