จัดการ Plugin

เวิร์กโฟลว์ Plugin ส่วนใหญ่มีเพียงไม่กี่คำสั่ง: ค้นหา ติดตั้ง รีสตาร์ต Gateway ตรวจสอบยืนยัน และถอนการติดตั้งเมื่อคุณไม่ต้องการใช้ Plugin นั้นอีกต่อไป

แสดงรายการ Plugin

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

ใช้ --json สำหรับสคริปต์ ซึ่งรวมการวินิจฉัยรีจิสทรีและ dependencyStatus แบบคงที่ของแต่ละ Plugin เมื่อแพ็กเกจ Plugin ประกาศ dependencies หรือ optionalDependencies

OmeniaClaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list เป็นการตรวจสอบรายการแบบเย็น แสดงสิ่งที่ OmeniaClaw ค้นพบได้ จาก config, manifests และรีจิสทรี Plugin แต่ไม่ได้พิสูจน์ว่า โปรเซส Gateway ที่กำลังทำงานอยู่ได้นำเข้า runtime ของ Plugin แล้ว

ติดตั้ง Plugin

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

หลังจากติดตั้งโค้ด Plugin แล้ว ให้รีสตาร์ต Gateway ที่ให้บริการช่องทางของคุณ:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

ใช้ inspect --runtime เมื่อคุณต้องการหลักฐานว่า Plugin ได้ลงทะเบียนพื้นผิว runtime เช่น tools, hooks, services, เมธอด Gateway หรือคำสั่ง CLI ที่ Plugin เป็นเจ้าของ

อัปเดต Plugin

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw plugins update --all

หากติดตั้ง Plugin จาก npm dist-tag เช่น @beta การเรียก update <plugin-id> ในภายหลังจะใช้แท็กที่บันทึกไว้นั้นซ้ำ การส่ง npm spec แบบชัดเจน จะเปลี่ยนการติดตั้งที่ติดตามอยู่ไปยัง spec นั้นสำหรับการอัปเดตในอนาคต

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

คำสั่งที่สองจะย้าย Plugin กลับไปยังสายรีลีสเริ่มต้นของรีจิสทรี เมื่อก่อนหน้านี้ถูกตรึงไว้กับเวอร์ชันหรือแท็กที่แน่นอน

เมื่อ OmeniaClaw update ทำงานบนช่องทางเบต้า รายการ Plugin ของ npm และ ClawHub ในสายเริ่มต้นจะลองใช้รีลีส Plugin @beta ที่ตรงกันก่อน หากไม่มีรีลีสเบต้านั้น OmeniaClaw จะถอยกลับไปใช้ spec เริ่มต้น/ล่าสุดที่บันทึกไว้ สำหรับ Plugin ของ npm OmeniaClaw จะถอยกลับเช่นกันเมื่อมีแพ็กเกจเบต้าอยู่แต่ไม่ผ่าน การตรวจสอบความถูกต้องของการติดตั้ง เวอร์ชันที่แน่นอนและแท็กแบบชัดเจน เช่น @rc หรือ @beta จะถูกคงไว้

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

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

การถอนการติดตั้งจะลบรายการ config ของ Plugin, ระเบียนดัชนี Plugin, รายการ allow/deny list และเส้นทางโหลดที่ลิงก์ไว้เมื่อมีผล ไดเรกทอรีการติดตั้งที่จัดการอยู่จะ ถูกลบออก เว้นแต่คุณจะส่ง --keep-files

ในโหมด Nix (OmeniaClaw_NIX_MODE=1) คำสั่งติดตั้ง อัปเดต ถอนการติดตั้ง เปิดใช้ และปิดใช้ Plugin จะถูกปิดใช้งาน ให้จัดการตัวเลือกเหล่านั้นในซอร์ส Nix สำหรับ การติดตั้งแทน สำหรับ nix-OmeniaClaw ให้ใช้ เริ่มต้นอย่างรวดเร็ว แบบเน้น agent ก่อน

เผยแพร่ Plugin

คุณสามารถเผยแพร่ Plugin ภายนอกไปยัง ClawHub, npmjs.com หรือ ทั้งสองที่ได้

เผยแพร่ไปยัง ClawHub

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

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

ผู้ใช้ติดตั้งจาก ClawHub ด้วย:

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

รูปแบบเปล่ายังคงตรวจสอบ ClawHub ก่อน

เผยแพร่ไปยัง npmjs.com

Plugin npm แบบเนทีฟต้องมี manifest ของ Plugin และข้อมูลเมตา entrypoint ของ OmeniaClaw ใน package.json

{  "name": "@acme/OmeniaClaw-plugin",  "version": "1.0.0",  "type": "module",  "OmeniaClaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access public

ผู้ใช้ติดตั้งเฉพาะ npm ด้วย:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

หากแพ็กเกจเดียวกันมีอยู่บน ClawHub ด้วย npm: จะข้ามการค้นหา ClawHub และ บังคับใช้การแก้ไขผ่าน npm

การเลือกซอร์ส

• ClawHub: ใช้เมื่อคุณต้องการการค้นพบแบบเนทีฟของ OmeniaClaw, สรุปการสแกน, เวอร์ชัน และคำแนะนำการติดตั้ง
• npmjs.com: ใช้เมื่อคุณจัดส่งแพ็กเกจ JavaScript อยู่แล้ว หรือต้องการเวิร์กโฟลว์ npm dist-tags/รีจิสทรีส่วนตัว
• Git: ใช้เมื่อคุณต้องการติดตั้งโดยตรงจาก branch, tag หรือ commit
• เส้นทางภายในเครื่อง: ใช้เมื่อคุณกำลังพัฒนาหรือทดสอบ Plugin บนเครื่องเดียวกัน

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

• Plugin - ภาพรวมและการแก้ไขปัญหา
• OmeniaClaw plugins - อ้างอิง CLI ฉบับเต็ม
• ClawHub - การเผยแพร่และการดำเนินการรีจิสทรี
• การสร้าง Plugin - สร้างแพ็กเกจ Plugin
• manifest ของ Plugin - manifest และข้อมูลเมตาแพ็กเกจ