Plugin バンドル

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

バンドルが存在する理由

​

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

# Local directory
openclaw plugins install ./my-bundle

# Archive
openclaw plugins install ./my-bundle.tgz

# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

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

​

現在サポート済み

​

Skill コンテンツ

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

​

フックパック

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

​

Pi 向け MCP

• 有効化されたバンドルは MCP サーバー設定を提供できます
• OpenClaw は、バンドルの MCP 設定を有効な組み込み Pi 設定へ mcpServers としてマージします
• OpenClaw は、stdio サーバーを起動するか HTTP サーバーへ接続することで、組み込み Pi エージェントのターン中にサポートされているバンドル MCP ツールを公開します
• coding と messaging のツールプロファイルには、デフォルトでバンドル MCP ツールが含まれます。エージェントまたは Gateway で除外するには tools.deny: ["bundle-mcp"] を使用します
• プロジェクトローカルの Pi 設定はバンドルのデフォルト後にも適用されるため、必要に応じてワークスペース設定でバンドル 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" に設定できます。省略した場合、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 秒接続タイムアウトを上書きします

ツール名

• A-Za-z0-9_- 以外の文字は - に置き換えられます
• 数字のサーバーキー（12306 など）がプロバイダーで安全なツール接頭辞になるように、英字以外で始まる断片には英字接頭辞が付きます
• サーバー接頭辞は 30 文字に制限されます
• 完全なツール名は 64 文字に制限されます
• 空のサーバー名は mcp にフォールバックします
• サニタイズ後の名前が衝突する場合は、数字の接尾辞で曖昧さが解消されます
• Pi の繰り返しターンでキャッシュを安定させるため、最終的に公開されるツールの順序は安全な名前に基づいて決定論的です
• プロファイルフィルタリングでは、1 つのバンドル MCP サーバーのすべてのツールを bundle-mcp によって Plugin 所有のものとして扱うため、プロファイルの許可リストと拒否リストには個別の公開ツール名または bundle-mcp Plugin キーのどちらも含められます

​

組み込み Pi 設定

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

• shellPath
• shellCommandPrefix

​

組み込み Pi LSP

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

​

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

• Claude の agents、hooks.json 自動化、outputStyles
• Cursor の .cursor/agents、.cursor/hooks.json、.cursor/rules
• 機能報告以外の Codex インライン/アプリメタデータ

​

バンドル形式

​

検出の優先順位

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 を復旧できます。

​

セキュリティ

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

​

トラブルシューティング

​

関連

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