MCP

Documentation Index

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

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

• 使用 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 頻道後端運作的 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 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"
      ]
    }
  }
}

​

選項

​

安全性與信任邊界

• 傳送者允許清單、配對和頻道層級信任仍屬於底層 OpenClaw 頻道設定
• messages_send 只能透過既有已儲存路由回覆
• 核准狀態只在目前橋接器工作階段中即時/記憶體內存在
• 橋接器驗證應使用你會信任給任何其他遠端 Gateway 用戶端的相同 Gateway 權杖或密碼控制

​

測試

pnpm test:docker:mcp-channels

• 啟動一個已植入資料的 Gateway 容器
• 啟動第二個會產生 openclaw mcp serve 的容器
• 驗證對話探索、文字記錄讀取、附件中繼資料讀取、即時事件佇列行為和對外傳送路由
• 透過真實的 stdio MCP 橋接器驗證 Claude 風格的頻道與權限通知

​

疑難排解

​

OpenClaw 作為 MCP 用戶端登錄檔

​

已儲存的 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 傳輸

​

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 傳輸會連線到單一遠端伺服器；尚無多工上游
• permissions_list_open 只包含橋接器連線期間觀察到的核准

​

相關

• CLI 參考
• Plugin