MCP

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

• เรียกใช้ OpenClaw เป็นเซิร์ฟเวอร์ MCP ด้วย openclaw mcp serve
• จัดการข้อกำหนดเซิร์ฟเวอร์ MCP ขาออกที่ OpenClaw จัดการด้วย list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload และ unset

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

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

เลือกเส้นทาง MCP ที่เหมาะสม

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 --verboseopenclaw mcp serve --claude-channel-mode off

เครื่องมือบริดจ์

โมเดลเหตุการณ์

บริดจ์เก็บคิวเหตุการณ์ไว้ในหน่วยความจำขณะที่เชื่อมต่ออยู่

ประเภทเหตุการณ์ปัจจุบัน:

• 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 <id> หรือ no <id> ในภายหลัง (<id> คือรหัสคำขอ 5 ตัวอักษร โดยไม่รวม l) บริดจ์จะแปลงเป็น 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 ผ่านบริดจ์ MCP แบบ stdio จริง การกำหนดเส้นทางการส่งออก (messages_send ที่นำเส้นทางบทสนทนาที่บันทึกไว้กลับมาใช้) ครอบคลุมแยกต่างหากด้วยการทดสอบหน่วยใน src/mcp/channel-server.test.ts

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

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

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

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

นี่คือพาธ openclaw mcp list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload และ unset

คำสั่งเหล่านี้ไม่ได้เปิดเผย OpenClaw ผ่าน MCP แต่จะจัดการข้อกำหนดเซิร์ฟเวอร์ MCP ที่ OpenClaw จัดการภายใต้ mcp.servers ในการกำหนดค่า OpenClaw โดยจะไม่อ่านเซิร์ฟเวอร์ mcporter จาก config/mcporter.json

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

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

Codex app-server ยังรองรับบล็อก codex ซึ่งเป็นตัวเลือกในแต่ละเซิร์ฟเวอร์ด้วย นี่คือ ข้อมูลเมตาการฉายภาพของ OpenClaw สำหรับเธรด Codex app-server เท่านั้น โดยจะไม่ เปลี่ยนเซสชัน ACP การกำหนดค่าฮาร์เนส Codex ทั่วไป หรืออะแดปเตอร์รันไทม์อื่น ใช้ codex.agents ที่ไม่ว่างเพื่อฉายเซิร์ฟเวอร์ไปยังเฉพาะ ID เอเจนต์ OpenClaw ที่ระบุเท่านั้น รายการเอเจนต์ที่ว่างเปล่า มีแต่ช่องว่าง หรือไม่ถูกต้องจะถูกปฏิเสธโดยการตรวจสอบความถูกต้องของการกำหนดค่า และถูกละเว้นโดยพาธการฉายภาพของรันไทม์ แทนที่จะกลายเป็น แบบส่วนกลาง ใช้ codex.defaultToolsApprovalMode (auto, prompt หรือ approve) เพื่อส่งออก default_tools_approval_mode แบบเนทีฟของ Codex สำหรับเซิร์ฟเวอร์ที่เชื่อถือได้ OpenClaw จะตัดข้อมูลเมตา codex ออกก่อนส่งต่อการกำหนดค่า mcp_servers แบบเนทีฟให้ Codex

ข้อกำหนดเซิร์ฟเวอร์ 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 รับแฟล็ก stdio เช่น --command, --arg, --env และ --cwd หรือแฟล็ก HTTP เช่น --url, --transport, --header, --auth oauth รวมถึงแฟล็ก TLS การหมดเวลา และการเลือกเครื่องมือ
• set คาดหวังค่าออบเจ็กต์ JSON หนึ่งรายการบนบรรทัดคำสั่ง
• configure อัปเดตสถานะการเปิดใช้งาน ตัวกรองเครื่องมือ การหมดเวลา OAuth, TLS และคำแนะนำการเรียกเครื่องมือแบบขนาน โดยไม่แทนที่ข้อกำหนดเซิร์ฟเวอร์ทั้งหมด เพิ่ม --probe เพื่อตรวจสอบเซิร์ฟเวอร์ที่อัปเดตก่อนบันทึก
• tools อัปเดตตัวกรองเครื่องมือรายเซิร์ฟเวอร์ รายการรวม/ไม่รวมคือชื่อเครื่องมือ MCP และ glob แบบง่าย *
• login ดำเนินขั้นตอน OAuth สำหรับเซิร์ฟเวอร์ HTTP ที่กำหนดค่าด้วย auth: "oauth" การเรียกใช้ครั้งแรกจะแสดง URL สำหรับการอนุญาต เรียกใช้อีกครั้งด้วย --code หลังการอนุมัติ
• logout ล้างข้อมูลประจำตัว OAuth ที่จัดเก็บไว้สำหรับเซิร์ฟเวอร์ที่ระบุ โดยไม่ลบข้อกำหนดเซิร์ฟเวอร์ที่บันทึกไว้
• reload กำจัดรันไทม์ MCP ในโพรเซสที่แคชไว้สำหรับโพรเซส CLI ปัจจุบันเท่านั้น โพรเซส Gateway หรือเอเจนต์ในโพรเซสอื่นยังคงต้องใช้พาธการโหลดใหม่หรือเริ่มใหม่ของตนเอง
• ใช้ transport: "streamable-http" สำหรับเซิร์ฟเวอร์ Streamable HTTP MCP นอกจากนี้ openclaw mcp set ยังปรับ type: "http" แบบเนทีฟของ CLI ให้เป็นรูปแบบการกำหนดค่ามาตรฐานเดียวกันเพื่อความเข้ากันได้
• unset จะล้มเหลวหากไม่มีเซิร์ฟเวอร์ที่ระบุ

ตัวอย่าง:

openclaw mcp listopenclaw mcp show context7 --jsonopenclaw mcp status --verboseopenclaw mcp doctor --probeopenclaw mcp probe context7 --jsonopenclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memoryopenclaw 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 docsopenclaw mcp logout docsopenclaw mcp unset context7

สูตรการกำหนดค่าเซิร์ฟเวอร์ที่ใช้บ่อย

ตัวอย่างเหล่านี้บันทึกเฉพาะข้อกำหนดของเซิร์ฟเวอร์เท่านั้น เรียกใช้ openclaw mcp doctor --probe หลังจากนั้นเพื่อยืนยันว่าเซิร์ฟเวอร์เริ่มทำงานและเปิดให้ใช้เครื่องมือได้

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-memoryopenclaw 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.exampleopenclaw 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

ใช้ --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

เรียกใช้กระบวนการลูกภายในเครื่องและสื่อสารผ่าน stdin/stdout

การรับส่งข้อมูลผ่าน SSE / HTTP

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

ตัวอย่าง:

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

ค่าที่ละเอียดอ่อนใน url (ข้อมูลผู้ใช้) และ headers จะถูกปกปิดในบันทึกและเอาต์พุตสถานะ openclaw mcp doctor จะแจ้งเตือนเมื่อรายการ headers หรือ env ที่ดูเหมือนมีข้อมูลละเอียดอ่อนมีค่าตรงตัว เพื่อให้ผู้ดูแลระบบย้ายค่าเหล่านั้นออกจากการกำหนดค่าที่คอมมิตไว้ได้

ขั้นตอนการทำงานของ OAuth

OAuth มีไว้สำหรับเซิร์ฟเวอร์ MCP แบบ HTTP ที่ประกาศขั้นตอนการทำงาน OAuth ของ MCP ระบบจะละเว้นส่วนหัว Authorization แบบคงที่สำหรับเซิร์ฟเวอร์ขณะที่เปิดใช้ auth: "oauth" ข้อมูลประจำตัวที่บันทึกโดย openclaw mcp login ใช้งานร่วมกับ MCP แบบฝัง ตัวเรียกใช้ CLI และ app-server ของ Codex ภายในเครื่องได้

เซสชัน OAuth แบบเนทีฟของ MCP อยู่ในฐานข้อมูล SQLite ที่ใช้ร่วมกันและเข้าถึงได้เฉพาะเจ้าของที่ <state-dir>/state/openclaw.sqlite (mcp_oauth_stores) แถวข้อมูลอาจประกอบด้วยโทเค็นการเข้าถึงและโทเค็นรีเฟรช ข้อมูลลับสำหรับการลงทะเบียนไคลเอนต์แบบไดนามิก เมทาดาทาการค้นหา และตัวตรวจสอบ PKCE ชั่วคราว การรีเฟรช การเข้าสู่ระบบ และการออกจากระบบใช้ lease ของ SQLite เดียวกัน ดังนั้นกระบวนการ OpenClaw ที่ทำงานพร้อมกันจึงไม่สามารถใช้โทเค็นรีเฟรชเดียวกันหรือคืนชีพเซสชันที่ออกจากระบบแล้วได้

การอัปเกรดจากที่เก็บ <state-dir>/mcp-oauth/*.json ซึ่งเลิกใช้งานแล้วจะดำเนินการโดย openclaw doctor --fix เท่านั้น โค้ดรันไทม์จะไม่อ่าน เขียน หรือย้อนกลับไปใช้ไฟล์เหล่านั้น

จนกว่าข้อมูลประจำตัวจะพร้อมใช้งาน OpenClaw จะละเว้นเฉพาะเซิร์ฟเวอร์ MCP นั้นจากรันไทม์ของเอเจนต์ แทนที่จะทำให้รอบการทำงานของเอเจนต์ล้มเหลว จากนั้นผู้ดูแลระบบหรือเอเจนต์ที่เข้าถึงเชลล์ได้สามารถเรียกใช้ openclaw mcp login <name> และใช้เซิร์ฟเวอร์ในรอบถัดไป

หากเซิร์ฟเวอร์ปฏิเสธโทเค็นด้วย insufficient_scope OpenClaw จะคงขอบเขตที่ร้องขอไว้และขอ openclaw mcp login <name> แทนการรีเฟรชซ้ำซึ่งไม่สามารถให้ขอบเขตใหม่ได้ การเข้าสู่ระบบดังกล่าวจะเริ่มคำขออนุญาตใหม่ โดยเก็บโทเค็นเดิมไว้จนกว่าจะบันทึกข้อมูลประจำตัวชุดใหม่

เมื่อบริการ MCP ระยะไกลมีโปรไฟล์การยืนยันตัวตนแบบแยกต่างหากของ OpenClaw ซึ่งรองรับการรีเฟรชอยู่แล้ว สามารถตั้งค่า oauth.authProfileId ได้ตามต้องการ OpenClaw จะรีเฟรชแหล่งข้อมูลประจำตัวแหล่งใดแหล่งหนึ่งก่อนฉายข้อมูลเข้าสู่รันไทม์ และส่งเฉพาะโทเค็นการเข้าถึงปัจจุบันไปยังไคลเอนต์ MCP ปลายทาง

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 --verboseopenclaw mcp doctor docs --probe

openclaw mcp logout docs

หากผู้ให้บริการหมุนเวียนโทเค็นหรือสถานะการอนุญาตค้าง ให้เรียกใช้ openclaw mcp logout <name> แล้วทำ login ซ้ำ logout สามารถล้างข้อมูลประจำตัวสำหรับเซิร์ฟเวอร์ HTTP ที่บันทึกไว้ได้ แม้ว่า auth: "oauth" จะถูกลบออกจากการกำหนดค่าแล้ว ตราบใดที่ชื่อและ URL ของเซิร์ฟเวอร์ยังคงระบุรายการในที่เก็บข้อมูลประจำตัวได้

การขนส่ง HTTP แบบสตรีมได้

streamable-http เป็นตัวเลือกการขนส่งเพิ่มเติมนอกเหนือจาก sse และ stdio โดยใช้การสตรีม HTTP สำหรับการสื่อสารแบบสองทิศทางกับเซิร์ฟเวอร์ MCP ระยะไกล

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

ตัวอย่าง:

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

Control UI

Control UI บนเบราว์เซอร์มีหน้าการตั้งค่า MCP โดยเฉพาะที่ /settings/mcp; พาธเดิม /mcp ยังคงเป็นนามแฝง หน้านี้แสดงจำนวนเซิร์ฟเวอร์ที่กำหนดค่าไว้ สรุปเซิร์ฟเวอร์ที่เปิดใช้งาน/OAuth/ตัวกรอง แถวการขนส่งของแต่ละเซิร์ฟเวอร์ ตัวควบคุมเปิด/ปิดใช้งาน คำสั่ง CLI ที่ใช้บ่อย และตัวแก้ไขแบบจำกัดขอบเขตสำหรับส่วนการกำหนดค่า mcp

ใช้หน้านี้สำหรับการแก้ไขโดยผู้ปฏิบัติงานและตรวจสอบรายการอย่างรวดเร็ว ใช้ openclaw mcp doctor --probe หรือ openclaw mcp probe เมื่อต้องการหลักฐานการทำงานจริงของเซิร์ฟเวอร์

ขั้นตอนการทำงานของผู้ปฏิบัติงาน:

1. เปิด Control UI และเลือก MCP
2. ตรวจสอบการ์ดสรุปสำหรับเซิร์ฟเวอร์ทั้งหมด เซิร์ฟเวอร์ที่เปิดใช้งาน เซิร์ฟเวอร์ OAuth และเซิร์ฟเวอร์ที่กรอง
3. ใช้แต่ละแถวของเซิร์ฟเวอร์เพื่อดูการขนส่ง การยืนยันตัวตน ตัวกรอง ระยะหมดเวลา และคำแนะนำคำสั่ง
4. สลับการเปิดใช้งานเมื่อต้องการเก็บข้อกำหนดไว้แต่ไม่รวมไว้ในการค้นหาระหว่างรันไทม์
5. แก้ไขส่วนการกำหนดค่า mcp ที่จำกัดขอบเขตไว้ สำหรับการเปลี่ยนแปลงเชิงโครงสร้าง เช่น เซิร์ฟเวอร์ใหม่ ส่วนหัว TLS ข้อมูลเมตา OAuth หรือตัวกรองเครื่องมือ
6. เลือก Save เพื่อบันทึกเฉพาะการกำหนดค่า หรือ Save & Publish เพื่อนำไปใช้ผ่านพาธการกำหนดค่า Gateway
7. เรียกใช้ openclaw mcp doctor --probe เมื่อต้องการหลักฐานการทำงานจริงว่าเซิร์ฟเวอร์ที่แก้ไขสามารถเริ่มทำงานและแสดงรายการเครื่องมือได้

หมายเหตุ:

• ส่วนย่อยคำสั่งจะใส่เครื่องหมายคำพูดครอบชื่อเซิร์ฟเวอร์ เพื่อให้ชื่อที่ไม่ปกติยังคงคัดลอกไปใช้ในเชลล์ได้
• ค่าที่มีลักษณะเป็น URL ซึ่งแสดงอยู่จะถูกปกปิดก่อนเรนเดอร์ เมื่อมีข้อมูลประจำตัวฝังอยู่
• หน้านี้จะไม่เริ่มการขนส่ง MCP ด้วยตัวเอง
• รันไทม์ที่ทำงานอยู่อาจต้องใช้ openclaw mcp reload การเผยแพร่การกำหนดค่า Gateway หรือการรีสตาร์ตโปรเซส ทั้งนี้ขึ้นอยู่กับว่าโปรเซสใดเป็นเจ้าของไคลเอนต์ MCP

แอป MCP

OpenClaw สามารถเรนเดอร์เครื่องมือที่ใช้งานส่วนขยาย MCP Apps ที่เสถียรได้ ต้องเลือกเปิดใช้แอป เนื่องจาก HTML ของแอปมาจากเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้ และสามารถขอเครื่องมือหรือทรัพยากรที่แอปมองเห็นได้จากเซิร์ฟเวอร์เดียวกัน

เปิดใช้งานบริดจ์โฮสต์:

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

รีสตาร์ต Gateway หลังจากเปลี่ยนการตั้งค่านี้ เมื่อเปิดใช้งาน OpenClaw จะเริ่ม Listener HTTP(S) สำหรับแซนด์บ็อกซ์เท่านั้นบนพอร์ต Gateway บวกหนึ่ง (สำหรับ Gateway เริ่มต้นคือ 18790) Control UI จะโหลดแอปจากต้นทางแยกนี้ Listener จะไม่ให้บริการ Control UI เส้นทาง Gateway ที่ผ่านการยืนยันตัวตน หรือข้อมูลผู้ใช้

การเชื่อมต่อ Gateway โดยตรงจำเป็นต้องเข้าถึงทั้งสองพอร์ต หากพร็อกซีย้อนกลับหรือตัวยุติ TLS เปิดเผย Control UI ให้กำหนดต้นทางสาธารณะเฉพาะสำหรับแอป และพร็อกซีเฉพาะต้นทางนั้นไปยัง Listener แซนด์บ็อกซ์:

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

ต้นทางแซนด์บ็อกซ์ต้องแตกต่างจากต้นทาง Control UI ห้ามโฮสต์เนื้อหาอื่นที่ผ่านการยืนยันตัวตนหรือมีความละเอียดอ่อนบนต้นทางนี้

ตัวอย่างเช่น สามารถกำหนดค่าเดโม React พื้นฐานอย่างเป็นทางการได้ดังนี้:

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

ขอบเขตด้านพฤติกรรมและความปลอดภัย:

• OpenClaw ประกาศส่วนขยาย io.modelcontextprotocol/ui เฉพาะเมื่อเปิดใช้งานแอปเท่านั้น
• เรนเดอร์เฉพาะทรัพยากร ui:// ที่มีประเภท MIME ตรงกับ text/html;profile=mcp-app ทุกประการ
• ทรัพยากร UI ถูกจำกัดไว้ที่ 2 MiB วางไว้หลังพร็อกซี iframe สองชั้นบนต้นทางภายนอกเฉพาะ โหลดเข้าสู่ต้นทางแอปภายในแบบทึบ และถูกจำกัดด้วย CSP ที่ได้มาจากข้อมูลเมตาของทรัพยากร
• เครื่องมือสำหรับแอปเท่านั้น (_meta.ui.visibility: ["app"]) จะไม่อยู่ในรายการเครื่องมือของโมเดล แอปสามารถเรียกได้เฉพาะเครื่องมือที่แอปมองเห็นได้บนเซิร์ฟเวอร์เจ้าของ ซึ่งผ่านนโยบายเครื่องมือ OpenClaw ที่มีผลสำหรับการรันที่สร้างมุมมองนั้นด้วย
• สิทธิ์ของแอปที่ผูกกับต้นทาง เช่น กล้อง ไมโครโฟน และตำแหน่งทางภูมิศาสตร์ จะไม่ได้รับอนุญาตขณะที่เอกสารแอปภายในใช้ต้นทางแบบทึบเพื่อแยกแอปออกจากกัน
• HTML ของแอป อาร์กิวเมนต์เครื่องมือทั้งหมด และผลลัพธ์ดิบจะอยู่ในสัญญาเช่ามุมมองในหน่วยความจำระยะสิบนาทีที่มีขอบเขตจำกัด และจะไม่ถูกเขียนลงดิสก์หรือคัดลอกไปยังข้อมูลเมตาตัวอย่างทรานสคริปต์ ทรานสคริปต์จะจัดเก็บเฉพาะตัวอธิบายเซิร์ฟเวอร์/เครื่องมือ/ทรัพยากรที่มีขอบเขตจำกัดซึ่งเชื่อมโยงกับ ID การเรียกเครื่องมือเดิม หลังจาก Gateway รีสตาร์ต Control UI สามารถตรวจสอบตัวอธิบายนั้นกับทรานสคริปต์เซสชันที่ผ่านการยืนยันตัวตน และดึงทรัพยากร ui:// อีกครั้ง มุมมองที่สร้างขึ้นใหม่จะเป็นแบบอ่านอย่างเดียวจนกว่าการรันใหม่จะกำหนดสิทธิ์เครื่องมือปัจจุบัน
• ในการสนทนาผ่านช่องทาง มุมมองแอปล่าสุดที่สำเร็จในหนึ่งเทิร์นจะเพิ่มการดำเนินการรูปแบบ เปิดแอป หนึ่งรายการให้กับคำตอบสุดท้ายของผู้ช่วย DM ของ Telegram ใช้ปุ่ม Mini App แบบเนทีฟ ส่วน Slack และ Discord เรนเดอร์การดำเนินการแบบพกพาเดียวกันเป็นลิงก์ ช่องทางอื่นจะคงข้อความตอบกลับเดิมไว้และเพิ่มลิงก์ HTTPS ที่เข้าใจได้
• ลิงก์เปิดช่องทางจะใช้ได้เฉพาะเมื่อการเปิดเผย Gateway ผ่าน Tailscale ได้เตรียมต้นทาง HTTPS ที่เผยแพร่ไว้แล้ว gateway.tailscale.mode: "serve" เข้าถึงได้เฉพาะจาก tailnet ส่วน "funnel" เข้าถึงได้จากอินเทอร์เน็ตสาธารณะ Funnel ที่จัดการจากภายนอกและเก็บรักษาโดย gateway.tailscale.preserveFunnel จะถือว่าสามารถเข้าถึงได้จากอินเทอร์เน็ตเช่นกัน ดู Tailscale
• ทิกเก็ตเปิดใช้งานเป็นแบบทึบ สร้างขึ้นเฉพาะขณะจัดทำคำตอบสุดท้ายของช่องทาง และหมดอายุภายในเวลาไม่เกินสองนาทีหรือเมื่อสัญญาเช่ามุมมองพื้นฐานหมดอายุ แล้วแต่ว่าอย่างใดจะเกิดก่อน URL ไม่มีข้อมูลประจำตัว bearer ของ Gateway คีย์เซสชัน ข้อมูลเมตามุมมอง HTML ของแอป อินพุตเครื่องมือ หรือผลลัพธ์เครื่องมือ
• หากไม่มีต้นทางที่เผยแพร่หรือไม่มีความจุทิกเก็ต มุมมองหรือทิกเก็ตหมดอายุ หรือการขนส่งไม่สามารถเรนเดอร์ตัวควบคุมแบบเนทีฟได้ ข้อความเดิมของผู้ช่วยจะยังคงพร้อมใช้งาน Control UI จะคงแคนวาสแอปแบบอินไลน์ที่มีอยู่และจะไม่ได้รับการดำเนินการเปิดซ้ำ
• openclaw security audit จะแสดงคำเตือนขณะที่บริดจ์เปิดใช้งานอยู่ ปิดใช้งานด้วย openclaw config set mcp.apps.enabled false --strict-json เมื่อไม่จำเป็นต้องใช้

ขีดจำกัดปัจจุบัน

หน้านี้อธิบายบริดจ์ตามที่เผยแพร่ในปัจจุบัน

ขีดจำกัดปัจจุบัน:

• การค้นหาการสนทนาขึ้นอยู่กับข้อมูลเมตาเส้นทางเซสชัน Gateway ที่มีอยู่
• ยังไม่มีโปรโตคอลพุชทั่วไปนอกเหนือจากอะแดปเตอร์เฉพาะ Claude
• ยังไม่มีเครื่องมือแก้ไขข้อความหรือแสดงปฏิกิริยา
• การขนส่ง HTTP/SSE/streamable-http เชื่อมต่อกับเซิร์ฟเวอร์ระยะไกลเพียงเครื่องเดียว ยังไม่รองรับอัปสตรีมแบบมัลติเพล็กซ์
• permissions_list_open รวมเฉพาะการอนุมัติที่ตรวจพบขณะที่บริดจ์เชื่อมต่ออยู่

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

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