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 รองรับ
• มี Gateway ของ OpenClaw แบบภายในเครื่องหรือระยะไกลที่มีเซสชันซึ่งกำหนดเส้นทางไว้แล้ว
• ต้องการเซิร์ฟเวอร์ MCP หนึ่งตัวที่ใช้งานได้กับแบ็กเอนด์ช่องทางต่างๆ ของ OpenClaw แทนการเรียกใช้บริดจ์แยกสำหรับแต่ละช่องทาง

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

วิธีการทำงาน

openclaw mcp serve เริ่มเซิร์ฟเวอร์ MCP แบบ stdio โดยไคลเอนต์ MCP เป็นเจ้าของกระบวนการนั้น ตราบใดที่ไคลเอนต์ยังคงเปิดเซสชัน stdio ไว้ บริดจ์จะเชื่อมต่อกับ Gateway ของ OpenClaw แบบภายในเครื่องหรือระยะไกลผ่าน 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 ตัวกรอง และการเรียกแบบขนานที่ผ่านการแก้ค่าแล้ว
• 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,observe,click,type'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,        "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",        "timeout": 20,        "connectTimeout": 5,        "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",        "timeout": 20,        "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 และเซิร์ฟเวอร์แอป Codex ภายในเครื่อง

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

เมื่อบริการ MCP ระยะไกลมีโปรไฟล์การยืนยันตัวตน OpenClaw แยกต่างหากที่รองรับการรีเฟรชอยู่แล้ว คุณสามารถตั้งค่า oauth.authProfileId เพิ่มเติมได้ OpenClaw จะรีเฟรชแหล่งข้อมูลรับรองแหล่งใดแหล่งหนึ่งก่อนฉายเข้าสู่รันไทม์ และส่งเฉพาะ access token ปัจจุบันไปยังไคลเอนต์ 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",        "connectTimeout": 10,        "timeout": 30,        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

UI ควบคุม

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

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

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

1. เปิด 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) UI ควบคุมจะโหลดแอปจากต้นทางที่แยกต่างหากนี้ Listener จะไม่ให้บริการ UI ควบคุม เส้นทาง Gateway ที่ผ่านการยืนยันตัวตน หรือข้อมูลผู้ใช้

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

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

ต้นทางแซนด์บ็อกซ์ต้องแตกต่างจากต้นทางของ 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 เริ่มใหม่ UI ควบคุมสามารถตรวจสอบตัวอธิบายนั้นกับทรานสคริปต์เซสชันที่ผ่านการยืนยันตัวตนและดึงทรัพยากร ui:// อีกครั้ง มุมมองที่สร้างขึ้นใหม่จะเป็นแบบอ่านอย่างเดียวจนกว่าการรันใหม่จะกำหนดสิทธิ์เครื่องมือปัจจุบัน
• openclaw security audit จะแสดงคำเตือนขณะที่บริดจ์เปิดใช้งานอยู่ ปิดใช้งานด้วย openclaw config set mcp.apps.enabled false --strict-json เมื่อไม่จำเป็นต้องใช้

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

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

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

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

เนื้อหาที่เกี่ยวข้อง

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