ชุดรวม Plugin

OpenClaw สามารถติดตั้ง Plugin จากระบบนิเวศภายนอกได้สามแบบ: Codex, Claude, และ Cursor สิ่งเหล่านี้เรียกว่า บันเดิล ซึ่งเป็นแพ็กเนื้อหาและเมตาดาต้าที่ OpenClaw แมปเข้ากับฟีเจอร์เนทีฟ เช่น Skills, ฮุก และเครื่องมือ MCP

เหตุผลที่มีบันเดิล

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

ติดตั้งบันเดิล

# Local directoryopenclaw plugins install ./my-bundle # Archiveopenclaw plugins install ./my-bundle.tgz # Claude marketplaceopenclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

สิ่งที่ OpenClaw แมปจากบันเดิล

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

รองรับแล้วตอนนี้

เนื้อหา Skills

• ราก Skills ของบันเดิลโหลดเป็นราก Skills ปกติของ OpenClaw
• ราก commands ของ Claude ถูกจัดการเป็นราก Skills เพิ่มเติม
• ราก .cursor/commands ของ Cursor ถูกจัดการเป็นราก Skills เพิ่มเติม

ซึ่งหมายความว่าไฟล์คำสั่ง markdown ของ Claude ทำงานผ่านตัวโหลด Skills ปกติของ OpenClaw ส่วน markdown คำสั่งของ Cursor ทำงานผ่านเส้นทางเดียวกัน

แพ็กฮุก

• รากฮุกของบันเดิลทำงาน เฉพาะ เมื่อใช้เลย์เอาต์แพ็กฮุก OpenClaw ปกติ ปัจจุบันกรณีนี้คือกรณีที่เข้ากันได้กับ Codex เป็นหลัก:
  • HOOK.md
  • handler.ts หรือ handler.js

MCP สำหรับ OpenClaw แบบฝังตัว

• บันเดิลที่เปิดใช้งานสามารถเพิ่มคอนฟิกเซิร์ฟเวอร์ MCP ได้
• OpenClaw ผสานคอนฟิก MCP ของบันเดิลเข้าในการตั้งค่า OpenClaw แบบฝังตัวที่มีผลใช้งานเป็น mcpServers
• OpenClaw เปิดให้ใช้เครื่องมือ MCP ของบันเดิลที่รองรับระหว่างเทิร์นของเอเจนต์ OpenClaw แบบฝังตัว โดย เปิดเซิร์ฟเวอร์ stdio หรือเชื่อมต่อกับเซิร์ฟเวอร์ HTTP
• โปรไฟล์เครื่องมือ coding และ messaging รวมเครื่องมือ MCP ของบันเดิลไว้ ตามค่าเริ่มต้น; ใช้ tools.deny: ["bundle-mcp"] เพื่อไม่ใช้สำหรับเอเจนต์หรือ Gateway
• การตั้งค่าเอเจนต์แบบฝังตัวเฉพาะโปรเจกต์ยังคงมีผลหลังค่าเริ่มต้นของบันเดิล ดังนั้นการตั้งค่าพื้นที่ทำงาน สามารถแทนที่รายการ MCP ของบันเดิลได้เมื่อจำเป็น
• แคตตาล็อกเครื่องมือ MCP ของบันเดิลถูกเรียงอย่างกำหนดแน่นอนก่อนลงทะเบียน ดังนั้น การเปลี่ยนลำดับ listTools() จากต้นทางจะไม่ทำให้บล็อกเครื่องมือในพรอมป์แคชสั่นไหว

ทรานสปอร์ต

เซิร์ฟเวอร์ MCP สามารถใช้ทรานสปอร์ต stdio หรือ HTTP:

Stdio เปิดโปรเซสลูก:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP เชื่อมต่อกับเซิร์ฟเวอร์ MCP ที่กำลังทำงานผ่าน sse ตามค่าเริ่มต้น หรือ streamable-http เมื่อร้องขอ:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• transport อาจตั้งเป็น "streamable-http" หรือ "sse"; เมื่อไม่ได้ระบุ OpenClaw จะใช้ sse
• type: "http" เป็นรูปทรง downstream แบบเนทีฟของ CLI; ใช้ transport: "streamable-http" ในคอนฟิก OpenClaw openclaw mcp set และ openclaw doctor --fix จะทำให้ alias ทั่วไปเป็นรูปแบบมาตรฐาน
• อนุญาตเฉพาะ URL scheme http: และ https:
• ค่า headers รองรับการแทรกค่า ${ENV_VAR}
• รายการเซิร์ฟเวอร์ที่มีทั้ง command และ url จะถูกปฏิเสธ
• ข้อมูลรับรองใน URL (userinfo และ query params) จะถูกปกปิดจากคำอธิบายเครื่องมือ และล็อก
• connectionTimeoutMs จะแทนที่ค่า timeout การเชื่อมต่อเริ่มต้น 30 วินาทีสำหรับ ทรานสปอร์ตทั้ง stdio และ HTTP

การตั้งชื่อเครื่องมือ

OpenClaw ลงทะเบียนเครื่องมือ MCP ของบันเดิลด้วยชื่อที่ปลอดภัยสำหรับ provider ในรูปแบบ serverName__toolName ตัวอย่างเช่น เซิร์ฟเวอร์ที่ใช้คีย์ "vigil-harbor" และเปิดเผยเครื่องมือ memory_search จะลงทะเบียนเป็น vigil-harbor__memory_search

• อักขระนอกเหนือจาก A-Za-z0-9_- จะถูกแทนที่ด้วย -
• ชิ้นส่วนที่อาจขึ้นต้นด้วยอักขระที่ไม่ใช่ตัวอักษรจะได้รับคำนำหน้าเป็นตัวอักษร ดังนั้นคีย์เซิร์ฟเวอร์แบบตัวเลข เช่น 12306 จะกลายเป็นคำนำหน้าเครื่องมือที่ปลอดภัยสำหรับ provider
• คำนำหน้าเซิร์ฟเวอร์จำกัดไว้ที่ 30 อักขระ
• ชื่อเครื่องมือเต็มจำกัดไว้ที่ 64 อักขระ
• ชื่อเซิร์ฟเวอร์ว่างจะใช้ mcp แทน
• ชื่อที่ผ่านการ sanitize แล้วชนกันจะถูกแยกด้วย suffix ตัวเลข
• ลำดับเครื่องมือสุดท้ายที่เปิดเผยถูกกำหนดแน่นอนตามชื่อที่ปลอดภัย เพื่อให้เทิร์นเอเจนต์แบบฝังตัวซ้ำๆ มีแคชที่เสถียร
• การกรองโปรไฟล์ถือว่าเครื่องมือทั้งหมดจากเซิร์ฟเวอร์ MCP ของบันเดิลเดียวเป็นของ Plugin โดย bundle-mcp ดังนั้น allowlist และ deny list ของโปรไฟล์สามารถรวมได้ทั้ง ชื่อเครื่องมือที่เปิดเผยรายตัว หรือคีย์ Plugin bundle-mcp

การตั้งค่า OpenClaw แบบฝังตัว

• settings.json ของ Claude ถูกนำเข้าเป็นการตั้งค่าเริ่มต้นของ OpenClaw แบบฝังตัวเมื่อ เปิดใช้งานบันเดิล
• OpenClaw sanitize คีย์ shell override ก่อนนำไปใช้

คีย์ที่ sanitize แล้ว:

• shellPath
• shellCommandPrefix

LSP ของ OpenClaw แบบฝังตัว

• บันเดิล Claude ที่เปิดใช้งานสามารถเพิ่มคอนฟิกเซิร์ฟเวอร์ LSP ได้
• OpenClaw โหลด .lsp.json พร้อมพาธ lspServers ที่ประกาศใน manifest
• คอนฟิก LSP ของบันเดิลถูกผสานเข้าในค่าเริ่มต้น LSP ของ OpenClaw แบบฝังตัวที่มีผลใช้งาน
• ปัจจุบันเฉพาะเซิร์ฟเวอร์ LSP ที่รองรับและใช้ stdio เท่านั้นที่เรียกใช้งานได้; ทรานสปอร์ตที่ไม่รองรับ ยังแสดงใน openclaw plugins inspect <id>

ตรวจพบแต่ไม่เรียกใช้งาน

สิ่งเหล่านี้ถูกจดจำและแสดงในการวินิจฉัย แต่ OpenClaw ไม่เรียกใช้งาน:

• Claude agents, automation hooks.json, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• เมตาดาต้า inline/app ของ Codex นอกเหนือจากการรายงานความสามารถ

รูปแบบบันเดิล

ลำดับความสำคัญในการตรวจจับ

OpenClaw ตรวจหารูปแบบ Plugin แบบเนทีฟก่อน:

1. openclaw.plugin.json หรือ package.json ที่ถูกต้องพร้อม openclaw.extensions — ถูกจัดการเป็น Plugin แบบเนทีฟ
2. ตัวบ่งชี้บันเดิล (.codex-plugin/, .claude-plugin/ หรือเลย์เอาต์ Claude/Cursor เริ่มต้น) — ถูกจัดการเป็น บันเดิล

หากไดเรกทอรีมีทั้งสองแบบ OpenClaw จะใช้เส้นทางเนทีฟ วิธีนี้ป้องกันไม่ให้ แพ็กเกจแบบสองรูปแบบถูกติดตั้งบางส่วนเป็นบันเดิล

การพึ่งพารันไทม์และการล้างข้อมูล

• บันเดิลจากภายนอกที่เข้ากันได้จะไม่ได้รับการซ่อมแซม npm install ตอนเริ่มต้นระบบ บันเดิลเหล่านี้ ควรถูกติดตั้งผ่าน openclaw plugins install และจัดส่งทุกอย่าง ที่ต้องใช้ไว้ในไดเรกทอรี Plugin ที่ติดตั้งแล้ว
• Plugin แบบบันเดิลที่ OpenClaw เป็นเจ้าของจะถูกจัดส่งแบบเบาใน core หรือ ดาวน์โหลดได้ผ่านตัวติดตั้ง Plugin การเริ่มต้น Gateway จะไม่เรียกใช้ package manager สำหรับสิ่งเหล่านี้
• openclaw doctor --fix จะลบไดเรกทอรี dependency แบบ staged เดิม และสามารถ กู้คืน Plugin ที่ดาวน์โหลดได้ซึ่งหายไปจากดัชนี Plugin ในเครื่องเมื่อ คอนฟิกอ้างอิงถึงสิ่งเหล่านั้น

ความปลอดภัย

บันเดิลมีขอบเขตความเชื่อถือที่แคบกว่า Plugin แบบเนทีฟ:

• OpenClaw ไม่ โหลดโมดูลรันไทม์ของบันเดิลตามอำเภอใจในโปรเซสเดียวกัน
• พาธ Skills และแพ็กฮุกต้องอยู่ภายในราก Plugin (ตรวจสอบขอบเขตแล้ว)
• ไฟล์การตั้งค่าถูกอ่านด้วยการตรวจสอบขอบเขตแบบเดียวกัน
• เซิร์ฟเวอร์ MCP แบบ stdio ที่รองรับอาจถูกเปิดเป็น subprocess

สิ่งนี้ทำให้บันเดิลปลอดภัยกว่าโดยค่าเริ่มต้น แต่คุณยังควรถือว่าบันเดิลจากภายนอก เป็นเนื้อหาที่เชื่อถือได้สำหรับฟีเจอร์ที่เปิดเผยอยู่ดี

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

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

• ติดตั้งและกำหนดค่า Plugin
• การสร้าง Plugin — สร้าง Plugin แบบเนทีฟ
• Manifest ของ Plugin — schema manifest แบบเนทีฟ