Plugin

จัดการ Gateway plugins, ชุด hook และบันเดิลที่เข้ากันได้

# คำสั่ง

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw plugins search <query>
openclaw plugins search <query> --limit 20
openclaw plugins search <query> --json
openclaw plugins install <path-or-spec>
openclaw plugins inspect <id>
openclaw plugins inspect <id> --runtime
openclaw plugins inspect <id> --json
openclaw plugins inspect --all
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins registry
openclaw plugins registry --refresh
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins marketplace list <marketplace>
openclaw plugins marketplace list <marketplace> --json

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

# ติดตั้ง

openclaw plugins search "calendar"                   # search ClawHub plugins
openclaw plugins install <package>                      # npm by default
openclaw plugins install clawhub:<package>              # ClawHub only
openclaw plugins install npm:<package>                  # npm only
openclaw plugins install npm-pack:<path.tgz>            # local npm pack through npm install semantics
openclaw plugins install git:github.com/<owner>/<repo>  # git repo
openclaw plugins install git:github.com/<owner>/<repo>@<ref>
openclaw plugins install <package> --force              # overwrite existing install
openclaw plugins install <package> --pin                # pin version
openclaw plugins install <package> --dangerously-force-unsafe-install
openclaw plugins install <path>                         # local path
openclaw plugins install <plugin>@<marketplace>         # marketplace
openclaw plugins install <plugin> --marketplace <name>  # marketplace (explicit)
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>

plugins search คิวรี ClawHub เพื่อค้นหาแพ็กเกจ plugin ที่ติดตั้งได้ และพิมพ์ ชื่อแพ็กเกจที่พร้อมติดตั้ง โดยค้นหาแพ็กเกจ code-plugin และ bundle-plugin ไม่ใช่ skills ใช้ openclaw skills search สำหรับ ClawHub skills

การติดตั้ง ClawHub ใช้ locator clawhub:<package> ที่ชัดเจน:

openclaw plugins install clawhub:openclaw-codex-app-server
openclaw plugins install clawhub:[email protected]

Bare plugin specs ที่ปลอดภัยสำหรับ npm จะติดตั้งจาก npm โดยค่าเริ่มต้นในช่วงเปลี่ยนผ่านการเปิดตัว:

openclaw plugins install openclaw-codex-app-server

ใช้ npm: เพื่อระบุการ resolve แบบ npm-only ให้ชัดเจน:

openclaw plugins install npm:openclaw-codex-app-server
openclaw plugins install npm:@scope/[email protected]

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

# ชวเลข Marketplace

ใช้ชวเลข plugin@marketplace เมื่อชื่อ marketplace มีอยู่ใน cache รีจิสทรีท้องถิ่นของ 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

สำหรับ path ในเครื่องและ archive นั้น OpenClaw ตรวจจับโดยอัตโนมัติ:

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

# แสดงรายการ

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw plugins list --json
openclaw plugins search <query>
openclaw plugins search <query> --limit 20
openclaw plugins search <query> --json

--enabledboolean

แสดงเฉพาะ Plugin ที่เปิดใช้งานอยู่

--verboseboolean

เปลี่ยนจากมุมมองตารางเป็นบรรทัดรายละเอียดราย Plugin พร้อม metadata แหล่งที่มา/ต้นทาง/เวอร์ชัน/การเปิดใช้งาน

--jsonboolean

inventory แบบอ่านได้โดยเครื่อง พร้อม diagnostics ของรีจิสทรีและสถานะการติดตั้ง dependency ของ package

plugins search เป็นการค้นหา catalog ClawHub ระยะไกล คำสั่งนี้ไม่ตรวจสอบสถานะในเครื่อง ไม่แก้ไข config ไม่ติดตั้ง package และไม่โหลดโค้ด runtime ของ Plugin ผลการค้นหารวมชื่อ package ของ ClawHub, family, channel, version, summary และคำแนะนำการติดตั้ง เช่น openclaw plugins install clawhub:<package>

สำหรับงาน Plugin ที่ bundle มาแล้วภายใน Docker image ที่ package แล้ว ให้ bind-mount ไดเรกทอรี source ของ Plugin ทับ path source ที่ package ตรงกัน เช่น /app/extensions/synology-chat OpenClaw จะค้นพบ overlay source ที่ mount ไว้นั้นก่อน /app/dist/extensions/synology-chat; ไดเรกทอรี source ที่คัดลอกมาเฉย ๆ จะยังไม่ทำงาน เพื่อให้การติดตั้งแบบ packaged ปกติยังใช้ dist ที่ compile แล้ว

สำหรับการ debug hook runtime:

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

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

openclaw plugins install -l ./my-plugin

# ดัชนี Plugin

metadata การติดตั้ง Plugin เป็นสถานะที่จัดการโดยเครื่อง ไม่ใช่ config ของผู้ใช้ การติดตั้งและการอัปเดตจะเขียนข้อมูลนี้ไปยัง plugins/installs.json ภายใต้ไดเรกทอรีสถานะ OpenClaw ที่ active อยู่ map ระดับบนสุด installRecords เป็นแหล่งข้อมูลถาวรของ metadata การติดตั้ง รวมถึง record สำหรับ manifest ของ Plugin ที่เสียหรือหายไป array plugins คือ cache รีจิสทรี cold ที่ derive จาก manifest ไฟล์นี้มีคำเตือนห้ามแก้ไขและถูกใช้โดย openclaw plugins update, uninstall, diagnostics และรีจิสทรี Plugin แบบ cold

เมื่อ OpenClaw เห็น record plugins.installs แบบ legacy ที่ shipped มาใน config การอ่าน runtime จะปฏิบัติกับ record เหล่านั้นเป็น input สำหรับความเข้ากันได้โดยไม่เขียน openclaw.json ใหม่ การเขียน Plugin แบบชัดเจนและ openclaw doctor --fix จะย้าย record เหล่านั้นเข้าไปในดัชนี Plugin และลบ key config เมื่ออนุญาตให้เขียน config ได้ หากการเขียนใดล้มเหลว record ใน config จะถูกเก็บไว้เพื่อไม่ให้ metadata การติดตั้งสูญหาย

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

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files

uninstall ลบ record ของ Plugin ออกจาก plugins.entries, ดัชนี Plugin ที่ persisted ไว้, รายการ allow/deny ของ Plugin และรายการ plugins.load.paths ที่ linked เมื่อเกี่ยวข้อง เว้นแต่ตั้งค่า --keep-files ไว้ uninstall จะลบไดเรกทอรีการติดตั้งแบบ managed ที่ติดตามอยู่ด้วย เมื่อไดเรกทอรีนั้นอยู่ภายใน root extensions ของ Plugin ของ OpenClaw สำหรับ Plugin หน่วยความจำ active ช่องหน่วยความจำจะ reset เป็น memory-core

# อัปเดต

openclaw plugins update <id-or-npm-spec>
openclaw plugins update --all
openclaw plugins update <id-or-npm-spec> --dry-run
openclaw plugins update @openclaw/voice-call
openclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install

การอัปเดตใช้กับการติดตั้ง Plugin ที่ติดตามอยู่ในดัชนี Plugin แบบ managed และการติดตั้ง hook-pack ที่ติดตามอยู่ใน hooks.internal.installs

# ตรวจสอบ

openclaw plugins inspect <id>
openclaw plugins inspect <id> --runtime
openclaw plugins inspect <id> --json

Inspect แสดง identity, สถานะการโหลด, แหล่งที่มา, ความสามารถของ manifest, flag นโยบาย, diagnostics, metadata การติดตั้ง, ความสามารถของ bundle และการรองรับ server MCP หรือ LSP ที่ตรวจพบ โดยค่าเริ่มต้นจะไม่ import runtime ของ Plugin เพิ่ม --runtime เพื่อโหลด module ของ Plugin และรวม hook, tool, command, service, method ของ gateway และ HTTP route ที่ register แล้ว การตรวจสอบ runtime จะรายงาน dependency ของ Plugin ที่ขาดหายโดยตรง ส่วนการติดตั้งและซ่อมแซมยังอยู่ใน openclaw plugins install, openclaw plugins update และ openclaw doctor --fix

command CLI ที่ Plugin เป็นเจ้าของจะถูกติดตั้งเป็นกลุ่มคำสั่ง root openclaw หลังจาก inspect --runtime แสดง command ใต้ cliCommands แล้ว ให้รันเป็น openclaw <command> ...; ตัวอย่างเช่น Plugin ที่ register demo-git สามารถตรวจสอบได้ด้วย openclaw demo-git ping

แต่ละ Plugin ถูกจัดประเภทตามสิ่งที่ register จริงใน runtime:

• plain-capability — ประเภทความสามารถเดียว (เช่น Plugin ที่เป็นเฉพาะ provider)
• hybrid-capability — ความสามารถหลายประเภท (เช่น ข้อความ + เสียงพูด + รูปภาพ)
• hook-only — มีเฉพาะ hook ไม่มีความสามารถหรือพื้นผิว
• non-capability — เครื่องมือ/คำสั่ง/บริการ แต่ไม่มีความสามารถ

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

# Doctor

openclaw plugins doctor

doctor รายงานข้อผิดพลาดในการโหลด Plugin การวินิจฉัย manifest/discovery และประกาศความเข้ากันได้ เมื่อทุกอย่างเรียบร้อย จะแสดง No plugin issues detected.

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

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

# Registry

openclaw plugins registry
openclaw plugins registry --refresh
openclaw plugins registry --json

registry Plugin ในเครื่องคือโมเดลอ่านแบบ cold ที่ OpenClaw เก็บถาวรไว้สำหรับตัวตนของ Plugin ที่ติดตั้ง การเปิดใช้งาน เมทาดาทาแหล่งที่มา และความเป็นเจ้าของ contribution การเริ่มต้นปกติ การค้นหาเจ้าของ provider การจัดประเภทการตั้งค่า channel และ inventory ของ Plugin สามารถอ่านได้โดยไม่ต้อง import module runtime ของ Plugin

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

openclaw doctor --fix ยังซ่อมแซมความคลาดเคลื่อนของ npm ที่จัดการอยู่ซึ่งอยู่ใกล้กับ registry ด้วย: หาก package @openclaw/* ที่กำพร้าหรือกู้คืนมาใต้ราก npm ของ Plugin ที่จัดการอยู่ไปบดบัง Plugin ที่ bundle มา doctor จะลบ package เก่านั้นและสร้าง registry ใหม่เพื่อให้การเริ่มต้นตรวจสอบกับ manifest ที่ bundle มา

# Marketplace

openclaw plugins marketplace list <source>
openclaw plugins marketplace list <source> --json

รายการ Marketplace รับ path ของ marketplace ในเครื่อง, path ของ marketplace.json, shorthand ของ GitHub เช่น owner/repo, URL repo ของ GitHub หรือ URL git --json จะแสดงป้ายกำกับแหล่งที่มาที่ resolve แล้ว พร้อม manifest ของ marketplace และรายการ Plugin ที่ parse แล้ว

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

• การสร้าง Plugin
• อ้างอิง CLI
• Plugin จากชุมชน