MCP

openclaw mcp 有兩個工作：

• 使用 openclaw mcp serve 將 OpenClaw 作為 MCP 伺服器執行
• 使用 list、show、set 和 unset 管理 OpenClaw 擁有的對外 MCP 伺服器定義

換句話說：

• serve 是 OpenClaw 作為 MCP 伺服器運作
• list / show / set / unset 是 OpenClaw 作為 MCP 用戶端側登錄檔，供其執行階段之後可取用的其他 MCP 伺服器使用

當 OpenClaw 應自行託管編碼工具鏈工作階段，並透過 ACP 路由該執行階段時，請使用 openclaw acp。

# OpenClaw 作為 MCP 伺服器

這是 openclaw mcp serve 路徑。

# 何時使用 serve

在下列情況使用 openclaw mcp serve：

• Codex、Claude Code 或另一個 MCP 用戶端應直接與 OpenClaw 支援的頻道對話溝通
• 你已經有本機或遠端 OpenClaw Gateway，且有已路由的工作階段
• 你想要一個可跨 OpenClaw 頻道後端運作的 MCP 伺服器，而不是為每個頻道各自執行橋接器

當 OpenClaw 應自行託管編碼執行階段，並將代理工作階段保留在 OpenClaw 內時，請改用 openclaw acp。

# 運作方式

openclaw mcp serve 會啟動一個 stdio MCP 伺服器。MCP 用戶端擁有該程序。只要用戶端保持 stdio 工作階段開啟，橋接器就會透過 WebSocket 連線到本機或遠端 OpenClaw Gateway，並透過 MCP 公開已路由的頻道對話。

# 選擇用戶端模式

以兩種不同方式使用同一個橋接器：

# serve 公開的內容

橋接器會使用現有 Gateway 工作階段路由中繼資料來公開由頻道支援的對話。當 OpenClaw 已有具備已知路由的工作階段狀態時，對話就會出現，例如：

• channel
• 收件者或目的地中繼資料
• 選用 accountId
• 選用 threadId

這讓 MCP 用戶端可以在一處：

• 列出最近的已路由對話
• 讀取最近的文字記錄歷史
• 等待新的傳入事件
• 透過相同路由傳回回覆
• 查看橋接器連線期間到達的核准要求

# 使用方式

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 專屬頻道通知。這是 OpenClaw 等同於 Claude Code 頻道配接器的功能：標準 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 的容器
• 驗證對話探索、文字記錄讀取、附件中繼資料讀取、即時事件佇列行為和對外傳送路由
• 透過真實的 stdio MCP 橋接器驗證 Claude 風格的頻道與權限通知

這是在不將真實 Telegram、Discord 或 iMessage 帳號接入測試執行的情況下，證明橋接器可正常運作的最快方式。

如需更廣泛的測試背景，請參閱 測試。

# 疑難排解

# OpenClaw 作為 MCP 用戶端登錄檔

這是 openclaw mcp list、show、set 與 unset 路徑。

這些命令不會透過 MCP 暴露 OpenClaw。它們會管理 OpenClaw 設定中 mcp.servers 底下由 OpenClaw 擁有的 MCP 伺服器定義。

這些已儲存的定義供 OpenClaw 稍後啟動或設定的執行階段使用，例如嵌入式 Pi 和其他執行階段配接器。OpenClaw 會集中儲存這些定義，因此那些執行階段不需要維護自己的重複 MCP 伺服器清單。

執行階段配接器可能會將這個共享登錄正規化成其下游用戶端預期的形狀。例如，嵌入式 Pi 會直接使用 OpenClaw 的 transport 值，而 Claude Code 和 Gemini 會收到 CLI 原生的 type 值，例如 http、sse 或 stdio。

# 已儲存的 MCP 伺服器定義

OpenClaw 也會在設定中儲存輕量 MCP 伺服器登錄，供需要 OpenClaw 管理 MCP 定義的介面使用。

命令：

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

注意事項：

• list 會排序伺服器名稱。
• 不帶名稱的 show 會印出完整設定的 MCP 伺服器物件。
• set 預期命令列上有一個 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 之外的額外傳輸選項。它使用 HTTP 串流與遠端 MCP 伺服器進行雙向通訊。

OpenClaw 設定使用 transport: "streamable-http" 作為標準寫法。透過 openclaw mcp set 儲存時，會接受 CLI 原生的 MCP type: "http" 值，並且在既有設定中由 openclaw doctor --fix 修復，但 transport 是嵌入式 Pi 會直接使用的內容。

範例：

{
  "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 參考
• Plugin