​

mcp

• openclaw mcp serve で OpenClaw を MCP サーバーとして実行する
• list、show、 set、unset で、OpenClaw が所有する送信先 MCP サーバー定義を管理する

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

​

OpenClaw を MCP サーバーとして使う

​

serve を使うべきとき

• Codex、Claude Code、または別の MCP クライアントが、 OpenClaw ベースのチャネル会話と直接やり取りする必要がある
• すでにローカルまたはリモートの OpenClaw Gateway があり、セッションがルーティングされている
• チャネルごとに別々のブリッジを実行するのではなく、 OpenClaw の各チャネルバックエンドを横断して動作する 1 つの MCP サーバーが欲しい

​

仕組み

1. MCP クライアントが openclaw mcp serve を起動する
2. ブリッジが Gateway に接続する
3. ルーティングされたセッションが MCP の会話および transcript/history ツールとして利用可能になる
4. ブリッジ接続中はライブイベントがメモリ内にキューされる
5. Claude チャネルモードが有効な場合、同じセッションで Claude 固有のプッシュ通知も受け取れる

• ライブキューの状態はブリッジ接続時点から始まる
• それ以前の transcript 履歴は messages_read で読み出す
• Claude のプッシュ通知は MCP セッションが生きている間だけ存在する
• クライアントが切断すると、ブリッジは終了し、ライブキューも消える

​

クライアントモードを選ぶ

• 汎用 MCP クライアント: 標準 MCP ツールのみ。conversations_list、 messages_read、events_poll、events_wait、messages_send、および 承認ツールを使います。
• Claude Code: 標準 MCP ツールに加えて Claude 固有のチャネルアダプターも使います。 --claude-channel-mode on を有効にするか、デフォルトの auto のままにします。

​

serve が公開するもの

• channel
• recipient または destination メタデータ
• 任意の accountId
• 任意の threadId

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

​

使用方法

# ローカル Gateway
openclaw mcp serve

# リモート Gateway
openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

# パスワード認証付きリモート Gateway
openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

# 詳細なブリッジログを有効化
openclaw mcp serve --verbose

# Claude 固有のプッシュ通知を無効化
openclaw mcp serve --claude-channel-mode off

​

ブリッジツール

• conversations_list
• conversation_get
• messages_read
• attachments_fetch
• events_poll
• events_wait
• messages_send
• permissions_list_open
• permissions_respond

​

conversations_list

• limit
• search
• channel
• includeDerivedTitles
• includeLastMessage

​

conversation_get

​

messages_read

​

attachments_fetch

​

events_poll

​

events_wait

​

messages_send

• 既存の会話ルートが必要
• セッションの channel、recipient、account id、thread id を使う
• テキストのみ送信する

​

permissions_list_open

​

permissions_respond

• allow-once
• allow-always
• deny

​

イベントモデル

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

• キューはライブ専用であり、MCP ブリッジ開始時点から始まる
• events_poll と events_wait は、それ自体では古い Gateway 履歴を 再生しない
• 永続的なバックログは messages_read で読む必要がある

​

Claude チャネル通知

• --claude-channel-mode off: 標準 MCP ツールのみ
• --claude-channel-mode on: Claude チャネル通知を有効化
• --claude-channel-mode auto: 現在のデフォルト。on と同じブリッジ動作

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

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

​

MCP クライアント設定

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

​

オプション

• --url <url>: Gateway WebSocket URL
• --token <token>: Gateway トークン
• --token-file <path>: ファイルからトークンを読み取る
• --password <password>: Gateway パスワード
• --password-file <path>: ファイルからパスワードを読み取る
• --claude-channel-mode <auto|on|off>: Claude 通知モード
• -v, --verbose: stderr に詳細ログを出す

​

セキュリティと信頼境界

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

​

テスト

pnpm test:docker:mcp-channels

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

​

トラブルシューティング

​

会話が返ってこない

​

events_poll または events_wait が古いメッセージを取りこぼす

​

Claude 通知が表示されない

• クライアントが stdio MCP セッションを開いたままにしていた
• --claude-channel-mode が on または auto
• クライアントが実際に Claude 固有の通知メソッドを理解できる
• 受信メッセージがブリッジ接続後に発生した

​

承認が表示されない

​

OpenClaw を MCP クライアントレジストリとして使う

• これらのコマンドは OpenClaw config の読み書きだけを行う
• 対象の MCP サーバーには接続しない
• コマンド、URL、またはリモートトランスポートが 現時点で到達可能かどうかは検証しない
• ランタイムアダプターは、実行時に実際にサポートするトランスポート形状を決定する

​

保存済み MCP サーバー定義

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

• list はサーバー名をソートします。
• show は名前なしの場合、設定済みの MCP サーバーオブジェクト全体を出力します。
• set はコマンドライン上で 1 つの JSON オブジェクト値を受け取ります。
• 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"}'
openclaw mcp unset context7

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

​

Stdio トランスポート

​

SSE / HTTP トランスポート

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

​

Streamable HTTP トランスポート

{
  "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 トランスポートは単一のリモートサーバーに接続する。まだ upstream の多重化はない
• permissions_list_open には、ブリッジ接続中に 観測された承認のみが含まれる