MCP

openclaw mcp มีหน้าที่สองอย่าง:

• เรียกใช้ OpenClaw เป็นเซิร์ฟเวอร์ MCP ด้วย openclaw mcp serve
• จัดการนิยามเซิร์ฟเวอร์ MCP ขาออกที่ OpenClaw เป็นเจ้าของด้วย list, show, set และ unset

กล่าวอีกอย่างคือ:

• serve คือ OpenClaw ที่ทำหน้าที่เป็นเซิร์ฟเวอร์ MCP
• list / show / set / unset คือ OpenClaw ที่ทำหน้าที่เป็นรีจิสทรีฝั่งไคลเอนต์ MCP สำหรับเซิร์ฟเวอร์ MCP อื่นที่รันไทม์ของมันอาจใช้งานภายหลัง

ใช้ openclaw acp เมื่อ OpenClaw ควรโฮสต์เซสชัน coding harness เองและกำหนดเส้นทางรันไทม์นั้นผ่าน ACP

# OpenClaw ในฐานะเซิร์ฟเวอร์ MCP

นี่คือเส้นทาง openclaw mcp serve

# ควรใช้ serve เมื่อใด

ใช้ openclaw mcp serve เมื่อ:

• Codex, Claude Code หรือไคลเอนต์ MCP อื่นควรคุยโดยตรงกับการสนทนาช่องทางที่รองรับโดย OpenClaw
• คุณมี OpenClaw Gateway แบบภายในเครื่องหรือระยะไกลที่มีเซสชันที่ถูกกำหนดเส้นทางไว้แล้ว
• คุณต้องการเซิร์ฟเวอร์ MCP หนึ่งตัวที่ทำงานได้กับแบ็กเอนด์ช่องทางของ OpenClaw แทนการเรียกใช้บริดจ์แยกสำหรับแต่ละช่องทาง

ใช้ openclaw acp แทนเมื่อ OpenClaw ควรโฮสต์รันไทม์การเขียนโค้ดเองและเก็บเซสชันเอเจนต์ไว้ภายใน OpenClaw

# วิธีทำงาน

openclaw mcp serve เริ่มเซิร์ฟเวอร์ MCP แบบ stdio ไคลเอนต์ MCP เป็นเจ้าของโปรเซสนั้น ขณะที่ไคลเอนต์ยังเปิดเซสชัน stdio ไว้ บริดจ์จะเชื่อมต่อกับ OpenClaw Gateway ภายในเครื่องหรือระยะไกลผ่าน WebSocket และเปิดเผยการสนทนาช่องทางที่ถูกกำหนดเส้นทางผ่าน 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 ได้ด้วย นี่คือสิ่งที่เทียบเท่ากับอะแดปเตอร์ช่องทาง Claude Code ของ OpenClaw: เครื่องมือ MCP มาตรฐานยังพร้อมใช้งาน แต่ข้อความขาเข้าสดสามารถมาถึงเป็นการแจ้งเตือน MCP เฉพาะของ Claude ได้เช่นกัน

เมื่อเปิดใช้โหมดช่องทาง Claude เซิร์ฟเวอร์จะประกาศความสามารถเชิงทดลองของ Claude และสามารถปล่อย:

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

พฤติกรรมบริดจ์ปัจจุบัน:

• ข้อความทรานสคริปต์ user ขาเข้าจะถูกส่งต่อเป็น notifications/claude/channel
• คำขออนุญาต Claude ที่ได้รับผ่าน MCP จะถูกติดตามในหน่วยความจำ
• หากการสนทนาที่เชื่อมโยงส่ง yes abcde หรือ no abcde ในภายหลัง บริดจ์จะแปลงสิ่งนั้นเป็น notifications/claude/channel/permission
• การแจ้งเตือนเหล่านี้มีเฉพาะเซสชันสดเท่านั้น หากไคลเอนต์ MCP ตัดการเชื่อมต่อ จะไม่มีเป้าหมาย push

สิ่งนี้ตั้งใจให้เฉพาะเจาะจงต่อไคลเอนต์ ไคลเอนต์ MCP ทั่วไปควรพึ่งพาเครื่องมือ polling มาตรฐาน

# การกำหนดค่าไคลเอนต์ 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 รู้วิธีกำหนดเส้นทางอยู่แล้วเท่านั้น

หมายความว่า:

• allowlist ของผู้ส่ง การจับคู่ และความเชื่อถือระดับช่องทางยังเป็นของการกำหนดค่าช่องทาง OpenClaw พื้นฐาน
• messages_send สามารถตอบกลับผ่านเส้นทางที่จัดเก็บอยู่แล้วเท่านั้น
• สถานะการอนุมัติเป็นแบบสด/ในหน่วยความจำเท่านั้นสำหรับเซสชันบริดจ์ปัจจุบัน
• การตรวจสอบสิทธิ์ของบริดจ์ควรใช้การควบคุมโทเค็นหรือรหัสผ่าน Gateway เดียวกับที่คุณจะเชื่อถือสำหรับไคลเอนต์ Gateway ระยะไกลอื่น

หากการสนทนาหายไปจาก conversations_list สาเหตุปกติมักไม่ใช่การกำหนดค่า MCP แต่เป็นเมทาดาทาเส้นทางที่ขาดหายหรือไม่สมบูรณ์ในเซสชัน Gateway พื้นฐาน

# การทดสอบ

OpenClaw มาพร้อมกับ smoke Docker แบบกำหนดผลได้สำหรับบริดจ์นี้:

pnpm test:docker:mcp-channels

smoke นั้น:

• เริ่มคอนเทนเนอร์ Gateway ที่ใส่ข้อมูลตั้งต้นไว้
• เริ่มคอนเทนเนอร์ตัวที่สองซึ่งสร้าง openclaw mcp serve
• ตรวจสอบการค้นพบการสนทนา การอ่านทรานสคริปต์ การอ่านเมทาดาทาไฟล์แนบ พฤติกรรมคิวอีเวนต์สด และการกำหนดเส้นทางการส่งขาออก
• ตรวจสอบการแจ้งเตือนช่องทางและสิทธิ์แบบ Claude ผ่านบริดจ์ stdio MCP จริง

นี่เป็นวิธีที่เร็วที่สุดในการพิสูจน์ว่าบริดจ์ทำงานได้โดยไม่ต้องเชื่อมบัญชี Telegram, Discord หรือ iMessage จริงเข้ากับการรันทดสอบ

สำหรับบริบทการทดสอบที่กว้างขึ้น โปรดดู การทดสอบ

# การแก้ไขปัญหา

# OpenClaw ในฐานะรีจิสทรีไคลเอนต์ MCP

นี่คือเส้นทาง openclaw mcp list, show, set และ unset

คำสั่งเหล่านี้ไม่ได้เปิดเผย OpenClaw ผ่าน MCP แต่ใช้จัดการนิยาม MCP server ที่ OpenClaw เป็นเจ้าของภายใต้ mcp.servers ในการกำหนดค่า OpenClaw

นิยามที่บันทึกไว้เหล่านี้มีไว้สำหรับ runtime ที่ OpenClaw เปิดใช้งานหรือกำหนดค่าในภายหลัง เช่น Pi แบบฝังตัวและ runtime adapter อื่น ๆ OpenClaw จัดเก็บนิยามไว้ส่วนกลาง เพื่อให้ runtime เหล่านั้นไม่จำเป็นต้องเก็บรายการ MCP server ซ้ำของตนเอง

runtime adapter อาจปรับ registry ที่ใช้ร่วมกันนี้ให้อยู่ในรูปแบบที่ client ปลายทางคาดหวัง ตัวอย่างเช่น Pi แบบฝังตัวใช้ค่า transport ของ OpenClaw โดยตรง ขณะที่ Claude Code และ Gemini ได้รับค่า type แบบ native ของ CLI เช่น http, sse หรือ stdio

# นิยาม MCP server ที่บันทึกไว้

OpenClaw ยังจัดเก็บ MCP server registry แบบเบาใน config สำหรับพื้นผิวที่ต้องการนิยาม MCP ที่ OpenClaw จัดการ

คำสั่ง:

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

หมายเหตุ:

• list เรียงชื่อ server
• show โดยไม่ระบุชื่อจะพิมพ์ object ของ MCP server ที่กำหนดค่าไว้ทั้งหมด
• set คาดหวังค่า JSON object หนึ่งค่าบนบรรทัดคำสั่ง
• ใช้ transport: "streamable-http" สำหรับ Streamable HTTP MCP server นอกจากนี้ openclaw mcp set ยังปรับ type: "http" แบบ native ของ CLI ให้เป็น config shape มาตรฐานเดียวกันเพื่อความเข้ากันได้
• unset ล้มเหลวหากไม่มี server ชื่อนั้นอยู่

ตัวอย่าง:

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

ตัวอย่าง config shape:

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

# Stdio transport

เปิดใช้งาน child process ภายในเครื่องและสื่อสารผ่าน stdin/stdout

# SSE / HTTP transport

เชื่อมต่อกับ MCP server ระยะไกลผ่าน HTTP Server-Sent Events

ตัวอย่าง:

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

ค่าที่ละเอียดอ่อนใน url (userinfo) และ headers จะถูกปกปิดใน log และผลลัพธ์สถานะ

# Streamable HTTP transport

streamable-http เป็นตัวเลือก transport เพิ่มเติมเคียงคู่กับ sse และ stdio โดยใช้ HTTP streaming สำหรับการสื่อสารสองทางกับ MCP server ระยะไกล

การกำหนดค่า OpenClaw ใช้ transport: "streamable-http" เป็นการสะกดมาตรฐาน ค่า MCP type: "http" แบบ native ของ CLI จะได้รับการยอมรับเมื่อบันทึกผ่าน openclaw mcp set และถูกซ่อมแซมโดย openclaw doctor --fix ใน config ที่มีอยู่ แต่ transport คือสิ่งที่ Pi แบบฝังตัวใช้โดยตรง

ตัวอย่าง:

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

# ข้อจำกัดปัจจุบัน

หน้านี้บันทึก bridge ตามที่จัดส่งอยู่ในปัจจุบัน

ข้อจำกัดปัจจุบัน:

• การค้นพบการสนทนาขึ้นอยู่กับ metadata เส้นทางของ session Gateway ที่มีอยู่
• ไม่มี generic push protocol นอกเหนือจาก adapter เฉพาะของ Claude
• ยังไม่มีเครื่องมือแก้ไขหรือ react ต่อข้อความ
• transport HTTP/SSE/streamable-http เชื่อมต่อกับ remote server เดียว; ยังไม่มี upstream แบบ multiplexed
• permissions_list_open รวมเฉพาะ approval ที่สังเกตได้ขณะ bridge เชื่อมต่ออยู่เท่านั้น

# ที่เกี่ยวข้อง

• ข้อมูลอ้างอิง CLI
• Plugins