Plugin

จัดการ Plugin ของ Gateway, ชุดฮุก และบันเดิลที่เข้ากันได้

คำสั่ง

openclaw plugins list [--enabled] [--verbose] [--json]openclaw plugins search <query> [--limit <n>] [--json]openclaw plugins install <path-or-spec> [--link] [--force] [--pin] [--marketplace <source>]openclaw plugins inspect <id> [--runtime] [--json]openclaw plugins inspect --all [--runtime] [--json]openclaw plugins info <id>                    # alias for inspectopenclaw plugins enable <id>openclaw plugins disable <id>openclaw plugins uninstall <id> [--dry-run] [--keep-files] [--force]openclaw plugins update <id-or-npm-spec> | --all [--dry-run]openclaw plugins registry [--refresh] [--json]openclaw plugins doctoropenclaw plugins init <id> [--name <name>] [--type tool|provider] [--directory <path>]openclaw plugins build [--entry <path>] [--check]openclaw plugins validate [--entry <path>]openclaw plugins marketplace entries [--offline] [--feed-profile <name>] [--json]openclaw plugins marketplace list <source> [--json]openclaw plugins marketplace refresh [--feed-profile <name>] [--expected-sha256 <sha256>] [--json]

เมื่อตรวจสอบการติดตั้ง การตรวจรายละเอียด การถอนการติดตั้ง หรือการรีเฟรชรีจิสทรีที่ทำงานช้า ให้เรียกใช้คำสั่งโดยกำหนด OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1 การติดตามจะเขียนระยะเวลาของแต่ละช่วงไปยัง stderr และยังคงทำให้เอาต์พุต JSON สามารถแยกวิเคราะห์ได้ ดูการแก้ไขข้อบกพร่อง

การสร้าง

openclaw plugins init stock-quotes --name "Stock Quotes"cd stock-quotesnpm run plugin:buildnpm run plugin:validate

โดยค่าเริ่มต้น plugins init จะสร้าง Plugin เครื่องมือ TypeScript ขั้นต่ำ อาร์กิวเมนต์แรกคือรหัส Plugin ส่วน --name กำหนดชื่อที่ใช้แสดง OpenClaw ใช้รหัสนี้เป็นชื่อไดเรกทอรีเอาต์พุตเริ่มต้นและการตั้งชื่อแพ็กเกจ โครงเริ่มต้นของเครื่องมือใช้ defineToolPlugin และสร้างสคริปต์ plugin:build กับ plugin:validate ใน package.json ซึ่งจะสร้างแล้วเรียก openclaw plugins build/validate

plugins build จะนำเข้าจุดเริ่มต้นที่สร้างแล้ว อ่านข้อมูลเมตาของเครื่องมือแบบคงที่ เขียน openclaw.plugin.json และทำให้ openclaw.extensions ใน package.json สอดคล้องกันอยู่เสมอ plugins validate ตรวจสอบว่าไฟล์กำกับที่สร้างขึ้น ข้อมูลเมตาของแพ็กเกจ และการส่งออกจากจุดเริ่มต้นปัจจุบันยังคงตรงกัน ดูขั้นตอนการสร้างทั้งหมดได้ที่ Plugin เครื่องมือ

โครงเริ่มต้นจะเขียนซอร์ส TypeScript แต่สร้างข้อมูลเมตาจากจุดเริ่มต้น ./dist/index.js ที่สร้างแล้ว ดังนั้นขั้นตอนนี้จึงทำงานร่วมกับ CLI ที่เผยแพร่แล้วได้ด้วย ใช้ --entry <path> เมื่อจุดเริ่มต้นไม่ใช่จุดเริ่มต้นเริ่มต้นของแพ็กเกจ ใช้ plugins build --check ใน CI เพื่อให้ล้มเหลวเมื่อข้อมูลเมตาที่สร้างไว้ล้าสมัย โดยไม่เขียนไฟล์ใหม่

โครงเริ่มต้นของผู้ให้บริการ

openclaw plugins init acme-models --name "Acme Models" --type providercd acme-modelsnpm installnpm run buildnpm testnpm run validate

โครงเริ่มต้นของผู้ให้บริการจะสร้าง Plugin ผู้ให้บริการโมเดลทั่วไปที่เข้ากันได้กับ OpenAI พร้อมระบบเชื่อมต่อการยืนยันตัวตนด้วยคีย์ API, สคริปต์ npm run validate ที่เรียกใช้ clawhub package validate, ข้อมูลเมตาแพ็กเกจ ClawHub และเวิร์กโฟลว์ GitHub Actions ที่เรียกใช้ด้วยตนเองสำหรับการเผยแพร่แบบเชื่อถือได้ผ่าน GitHub OIDC ในอนาคต โครงเริ่มต้นของผู้ให้บริการจะไม่สร้าง Skills และไม่ใช้ openclaw plugins build/validate คำสั่งเหล่านี้มีไว้สำหรับเส้นทางข้อมูลเมตาที่สร้างขึ้นของโครงเริ่มต้นเครื่องมือ

ก่อนเผยแพร่ ให้แทนที่ URL ฐานของ API แค็ตตาล็อกโมเดล เส้นทางเอกสาร ข้อความเกี่ยวกับข้อมูลรับรอง และเนื้อหา README ที่เป็นตัวแทนด้วยรายละเอียดจริงของผู้ให้บริการ ใช้ README ที่สร้างขึ้นสำหรับการเผยแพร่ไปยัง ClawHub ครั้งแรกและการตั้งค่าผู้เผยแพร่ที่เชื่อถือได้

การติดตั้ง

openclaw plugins search "calendar"                      # search ClawHub pluginsopenclaw plugins install <package>                       # source auto-detectionopenclaw plugins install clawhub:<package>                # ClawHub onlyopenclaw plugins install npm:<package>                    # npm onlyopenclaw plugins install npm-pack:<path.tgz>               # local npm-pack tarballopenclaw plugins install git:github.com/<owner>/<repo>     # git repoopenclaw plugins install git:github.com/<owner>/<repo>@<ref>openclaw plugins install <path>                            # local path or archiveopenclaw plugins install -l <path>                         # link instead of copyopenclaw plugins install <plugin>@<marketplace>             # marketplace shorthandopenclaw plugins install <plugin> --marketplace <name>      # marketplace (explicit)openclaw plugins install <package> --force                  # overwrite existing installopenclaw plugins install <package> --pin                    # pin resolved npm versionopenclaw plugins install clawhub:<package> --acknowledge-clawhub-riskopenclaw plugins install <package> --dangerously-force-unsafe-install

ผู้ดูแลที่ทดสอบการติดตั้งระหว่างการตั้งค่าสามารถแทนที่แหล่งติดตั้ง Plugin อัตโนมัติด้วยตัวแปรสภาพแวดล้อมที่มีการป้องกัน ดูการแทนที่แหล่งติดตั้ง Plugin

plugins search สอบถาม ClawHub เพื่อค้นหาแพ็กเกจ code-plugin และ bundle-plugin ที่ติดตั้งได้ (ไม่ใช่ Skills สำหรับสิ่งเหล่านั้นให้ใช้ openclaw skills search) ค่าเริ่มต้นของ --limit คือ 20 และจำกัดสูงสุดที่ 100 คำสั่งนี้อ่านเฉพาะแค็ตตาล็อกระยะไกล โดยไม่มีการตรวจสอบสถานะภายในเครื่อง การเปลี่ยนแปลงการกำหนดค่า การติดตั้งแพ็กเกจ หรือการโหลดรันไทม์ของ Plugin ผลลัพธ์ประกอบด้วยชื่อแพ็กเกจ ClawHub ตระกูล ช่องทาง เวอร์ชัน สรุป และคำแนะนำการติดตั้ง เช่น openclaw plugins install clawhub:<package>

การติดตั้งจาก ClawHub ใช้ตัวระบุตำแหน่ง clawhub:<package> อย่างชัดเจน:

openclaw plugins install clawhub:openclaw-codex-app-serveropenclaw plugins install clawhub:openclaw-codex-app-server@1.2.3

ข้อกำหนด Plugin แบบไม่มีคำนำหน้าที่ปลอดภัยสำหรับ npm จะติดตั้งจาก npm โดยค่าเริ่มต้นระหว่างช่วงเปลี่ยนผ่านการเปิดตัว เว้นแต่จะตรงกับรหัส Plugin อย่างเป็นทางการ:

openclaw plugins install openclaw-codex-app-server

ใช้ npm: เพื่อระบุการแก้ไขผ่าน npm เท่านั้นอย่างชัดเจน:

openclaw plugins install npm:openclaw-codex-app-serveropenclaw plugins install npm:@openclaw/discord@2026.5.20openclaw plugins install npm:@scope/plugin-name@1.0.1

OpenClaw จะตรวจสอบความเข้ากันได้ของ API Plugin / Gateway ขั้นต่ำที่ประกาศไว้ก่อนติดตั้ง เมื่อเวอร์ชัน ClawHub ที่เลือกเผยแพร่อาร์ติแฟกต์ ClawPack OpenClaw จะดาวน์โหลด npm-pack .tgz ที่มีเวอร์ชัน ตรวจสอบส่วนหัวไดเจสต์ของ ClawHub และไดเจสต์ของอาร์ติแฟกต์ แล้วติดตั้งผ่านเส้นทางไฟล์เก็บถาวรตามปกติ ClawHub เวอร์ชันเก่าที่ไม่มีข้อมูลเมตา ClawPack จะยังคงติดตั้งผ่านเส้นทางตรวจสอบไฟล์เก็บถาวรแพ็กเกจแบบเดิม ระเบียนการติดตั้งจะเก็บข้อมูลเมตาต้นทาง ClawHub ชนิดอาร์ติแฟกต์ ค่า integrity ของ npm ค่า shasum ของ npm ชื่อทาร์บอล และข้อเท็จจริงไดเจสต์ ClawPack ไว้สำหรับการอัปเดตภายหลัง การติดตั้ง ClawHub ที่ไม่ระบุเวอร์ชันจะเก็บข้อกำหนดที่บันทึกไว้แบบไม่ระบุเวอร์ชัน เพื่อให้ openclaw plugins update ติดตามรุ่น ClawHub ที่ใหม่กว่าได้ ส่วนตัวเลือกเวอร์ชันหรือแท็กที่ระบุอย่างชัดเจน เช่น clawhub:pkg@1.2.3 และ clawhub:pkg@beta จะยังคงตรึงอยู่กับตัวเลือกนั้น

รูปแบบย่อของ Marketplace

ใช้รูปแบบย่อ plugin@marketplace เมื่อชื่อ Marketplace มีอยู่ในแคชรีจิสทรีภายในเครื่องของ Claude ที่ ~/.claude/plugins/known_marketplaces.json:

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

ใช้ --marketplace เพื่อส่งต้นทาง Marketplace อย่างชัดเจน:

openclaw plugins install <plugin-name> --marketplace <marketplace-name>openclaw plugins install <plugin-name> --marketplace <owner/repo>openclaw plugins install <plugin-name> --marketplace https://github.com/<owner>/<repo>openclaw plugins install <plugin-name> --marketplace ./my-marketplace

สำหรับเส้นทางภายในเครื่องและไฟล์เก็บถาวร OpenClaw จะตรวจหาโดยอัตโนมัติ:

• Plugin OpenClaw แบบเนทีฟ (openclaw.plugin.json)
• บันเดิลที่เข้ากันได้กับ Codex (.codex-plugin/plugin.json)
• บันเดิลที่เข้ากันได้กับ Claude (.claude-plugin/plugin.json หรือเค้าโครงคอมโพเนนต์เริ่มต้นของ Claude เมื่อไม่มีไฟล์กำกับดังกล่าว)
• บันเดิลที่เข้ากันได้กับ Cursor (.cursor-plugin/plugin.json)

การติดตั้งภายในเครื่องที่มีการจัดการต้องเป็นไดเรกทอรี Plugin หรือไฟล์เก็บถาวร ไฟล์ Plugin แบบเดี่ยว .js, .mjs, .cjs และ .ts จะไม่ถูกคัดลอกไปยังราก Plugin ที่มีการจัดการโดย plugins install และจะไม่ถูกโหลดด้วยการวางโดยตรงใน ~/.openclaw/extensions หรือ <workspace>/.openclaw/extensions; รากที่ตรวจพบ โดยอัตโนมัติเหล่านั้นจะโหลดแพ็กเกจ Plugin หรือไดเรกทอรีบันเดิล และข้าม ไฟล์สคริปต์ระดับบนสุดในฐานะตัวช่วยภายในเครื่อง ให้ระบุไฟล์เดี่ยวอย่างชัดเจนใน plugins.load.paths แทน

ใช้ -l/--link เพื่อชี้ไปยังไดเรกทอรี Plugin ภายในเครื่องโดยไม่คัดลอก (เพิ่ม ลงใน plugins.load.paths):

openclaw plugins install -l ./my-plugin

ไม่รองรับ --link ร่วมกับ --force (Plugin ที่เชื่อมโยงจะชี้ไปยังเส้นทางต้นทาง โดยตรง จึงไม่มีสิ่งใดให้เขียนทับ ณ ตำแหน่งเดิม), --marketplace หรือ การติดตั้งแบบ git: และต้องใช้เส้นทางภายในเครื่องที่มีอยู่แล้ว

รายการ

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --json

หากบันทึกการเริ่มต้นแสดง plugins.allow is empty; discovered non-bundled plugins may auto-load: ... ให้เรียกใช้ openclaw plugins list --enabled --verbose หรือ openclaw plugins inspect <id> พร้อมรหัส Plugin ที่แสดงอยู่ เพื่อยืนยันรหัส Plugin และคัดลอกรหัสที่เชื่อถือได้ไปยัง plugins.allow ใน openclaw.json เมื่อคำเตือน สามารถแสดง Plugin ที่ตรวจพบทั้งหมดได้ ระบบจะพิมพ์ส่วนย่อย plugins.allow ที่พร้อมวางและมีรหัสเหล่านั้นอยู่แล้ว หาก Plugin โหลดโดยไม่มีข้อมูลแหล่งที่มาจากการติดตั้ง/ เส้นทางโหลด ให้ตรวจสอบรหัส Plugin นั้น แล้วตรึงรหัสที่เชื่อถือได้ใน plugins.allow หรือติดตั้ง Plugin ใหม่จากต้นทางที่เชื่อถือได้ เพื่อให้ OpenClaw บันทึกแหล่งที่มาของการติดตั้ง

สำหรับงาน Plugin แบบรวมภายในอิมเมจ Docker ที่จัดทำเป็นแพ็กเกจ ให้เมานต์แบบผูกไดเรกทอรี ต้นทางของ Plugin ทับเส้นทางต้นทางที่จัดทำเป็นแพ็กเกจซึ่งตรงกัน เช่น /app/extensions/synology-chat OpenClaw จะตรวจพบโอเวอร์เลย์ต้นทางที่เมานต์นั้น ก่อน /app/dist/extensions/synology-chat; ไดเรกทอรีต้นทางที่คัดลอกแบบธรรมดา จะยังไม่ทำงาน ดังนั้นการติดตั้งแบบจัดทำเป็นแพ็กเกจตามปกติจะยังคงใช้ dist ที่คอมไพล์แล้ว

สำหรับการดีบักฮุกขณะทำงาน:

• openclaw plugins inspect <id> --runtime --json แสดงฮุกที่ลงทะเบียนและข้อมูลวินิจฉัยจากรอบการตรวจสอบที่โหลดโมดูลแล้ว การตรวจสอบรันไทม์จะไม่ติดตั้งการขึ้นต่อกันโดยเด็ดขาด ให้ใช้ openclaw doctor --fix เพื่อล้างสถานะการขึ้นต่อกันแบบเดิม หรือกู้คืน Plugin ที่ดาวน์โหลดได้ซึ่งหายไปและถูกอ้างอิงโดยการกำหนดค่า
• openclaw gateway status --deep --require-rpc ยืนยัน URL/โปรไฟล์ของ Gateway ที่เข้าถึงได้ คำแนะนำเกี่ยวกับบริการ/กระบวนการ พาธการกำหนดค่า และสถานะของ RPC
• ฮุกการสนทนาที่ไม่ได้รวมมาในชุด (llm_input, llm_output, before_model_resolve, before_agent_reply, before_agent_run, before_agent_finalize, agent_end) ต้องกำหนด plugins.entries.<id>.hooks.allowConversationAccess=true

ดัชนี Plugin

ข้อมูลเมตาการติดตั้ง Plugin เป็นสถานะที่เครื่องจัดการ ไม่ใช่การกำหนดค่าของผู้ใช้ การติดตั้งและการอัปเดตจะเขียนข้อมูลนี้ลงในฐานข้อมูลสถานะ SQLite ที่ใช้ร่วมกัน ภายใต้ไดเรกทอรีสถานะ OpenClaw ที่ใช้งานอยู่ แถว installed_plugin_index จัดเก็บข้อมูลเมตา installRecords แบบถาวร รวมถึงระเบียนสำหรับไฟล์แมนิเฟสต์ของ Plugin ที่เสียหายหรือหายไป ตลอดจนแคชรีจิสทรีแบบเย็นที่สร้างจากแมนิเฟสต์ ซึ่งใช้โดย openclaw plugins update การถอนการติดตั้ง การวินิจฉัย และรีจิสทรี Plugin แบบเย็น

เมื่อ OpenClaw พบระเบียน plugins.installs แบบเดิมที่เคยจัดส่งในไฟล์การกำหนดค่า การอ่านขณะรันไทม์จะถือว่าระเบียนเหล่านี้เป็นอินพุตเพื่อความเข้ากันได้ โดยไม่เขียน openclaw.json ใหม่ การเขียนข้อมูล Plugin โดยชัดแจ้งและ openclaw doctor --fix จะย้ายระเบียนเหล่านั้นไปยังดัชนี Plugin และนำคีย์การกำหนดค่าออกเมื่ออนุญาตให้เขียนการกำหนดค่า หากการเขียนอย่างใดอย่างหนึ่งล้มเหลว ระบบจะเก็บระเบียนในการกำหนดค่าไว้เพื่อไม่ให้ข้อมูลเมตาการติดตั้งสูญหาย

การถอนการติดตั้ง

openclaw plugins uninstall <id>openclaw plugins uninstall <id> --dry-runopenclaw plugins uninstall <id> --keep-filesopenclaw plugins uninstall <id> --force

uninstall จะนำระเบียน Plugin ออกจาก plugins.entries ดัชนี Plugin ที่จัดเก็บถาวร รายการอนุญาต/ปฏิเสธ Plugin และรายการ plugins.load.paths ที่เชื่อมโยงอยู่เมื่อเกี่ยวข้อง หากไม่ได้ตั้งค่า --keep-files การถอนการติดตั้งจะนำไดเรกทอรีการติดตั้งที่มีการจัดการและติดตามไว้ออกด้วย แต่จะทำเช่นนั้นเฉพาะเมื่อพาธที่แก้ไขแล้วอยู่ภายในรากส่วนขยาย Plugin ของ OpenClaw เท่านั้น หากปัจจุบัน Plugin ครอบครองสล็อต memory หรือ contextEngine สล็อตนั้นจะรีเซ็ตเป็นค่าเริ่มต้น (memory-core สำหรับหน่วยความจำ และ legacy สำหรับกลไกบริบท)

uninstall จะแสดงตัวอย่างรายการที่จะถูกนำออก จากนั้นจะแจ้งถาม Uninstall plugin "<id>"? ก่อนทำการเปลี่ยนแปลง ส่ง --force เพื่อข้ามข้อความแจ้งยืนยัน (มีประโยชน์สำหรับสคริปต์และการทำงานแบบไม่โต้ตอบ) หากไม่มีแฟล็กนี้ การถอนการติดตั้งต้องใช้ TTY แบบโต้ตอบ --dry-run จะแสดงตัวอย่างเดียวกันและจบการทำงานโดยไม่แจ้งถามหรือเปลี่ยนแปลงสิ่งใด

การอัปเดต

openclaw plugins update <id-or-npm-spec>openclaw plugins update --allopenclaw plugins update <id-or-npm-spec> --dry-runopenclaw plugins update @openclaw/voice-callopenclaw plugins update openclaw-codex-app-server --acknowledge-clawhub-riskopenclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

การอัปเดตมีผลกับการติดตั้ง Plugin ที่ติดตามไว้ในดัชนี Plugin ที่มีการจัดการ และการติดตั้งชุดฮุกที่ติดตามไว้ใน hooks.internal.installs

การตรวจสอบ

openclaw plugins inspect <id>openclaw plugins inspect <id> --runtimeopenclaw plugins inspect <id> --jsonopenclaw plugins inspect --all

การตรวจสอบจะแสดงอัตลักษณ์ สถานะการโหลด แหล่งที่มา ความสามารถจากแมนิเฟสต์ แฟล็กนโยบาย ข้อมูลวินิจฉัย ข้อมูลเมตาการติดตั้ง ความสามารถของชุดรวม และการรองรับเซิร์ฟเวอร์ MCP หรือ LSP ที่ตรวจพบ โดยค่าเริ่มต้นจะไม่อิมพอร์ตรันไทม์ของ Plugin เอาต์พุต JSON มีสัญญาในแมนิเฟสต์ของ Plugin เช่น contracts.agentToolResultMiddleware และ contracts.trustedToolPolicies เพื่อให้ผู้ดูแลระบบตรวจสอบการประกาศพื้นผิวที่เชื่อถือได้ก่อนเปิดใช้งานหรือรีสตาร์ต Plugin เพิ่ม --runtime เพื่อโหลดโมดูล Plugin และรวมฮุก เครื่องมือ คำสั่ง บริการ เมธอด Gateway และเส้นทาง HTTP ที่ลงทะเบียนไว้ การตรวจสอบรันไทม์จะรายงานการขึ้นต่อกันของ Plugin ที่หายไปโดยตรง ส่วนการติดตั้งและการซ่อมแซมยังคงอยู่ใน openclaw plugins install, openclaw plugins update และ openclaw doctor --fix

โดยทั่วไป คำสั่ง CLI ที่ Plugin เป็นเจ้าของจะถูกติดตั้งเป็นกลุ่มคำสั่งระดับรากของ openclaw แต่ Plugin อาจลงทะเบียนคำสั่งซ้อนภายใต้คำสั่งหลักของแกน เช่น openclaw nodes ได้เช่นกัน หลังจาก inspect --runtime แสดงคำสั่งภายใต้ cliCommands ให้เรียกใช้คำสั่งนั้นตามพาธที่ระบุ ตัวอย่างเช่น สามารถตรวจสอบ Plugin ที่ลงทะเบียน demo-git ได้ด้วย openclaw demo-git ping

Plugin แต่ละรายการจะถูกจัดประเภทตามสิ่งที่ลงทะเบียนจริงขณะรันไทม์:

ดูข้อมูลเพิ่มเติมเกี่ยวกับโมเดลความสามารถได้ที่ รูปแบบ Plugin

การวินิจฉัย

openclaw plugins doctor

doctor รายงานข้อผิดพลาดในการโหลด Plugin ข้อมูลวินิจฉัยแมนิเฟสต์/การค้นพบ ประกาศความเข้ากันได้ และการอ้างอิงการกำหนดค่า Plugin ที่ล้าสมัย เช่น สล็อต Plugin ที่หายไป เมื่อโครงสร้างการติดตั้งและการกำหนดค่า Plugin ไม่มีปัญหา ระบบจะแสดง No plugin issues detected. หากยังมีการกำหนดค่าที่ล้าสมัย แต่โครงสร้างการติดตั้งส่วนอื่นยังสมบูรณ์ สรุปจะระบุสถานการณ์ดังกล่าวแทนที่จะสื่อว่า Plugin ทั้งหมดสมบูรณ์ดี

หาก Plugin ที่กำหนดค่าไว้มีอยู่บนดิสก์แต่ถูกบล็อกโดยการตรวจสอบความปลอดภัยของพาธของตัวโหลด การตรวจสอบความถูกต้องของการกำหนดค่าจะเก็บรายการ Plugin ไว้และรายงานเป็น present but blocked ให้แก้ข้อมูลวินิจฉัย Plugin ที่ถูกบล็อกก่อนหน้า เช่น ความเป็นเจ้าของพาธหรือสิทธิ์ที่ทุกคนเขียนได้ แทนที่จะนำการกำหนดค่า plugins.entries.<id> หรือ plugins.allow ออก

สำหรับความล้มเหลวด้านรูปแบบโมดูล เช่น ไม่มีเอ็กซ์พอร์ต register/activate ให้เรียกใช้อีกครั้งโดยตั้งค่า OPENCLAW_PLUGIN_LOAD_DEBUG=1 เพื่อรวมสรุปรูปแบบเอ็กซ์พอร์ตแบบกระชับไว้ในเอาต์พุตการวินิจฉัย

รีจิสทรี

openclaw plugins registryopenclaw plugins registry --refreshopenclaw plugins registry --json

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

ใช้ plugins registry เพื่อตรวจสอบว่ารีจิสทรีที่จัดเก็บถาวรมีอยู่ เป็นปัจจุบัน หรือล้าสมัย ใช้ --refresh เพื่อสร้างใหม่จากดัชนี Plugin ที่จัดเก็บถาวร นโยบายการกำหนดค่า และข้อมูลเมตาของแมนิเฟสต์/แพ็กเกจ นี่คือพาธการซ่อมแซม ไม่ใช่พาธการเปิดใช้งานรันไทม์

openclaw doctor --fix ยังซ่อมแซมความคลาดเคลื่อนของ npm ที่มีการจัดการซึ่งเกี่ยวข้องกับรีจิสทรีด้วย หากแพ็กเกจ @openclaw/* ที่ไม่มีเจ้าของหรือกู้คืนมา ภายใต้โปรเจกต์ npm ของ Plugin ที่มีการจัดการหรือราก npm แบบแบนดั้งเดิมที่มีการจัดการ ไปบดบัง Plugin ที่รวมมาในชุด doctor จะนำแพ็กเกจที่ล้าสมัยนั้นออกและสร้างรีจิสทรีใหม่ เพื่อให้การเริ่มทำงานตรวจสอบกับแมนิเฟสต์ที่รวมมาในชุด นอกจากนี้ doctor ยังเชื่อมโยงแพ็กเกจ openclaw ของโฮสต์กลับเข้าไปใน Plugin npm ที่มีการจัดการซึ่งประกาศ peerDependencies.openclaw เพื่อให้อิมพอร์ตรันไทม์ภายในแพ็กเกจ เช่น openclaw/plugin-sdk/* แก้พาธได้หลังการอัปเดตหรือการซ่อมแซม npm

มาร์เก็ตเพลส

openclaw plugins marketplace entriesopenclaw plugins marketplace entries --offlineopenclaw plugins marketplace entries --jsonopenclaw plugins marketplace entries --feed-profile <name>openclaw plugins marketplace entries --feed-url <url>openclaw plugins marketplace list <source>openclaw plugins marketplace list <source> --jsonopenclaw plugins marketplace refreshopenclaw plugins marketplace refresh --feed-profile <name>openclaw plugins marketplace refresh --feed-url <url>openclaw plugins marketplace refresh --expected-sha256 <sha256> --json

plugins marketplace entries แสดงรายการจากฟีดมาร์เก็ตเพลส OpenClaw ที่กำหนดค่าไว้ โดยค่าเริ่มต้น คำสั่งจะพยายามใช้ฟีดที่โฮสต์ไว้ และหากใช้ไม่ได้จะเปลี่ยนไปใช้สแนปช็อตล่าสุดที่ยอมรับหรือข้อมูลที่รวมมากับระบบ ใช้ --feed-profile <name> เพื่ออ่านโปรไฟล์ที่กำหนดค่าไว้โดยเฉพาะ ใช้ --feed-url <url> เพื่ออ่าน URL ของฟีดที่โฮสต์ไว้อย่างชัดเจน และใช้ --offline เพื่ออ่านสแนปช็อตล่าสุดที่ยอมรับโดยไม่ดึงข้อมูลฟีด

plugins marketplace refresh รีเฟรชสแนปช็อตของฟีดที่โฮสต์และกำหนดค่าไว้ พร้อมรายงานว่า OpenClaw ยอมรับข้อมูลที่โฮสต์ สแนปช็อตที่โฮสต์ หรือข้อมูลสำรองที่รวมมากับระบบ ใช้ --expected-sha256 เมื่อผู้เรียกต้องการให้คำสั่งล้มเหลว เว้นแต่เพย์โหลดใหม่จากโฮสต์จะตรงกับผลรวมตรวจสอบที่ตรึงไว้

list ของมาร์เก็ตเพลสรองรับพาธมาร์เก็ตเพลสภายในเครื่อง พาธของ marketplace.json รูปแบบย่อของ GitHub เช่น owner/repo URL ของรีโพ GitHub หรือ URL ของ git ส่วน --json จะแสดงป้ายกำกับแหล่งที่มาที่ได้รับการแก้ไข พร้อมทั้งแมนิเฟสต์ของมาร์เก็ตเพลสและรายการ Plugin ที่แยกวิเคราะห์แล้ว

การรีเฟรชมาร์เก็ตเพลสจะโหลดฟีดมาร์เก็ตเพลส OpenClaw ที่โฮสต์ไว้ และจัดเก็บ การตอบกลับที่ผ่านการตรวจสอบเป็นสแนปช็อตฟีดที่โฮสต์ไว้ภายในเครื่อง หากไม่ระบุตัวเลือก คำสั่งจะใช้ โปรไฟล์ฟีดเริ่มต้นที่กำหนดค่าไว้ ใช้ --feed-profile <name> เพื่อรีเฟรช โปรไฟล์ที่กำหนดค่าไว้โดยเฉพาะ ใช้ --feed-url <url> เพื่อรีเฟรช URL ของฟีดที่โฮสต์ไว้อย่างชัดเจน ใช้ --expected-sha256 <sha256> เพื่อกำหนดให้ผลรวมตรวจสอบของเพย์โหลดต้องตรงกัน (sha256:<hex> หรือค่าไดเจสต์ฐานสิบหก 64 อักขระโดยไม่มีคำนำหน้า) และใช้ --json สำหรับ เอาต์พุตที่เครื่องอ่านได้ URL ของฟีดที่โฮสต์ซึ่งระบุโดยตรงต้องไม่มี ข้อมูลรับรอง สตริงคิวรี หรือส่วนย่อย การรีเฟรชที่ไม่ได้ตรึงค่าสามารถรายงานผลลัพธ์จาก สแนปช็อตที่โฮสต์หรือข้อมูลสำรองที่รวมมากับระบบได้โดยไม่ทำให้คำสั่งล้มเหลว การรีเฟรชที่ตรึงค่าไว้ จะล้มเหลว เว้นแต่จะยอมรับเพย์โหลดใหม่จากโฮสต์ และการรีเฟรชจากโฮสต์ที่สำเร็จ จะล้มเหลวหาก OpenClaw ไม่สามารถจัดเก็บสแนปช็อตที่ผ่านการตรวจสอบได้

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

• การสร้าง Plugin
• เอกสารอ้างอิง CLI
• ClawHub