MCP

• openclaw mcp serve を使用して OpenClaw を MCP サーバーとして実行する
• list、show、status、doctor、probe、add、set、configure、tools、login、logout、reload、unset を使用して、OpenClaw が管理する送信 MCP サーバー定義を管理する

​

適切な MCP パスを選択する

​

MCP サーバーとしての OpenClaw

​

serve を使用する場合

• Codex、Claude Code、またはその他の MCP クライアントから、OpenClaw によって支えられたチャネルの会話に直接接続する場合
• ルーティング済みセッションを持つローカルまたはリモートの OpenClaw Gateway がすでにある場合
• チャネルごとに個別のブリッジを実行する代わりに、OpenClaw の各チャネルバックエンドで動作する 1 つの MCP サーバーを使用する場合

​

仕組み

​

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

​

serve が公開するもの

• channel
• 受信者または送信先のメタデータ
• オプションの accountId
• オプションの threadId

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

​

使用方法

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

​

ブリッジツール

​

イベントモデル

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

​

Claude チャネル通知

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

• 受信した user トランスクリプトメッセージは notifications/claude/channel として転送されます
• MCP 経由で受信した Claude の権限リクエストはメモリ内で追跡されます
• リンクされた会話のコマンド所有者が後で yes <id> または no <id>（<id> は l を除いた 5 文字のリクエスト ID）を送信すると、ブリッジはそれを notifications/claude/channel/permission に変換します
• これらの通知はライブセッション専用です。MCP クライアントが切断すると、プッシュ先はなくなります

​

MCP クライアント設定

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

​

オプション

​

セキュリティと信頼境界

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

​

テスト

pnpm test:docker:mcp-channels

​

トラブルシューティング

​

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

​

保存済み MCP サーバー定義

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp status [--verbose]
• openclaw mcp doctor [name] [--probe]
• openclaw mcp probe [name]
• openclaw mcp add <name> [flags]
• openclaw mcp set <name> <json>
• openclaw mcp configure <name> [flags]
• openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]
• openclaw mcp login <name> [--code code]
• openclaw mcp logout <name>
• openclaw mcp reload
• openclaw mcp unset <name>

• list はサーバー名を並べ替えます。
• 名前を指定しない show は、設定済み MCP サーバーオブジェクト全体を出力します。
• status は、接続せずに設定済みトランスポートを分類します。--verbose には、保存済み OAuth トークンに追加の認可が必要な場合を含め、解決済みの起動、タイムアウト、OAuth、フィルター、並列呼び出しの詳細が含まれます。認証情報を含む stdio 引数は、テキストおよび JSON 出力で秘匿されます。
• doctor は、接続せずに静的チェックを実行します。有効なサーバーに接続できることもコマンドで検証する場合は、--probe を追加します。
• probe は接続し、ツール数、リソース／プロンプトのサポート、リスト変更のサポート、および診断を報告します。
• add は、--command、--arg、--env、--cwd などの stdio フラグ、または --url、--transport、--header、--auth oauth、TLS、タイムアウト、ツール選択フラグなどの HTTP フラグを受け入れます。
• set は、コマンドラインで 1 つの JSON オブジェクト値を受け取ります。
• configure は、サーバー定義全体を置き換えることなく、有効化状態、ツールフィルター、タイムアウト、OAuth、TLS、および並列ツール呼び出しのヒントを更新します。保存前に更新後のサーバーを検証するには、--probe を追加します。
• tools は、サーバーごとのツールフィルターを更新します。包含／除外エントリには、MCP ツール名と単純な * glob を指定します。
• login は、auth: "oauth" で設定された HTTP サーバーに対して OAuth フローを実行します。初回実行では認可 URL が出力されます。承認後、--code を指定して再実行します。
• logout は、保存済みサーバー定義を削除せずに、指定したサーバーの保存済み OAuth 認証情報を消去します。
• reload は、現在の CLI プロセスにあるキャッシュ済みインプロセス MCP ランタイムのみを破棄します。別プロセスの Gateway またはエージェントプロセスでは、引き続き固有の再読み込みまたは再起動パスが必要です。
• Streamable HTTP MCP サーバーには transport: "streamable-http" を使用します。openclaw mcp set は、互換性のために CLI ネイティブの type: "http" も同じ正規設定形式へ正規化します。
• 指定したサーバーが存在しない場合、unset は失敗します。

openclaw mcp list
openclaw mcp show context7 --json
openclaw mcp status --verbose
openclaw mcp doctor --probe
openclaw mcp probe context7 --json
openclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memory
openclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'
openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'
openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'
openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'
openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'
openclaw mcp login docs
openclaw mcp logout docs
openclaw mcp unset context7

​

一般的なサーバーレシピ

openclaw mcp add files \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-filesystem \
  --arg "$HOME/Documents" \
  --include 'read_file,list_directory,search_files'
openclaw mcp doctor files --probe

openclaw mcp add memory \
  --command npx \
  --arg -y \
  --arg @modelcontextprotocol/server-memory
openclaw mcp probe memory --json

openclaw mcp add local-tools \
  --command node \
  --arg ./dist/mcp-server.js \
  --cwd /srv/openclaw-tools \
  --env API_BASE=https://internal.example
openclaw mcp status --verbose

openclaw mcp add docs \
  --url https://mcp.example.com/mcp \
  --transport streamable-http \
  --auth oauth \
  --oauth-scope docs.read \
  --timeout 20 \
  --connect-timeout 5 \
  --include 'search,read_*'
openclaw mcp doctor docs --probe

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
openclaw mcp tools cua-driver --include 'list_apps,get_window_state,click,type_text'
openclaw mcp doctor cua-driver --probe

​

JSON 出力形式

{
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "configured": true,
      "enabled": true,
      "ok": true,
      "transport": "streamable-http",
      "launch": "streamable-http https://mcp.example.com/mcp",
      "auth": "oauth",
      "authStatus": {
        "hasTokens": true,
        "requiresAuthorization": false,
        "hasClientInformation": true,
        "hasCodeVerifier": false,
        "hasDiscoveryState": true,
        "hasLastAuthorizationUrl": false
      },
      "requestTimeoutMs": 20000,
      "connectionTimeoutMs": 5000,
      "toolFilter": {
        "include": ["search", "read_*"],
        "exclude": []
      },
      "supportsParallelToolCalls": true
    }
  ]
}

{
  "ok": true,
  "path": "/home/user/.openclaw/openclaw.json",
  "servers": [
    {
      "name": "docs",
      "ok": true,
      "issues": [
        {
          "level": "warning",
          "message": "OAuth 認証情報が認可されていません。openclaw mcp login docs を実行してください"
        }
      ]
    }
  ]
}

{
  "generatedAt": "2026-05-31T09:00:00.000Z",
  "servers": {
    "docs": {
      "launch": "streamable-http https://mcp.example.com/mcp",
      "tools": 2,
      "resources": true,
      "listChanged": {
        "tools": true,
        "resources": false,
        "prompts": false
      }
    }
  },
  "tools": ["docs__read_page", "docs__search"],
  "diagnostics": []
}

{
  "mcp": {
    "servers": {
      "context7": {
        "command": "uvx",
        "args": ["context7-mcp"]
      },
      "docs": {
        "url": "https://mcp.example.com",
        "transport": "streamable-http",
        "requestTimeoutMs": 20000,
        "connectionTimeoutMs": 5000,
        "supportsParallelToolCalls": true,
        "auth": "oauth",
        "oauth": {
          "scope": "docs.read"
        },
        "sslVerify": true,
        "clientCert": "/path/to/client.crt",
        "clientKey": "/path/to/client.key",
        "toolFilter": {
          "include": ["search_*"],
          "exclude": ["admin_*"]
        }
      }
    }
  }
}

​

Stdio トランスポート

​

SSE / HTTP トランスポート

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

​

OAuth ワークフロー

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"authProfileId":"docs:mcp"}}'

openclaw mcp login docs

openclaw mcp login docs --code abc123

openclaw mcp status --verbose
openclaw mcp doctor docs --probe

openclaw mcp logout docs

​

ストリーミング可能な HTTP トランスポート

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

​

Control UI

1. Control UI を開き、MCP を選択します。
2. 合計、有効、OAuth、フィルター済みの各サーバーについて、概要カードを確認します。
3. 各サーバー行で、トランスポート、認証、フィルター、タイムアウト、コマンドのヒントを確認します。
4. 定義を維持しながらランタイム検出から除外する場合は、有効化状態を切り替えます。
5. 新しいサーバー、ヘッダー、TLS、OAuth メタデータ、ツールフィルターなどの構造的な変更を行うには、スコープ限定の mcp 設定セクションを編集します。
6. 設定のみを永続化するには Save、Gateway の設定パスを通じて適用するには Save & Publish を選択します。
7. 編集したサーバーが起動してツールを一覧表示することを実際に確認する必要がある場合は、openclaw mcp doctor --probe を実行します。

• コマンドスニペットでは、特殊な名前でもシェルにコピーできるようにサーバー名を引用符で囲みます
• 表示される URL 形式の値に認証情報が埋め込まれている場合、レンダリング前に秘匿されます
• このページ自体は MCP トランスポートを起動しません
• MCP クライアントを所有するプロセスに応じて、稼働中のランタイムには openclaw mcp reload、Gateway 設定の公開、またはプロセスの再起動が必要になる場合があります

​

MCP Apps

openclaw config set mcp.apps.enabled true --strict-json

{
  mcp: {
    apps: {
      enabled: true,
      sandboxOrigin: "https://mcp-apps.example.com",
      sandboxPort: 18790,
    },
  },
}

{
  mcp: {
    apps: { enabled: true },
    servers: {
      "basic-react": {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-basic-react", "--stdio"],
      },
    },
  },
}

• OpenClaw は、Apps が有効な場合に限り io.modelcontextprotocol/ui 拡張機能を通知します。
• 正確に text/html;profile=mcp-app MIME タイプを持つ ui:// リソースだけがレンダリングされます。
• UI リソースは 2 MiB に制限され、専用の外側オリジンにある二重 iframe プロキシの背後に配置され、不透明な内側の App オリジンに読み込まれ、リソースメタデータから派生した CSP によって制約されます。
• App 専用ツール（_meta.ui.visibility: ["app"]）はモデルのツール一覧に含まれません。Apps が呼び出せるのは、ビューを作成した実行の有効な OpenClaw ツールポリシーにも適合する、所有元サーバー上の App から可視のツールだけです。
• 内側の App ドキュメントが App 間分離のために不透明なオリジンを使用している間は、カメラ、マイク、位置情報など、オリジンに紐づく App 権限は付与されません。
• App HTML、完全なツール引数、および未加工の結果は、上限 10 分間のメモリ内ビューリースに保持され、ディスクへの書き込みやトランスクリプトのプレビューメタデータへのコピーは行われません。トランスクリプトには、元のツール呼び出し ID に紐づく、サイズ制限されたサーバー/ツール/リソース記述子だけが保存されます。Gateway の再起動後、Control UI は認証済みセッションのトランスクリプトに照らしてその記述子を検証し、ui:// リソースを再取得できます。再構築されたビューは、新しい実行によって現在のツール権限が確立されるまで読み取り専用です。
• チャネルでの会話では、ターン内で最後に成功した App ビューにより、アシスタントの最終返信へ Open App 形式のアクションが 1 つ追加されます。Telegram の DM ではネイティブの Mini App ボタンを使用し、Slack と Discord では同じポータブルアクションをリンクとしてレンダリングします。その他のチャネルでは元の返信テキストを維持し、理解しやすい HTTPS リンクを追加します。
• チャネル起動リンクを利用できるのは、Gateway の Tailscale 公開によって、公開済みの HTTPS オリジンが準備されている場合だけです。gateway.tailscale.mode: "serve" は tailnet からのみ到達でき、"funnel" は公開インターネットから到達できます。gateway.tailscale.preserveFunnel によって維持される外部管理の Funnel も、インターネットから到達可能として扱われます。Tailscaleを参照してください。
• 起動チケットは不透明であり、チャネルの最終返信を具体化するときにのみ発行され、最大 2 分後、または基盤となるビューリースの期限切れ時の、いずれか早い時点で期限切れになります。URL には、Gateway のベアラー認証情報、セッションキー、ビューメタデータ、App HTML、ツール入力、ツール結果は含まれません。
• 公開済みオリジンまたはチケット容量を利用できない場合、ビューまたはチケットの有効期限が切れている場合、あるいはトランスポートがネイティブコントロールをレンダリングできない場合でも、元のアシスタントテキストは引き続き利用できます。Control UI は既存のインライン App キャンバスを維持し、重複する起動アクションは受け取りません。
• ブリッジが有効な間は、openclaw security audit が警告します。不要な場合は openclaw config set mcp.apps.enabled false --strict-json で無効にしてください。

​

現在の制限

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

​

関連項目

• CLI リファレンス
• Plugins