MCP

openclaw mcp には 2 つの役割があります。

• openclaw mcp serve で OpenClaw を MCP サーバーとして実行する
• list、show、set、unset で、OpenClaw が所有するアウトバウンド MCP サーバー定義を管理する

つまり、次のようになります。

• serve は、MCP サーバーとして動作する OpenClaw です
• list / show / set / unset は、ランタイムが後で利用する可能性のある他の MCP サーバー向けに、MCP クライアント側レジストリとして動作する OpenClaw です

OpenClaw 自体がコーディングハーネスセッションをホストし、そのランタイムを ACP 経由でルーティングする必要がある場合は、openclaw acp を使用します。

# MCP サーバーとしての OpenClaw

これは openclaw mcp serve の経路です。

# serve を使用する場合

次の場合に openclaw mcp serve を使用します。

• Codex、Claude Code、または別の MCP クライアントが、OpenClaw が支えるチャンネル会話と直接通信する必要がある
• ルーティング済みセッションを持つローカルまたはリモートの OpenClaw Gateway がすでにある
• チャンネルごとに個別のブリッジを実行するのではなく、OpenClaw のチャンネルバックエンド全体で動作する 1 つの MCP サーバーが必要

OpenClaw がコーディングランタイム自体をホストし、エージェントセッションを OpenClaw 内に保持する必要がある場合は、代わりに openclaw acp を使用します。

# 仕組み

openclaw mcp serve は stdio MCP サーバーを起動します。MCP クライアントがそのプロセスを所有します。クライアントが stdio セッションを開いたままにしている間、ブリッジは WebSocket 経由でローカルまたはリモートの OpenClaw Gateway に接続し、ルーティング済みチャンネル会話を MCP 経由で公開します。

# クライアントモードを選択する

同じブリッジを 2 通りの方法で使用できます。

# serve が公開するもの

ブリッジは既存の Gateway セッションルートメタデータを使用して、チャンネルが支える会話を公開します。OpenClaw に、次のような既知のルートを持つセッション状態がすでにある場合、会話が表示されます。

• channel
• 受信者または宛先メタデータ
• 任意の accountId
• 任意の threadId

これにより MCP クライアントは 1 か所で次のことができます。

• 最近のルーティング済み会話を一覧表示する
• 最近のトランスクリプト履歴を読む
• 新しい受信イベントを待つ
• 同じルートを通じて返信を送信する
• ブリッジ接続中に届く承認リクエストを確認する

# 使用方法

openclaw mcp serve

openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

openclaw mcp serve --verbose
openclaw mcp serve --claude-channel-mode off

# ブリッジツール

現在のブリッジは、次の MCP ツールを公開します。

# イベントモデル

ブリッジは、接続されている間、メモリ内イベントキューを保持します。

現在のイベントタイプ:

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

# Claude チャンネル通知

ブリッジは Claude 固有のチャンネル通知も公開できます。これは Claude Code チャンネルアダプターに相当する OpenClaw の機能です。標準 MCP ツールは引き続き利用できますが、ライブの受信メッセージを Claude 固有の MCP 通知として受け取ることもできます。

Claude チャンネルモードが有効な場合、サーバーは Claude の実験的機能を告知し、次を発行できます。

• notifications/claude/channel
• notifications/claude/channel/permission

現在のブリッジ動作:

• 受信した user トランスクリプトメッセージは notifications/claude/channel として転送されます
• MCP 経由で受け取った Claude 権限リクエストはメモリ内で追跡されます
• リンクされた会話が後で yes abcde または no abcde を送信した場合、ブリッジはそれを notifications/claude/channel/permission に変換します
• これらの通知はライブセッション専用です。MCP クライアントが切断されると、プッシュ先はありません

これは意図的にクライアント固有です。汎用 MCP クライアントは標準のポーリングツールに依存する必要があります。

# MCP クライアント設定

stdio クライアント設定の例:

{
  "mcpServers": {
    "openclaw": {
      "command": "openclaw",
      "args": [
        "mcp",
        "serve",
        "--url",
        "wss://gateway-host:18789",
        "--token-file",
        "/path/to/gateway.token"
      ]
    }
  }
}

ほとんどの汎用 MCP クライアントでは、標準ツールサーフェスから始め、Claude モードは無視します。Claude 固有の通知メソッドを実際に理解するクライアントでのみ、Claude モードをオンにします。

# オプション

openclaw mcp serve は次をサポートします。

# セキュリティと信頼境界

ブリッジはルーティングを作り出しません。Gateway がすでにルーティング方法を把握している会話のみを公開します。

つまり、次のようになります。

• 送信者許可リスト、ペアリング、チャンネルレベルの信頼は、引き続き基盤となる OpenClaw チャンネル設定に属します
• messages_send は、既存の保存済みルートを通じてのみ返信できます
• 承認状態は、現在のブリッジセッションに対してのみライブ/メモリ内です
• ブリッジ認証には、他のリモート Gateway クライアントに対して信頼するものと同じ Gateway トークンまたはパスワード制御を使用する必要があります

会話が conversations_list にない場合、通常の原因は MCP 設定ではありません。基盤となる Gateway セッションに、ルートメタデータが欠落しているか不完全です。

# テスト

OpenClaw には、このブリッジ向けの決定的な Docker スモークが同梱されています。

pnpm test:docker:mcp-channels

このスモークは次を行います。

• シード済み Gateway コンテナを起動する
• openclaw mcp serve を生成する 2 つ目のコンテナを起動する
• 会話検出、トランスクリプト読み取り、添付ファイルメタデータ読み取り、ライブイベントキューの動作、アウトバウンド送信ルーティングを検証する
• 実際の stdio MCP ブリッジ経由で、Claude スタイルのチャンネル通知と権限通知を検証する

これは、実際の Telegram、Discord、または iMessage アカウントをテスト実行に接続せずに、ブリッジが動作することを証明する最速の方法です。

より広いテストの文脈については、テスト を参照してください。

# トラブルシューティング

# MCP クライアントレジストリとしての OpenClaw

これは openclaw mcp list、show、set、unset のパスです。

これらのコマンドは MCP 経由で OpenClaw を公開しません。OpenClaw 設定の mcp.servers 配下にある、OpenClaw が所有する MCP サーバー定義を管理します。

保存されたこれらの定義は、組み込み Pi やその他のランタイムアダプターなど、OpenClaw が後で起動または設定するランタイム向けです。OpenClaw は定義を一元的に保存するため、それらのランタイムが独自の重複した MCP サーバーリストを保持する必要はありません。

ランタイムアダプターは、この共有レジストリを下流クライアントが期待する形状に正規化する場合があります。たとえば、組み込み Pi は OpenClaw の transport 値を直接使用しますが、Claude Code と Gemini は http、sse、stdio などの CLI ネイティブな type 値を受け取ります。

# 保存済み MCP サーバー定義

OpenClaw は、OpenClaw 管理の MCP 定義を必要とするサーフェス向けに、軽量な MCP サーバーレジストリも設定に保存します。

コマンド:

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp set <name> <json>
• openclaw mcp unset <name>

注記:

• list はサーバー名をソートします。
• 名前なしの show は、設定済みの MCP サーバーオブジェクト全体を出力します。
• set は、コマンドライン上で 1 つの JSON オブジェクト値を想定します。
• Streamable HTTP MCP サーバーには transport: "streamable-http" を使用します。openclaw mcp set は互換性のため、CLI ネイティブな type: "http" も同じ正規の設定形状に正規化します。
• 名前付きサーバーが存在しない場合、unset は失敗します。

例:

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp unset context7

設定形状の例:

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http"
      }
    }
  }
}

# Stdio トランスポート

ローカルの子プロセスを起動し、stdin/stdout 経由で通信します。

# SSE / HTTP トランスポート

HTTP Server-Sent Events 経由でリモート MCP サーバーに接続します。

例:

{
  "mcp": {
    "servers": {
      "remote-tools": {
        "url": "https://mcp.example.com",
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

url（userinfo）と headers の機密値は、ログとステータス出力で編集されます。

# Streamable HTTP トランスポート

streamable-http は、sse と stdio に並ぶ追加のトランスポートオプションです。リモート MCP サーバーとの双方向通信に HTTP ストリーミングを使用します。

OpenClaw 設定では、transport: "streamable-http" を正規の表記として使用します。CLI ネイティブな MCP の type: "http" 値は、openclaw mcp set 経由で保存される場合に受け入れられ、既存設定では openclaw doctor --fix によって修復されますが、組み込み Pi が直接使用するのは transport です。

例:

{
  "mcp": {
    "servers": {
      "streaming-tools": {
        "url": "https://mcp.example.com/stream",
        "transport": "streamable-http",
        "connectionTimeoutMs": 10000,
        "headers": {
          "Authorization": "Bearer <token>"
        }
      }
    }
  }
}

# 現在の制限

このページは、現在出荷されているブリッジを文書化しています。

現在の制限:

• 会話検出は既存の Gateway セッションルートメタデータに依存します
• Claude 固有のアダプター以外に汎用プッシュプロトコルはありません
• メッセージ編集ツールやリアクションツールはまだありません
• HTTP/SSE/streamable-http トランスポートは単一のリモートサーバーに接続します。多重化されたアップストリームはまだありません
• permissions_list_open には、ブリッジ接続中に観測された承認のみが含まれます

# 関連

• CLI リファレンス
• Plugins