บันเดิล Plugin

Documentation Index

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

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

​

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

​

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

# Local directory
openclaw plugins install ./my-bundle

# Archive
openclaw plugins install ./my-bundle.tgz

# Claude marketplace
openclaw plugins marketplace list <marketplace-name>
openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

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

​

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

​

เนื้อหา Skills

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

​

แพ็ก hook

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

​

MCP สำหรับ Pi

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

การขนส่ง

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

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

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

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

​

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

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

• shellPath
• shellCommandPrefix

​

LSP ของ Pi แบบฝัง

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

​

ตรวจพบแต่ไม่ได้ดำเนินการ

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

​

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

​

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

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

​

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

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

​

ความปลอดภัย

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

​

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

​

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

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