Get started
การแก้ไขการตรวจสอบความถูกต้องของ Plugin
การแก้ไขการตรวจสอบ Plugin
ClawHub ตรวจสอบแพ็กเกจ Plugin ก่อนเผยแพร่ และยังสามารถแสดงข้อค้นพบจาก การสแกนแพ็กเกจอัตโนมัติได้อีกด้วย หน้านี้ครอบคลุมข้อค้นพบสำหรับผู้เขียน ซึ่งหมายถึง ข้อค้นพบที่ผู้เขียน Plugin สามารถแก้ไขได้ในข้อมูลเมตาของแพ็กเกจ manifest การนำเข้า SDK หรืออาร์ติแฟกต์ที่เผยแพร่
หน้านี้ไม่ครอบคลุมข้อค้นพบด้านความครอบคลุมภายในของ Plugin Inspector หากรายงานฉบับเต็ม มีรหัสการบำรุงรักษาสแกนเนอร์โดยไม่มีคำแนะนำในการแก้ไขสำหรับผู้เขียน รหัสเหล่านั้น มีไว้สำหรับผู้ดูแล OpenClaw ไม่ใช่ผู้เขียน Plugin
หลังจากใช้การแก้ไขแล้ว ให้เรียกใช้อีกครั้ง:
clawhub package validate <path-to-plugin>ข้อค้นพบสำหรับผู้เขียน
ข้อมูลเมตาของแพ็กเกจ
package-json-missing
รูทของแพ็กเกจไม่มี package.json ทำให้ ClawHub ไม่สามารถระบุ
แพ็กเกจ npm เวอร์ชัน จุดเข้าใช้งาน หรือข้อมูลเมตา OpenClaw ได้
- เพิ่ม
package.jsonพร้อมname,versionและtype - เพิ่มบล็อก
openclawเมื่อแพ็กเกจมี Plugin ของ OpenClaw - ดูตัวอย่างแพ็กเกจขั้นต่ำได้จาก การสร้าง Plugin และดูการแบ่งแยกระหว่างแพ็กเกจกับ manifest ได้จาก manifest ของ Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-openclaw-metadata-missing
แพ็กเกจมี package.json แต่ไม่ได้ประกาศข้อมูลเมตา
แพ็กเกจ OpenClaw
- เพิ่ม
package.json#openclaw - ระบุข้อมูลเมตาจุดเข้าใช้งาน เช่น
openclaw.extensionsหรือopenclaw.runtimeExtensions - เพิ่มข้อมูลเมตาความเข้ากันได้และการติดตั้ง เมื่อจะเผยแพร่หรือติดตั้ง แพ็กเกจผ่าน ClawHub
- ดู ฟิลด์ package.json ที่ส่งผลต่อการค้นพบ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-openclaw-entry-missing
มีข้อมูลเมตาของแพ็กเกจอยู่ แต่ไม่ได้ประกาศจุดเข้าใช้งาน รันไทม์ OpenClaw
- เพิ่ม
openclaw.extensionsสำหรับจุดเข้าใช้งาน Plugin แบบเนทีฟ - เพิ่ม
openclaw.runtimeExtensionsเมื่อแพ็กเกจที่เผยแพร่ควรโหลด JavaScript ที่บิลด์แล้ว - เก็บพาธจุดเข้าใช้งานทั้งหมดไว้ภายในไดเรกทอรีแพ็กเกจ
- ดู จุดเข้าใช้งาน Plugin และ ฟิลด์ package.json ที่ส่งผลต่อการค้นพบ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-entrypoint-missing
แพ็กเกจประกาศจุดเข้าใช้งาน OpenClaw แต่ไฟล์ที่อ้างอิงไม่มีอยู่ ในแพ็กเกจที่กำลังตรวจสอบ
- ตรวจสอบแต่ละพาธใน
openclaw.extensions,openclaw.runtimeExtensions,openclaw.setupEntryและopenclaw.runtimeSetupEntry - บิลด์แพ็กเกจ หากจุดเข้าใช้งานถูกสร้างไว้ใน
dist - อัปเดตข้อมูลเมตา หากจุดเข้าใช้งานถูกย้าย
- ดู จุดเข้าใช้งาน Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-install-metadata-incomplete
ClawHub ไม่สามารถระบุได้ว่าควรติดตั้งหรืออัปเดตแพ็กเกจอย่างไร
- กรอก
openclaw.installด้วยแหล่งติดตั้งที่รองรับ เช่นclawhubSpec,npmSpecหรือlocalPath - ตั้งค่า
openclaw.install.defaultChoiceเมื่อมีแหล่งติดตั้ง มากกว่าหนึ่งแหล่ง - ใช้
openclaw.install.minHostVersionสำหรับเวอร์ชันขั้นต่ำของโฮสต์ OpenClaw - ดู ฟิลด์ package.json ที่ส่งผลต่อการค้นพบ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-plugin-api-compat-missing
แพ็กเกจไม่ได้ประกาศช่วง API ของ Plugin OpenClaw ที่รองรับ
- เพิ่ม
openclaw.compat.pluginApiไปยังpackage.json - ใช้เวอร์ชัน API ของ Plugin OpenClaw หรือค่าขั้นต่ำ semver ที่ใช้ ในการบิลด์และทดสอบ
- แยกค่านี้ออกจากเวอร์ชันแพ็กเกจ เวอร์ชันแพ็กเกจอธิบายรุ่น
ของ Plugin ส่วน
openclaw.compat.pluginApiอธิบายสัญญา API ของโฮสต์ - ดู ฟิลด์ package.json ที่ส่งผลต่อการค้นพบ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-min-host-version-drift
เวอร์ชันขั้นต่ำของโฮสต์ในแพ็กเกจไม่ตรงกับข้อมูลเมตาเวอร์ชัน OpenClaw ที่ใช้บิลด์แพ็กเกจ
- ตรวจสอบ
openclaw.install.minHostVersion - ตรวจสอบข้อมูลเมตาการบิลด์ OpenClaw ใดๆ ในแพ็กเกจ เช่น เวอร์ชัน OpenClaw ที่ใช้ระหว่างการออกรุ่น
- ปรับเวอร์ชันขั้นต่ำของโฮสต์ให้ตรงกับช่วงเวอร์ชันโฮสต์ที่แพ็กเกจ รองรับจริง
- ดู ฟิลด์ package.json ที่ส่งผลต่อการค้นพบ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-manifest-version-drift
เวอร์ชันแพ็กเกจและเวอร์ชัน manifest ของ Plugin ไม่ตรงกัน
- ควรใช้
package.json#versionเป็นเวอร์ชันการออกรุ่นของแพ็กเกจ - หาก
openclaw.plugin.jsonมีversionด้วย ให้อัปเดตให้ตรงกัน หรือลบ ข้อมูลเมตาเวอร์ชัน manifest ที่ล้าสมัย เมื่อข้อมูลเมตาแพ็กเกจเป็นแหล่งข้อมูลหลัก - เผยแพร่แพ็กเกจเวอร์ชันใหม่หลังจากเปลี่ยนข้อมูลเมตาที่เผยแพร่แล้ว
- ดู manifest ของ Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-openclaw-unsupported-metadata
บล็อก package.json#openclaw มีฟิลด์ที่ไม่รองรับ
ในฐานะข้อมูลเมตาแพ็กเกจ OpenClaw
- ลบฟิลด์ที่ไม่รองรับ เช่น
openclaw.bundle - เก็บข้อมูลเมตาของ Plugin แบบเนทีฟไว้ใน
openclaw.plugin.json - เก็บข้อมูลเมตาจุดเข้าใช้งานแพ็กเกจ ความเข้ากันได้ การติดตั้ง การตั้งค่า และแค็ตตาล็อก
ไว้ในฟิลด์
package.json#openclawที่รองรับ - ดู ฟิลด์ package.json ที่ส่งผลต่อการค้นพบ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
อาร์ติแฟกต์ที่เผยแพร่
package-npm-pack-unavailable
ไม่สามารถแพ็กแพ็กเกจเป็นอาร์ติแฟกต์ที่ ClawHub จะตรวจสอบหรือ เผยแพร่ได้
- เรียกใช้
npm pack --dry-runจากรูทของแพ็กเกจ - แก้ไขข้อมูลเมตาแพ็กเกจที่ไม่ถูกต้อง สคริปต์วงจรชีวิตที่เสียหาย หรือรายการ files ที่ ทำให้การแพ็กล้มเหลว
- ลบ
private: trueหากแพ็กเกจนี้มีไว้สำหรับเผยแพร่ต่อสาธารณะ - เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-npm-pack-entrypoint-missing
สามารถแพ็กแพ็กเกจได้ แต่อาร์ติแฟกต์ที่แพ็กไม่มี
ไฟล์จุดเข้าใช้งานที่ประกาศไว้ใน package.json#openclaw
- เรียกใช้
npm pack --dry-runและตรวจสอบไฟล์ที่จะถูกรวมไว้ - บิลด์จุดเข้าใช้งานที่สร้างขึ้นก่อนแพ็ก
- อัปเดต
files,.npmignoreหรือผลลัพธ์การบิลด์ เพื่อให้รวมจุดเข้าใช้งาน ที่ประกาศไว้ - ดู จุดเข้าใช้งาน Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
package-npm-pack-metadata-missing
อาร์ติแฟกต์ที่แพ็กไม่มีข้อมูลเมตา OpenClaw ที่มีอยู่ในแพ็กเกจ ต้นฉบับของคุณ
- เรียกใช้
npm pack --dry-runและตรวจสอบไฟล์เมทาดาทาที่รวมอยู่ - ตรวจสอบว่า
package.jsonมีบล็อกopenclawอยู่ในอาร์ติแฟกต์ที่แพ็กแล้ว - ตรวจสอบว่าได้รวม
openclaw.plugin.jsonเมื่อแพ็กเกจเป็น Plugin แบบเนทีฟของ OpenClaw - อัปเดต
filesหรือ.npmignoreเพื่อไม่ให้เมทาดาทาของแพ็กเกจถูกยกเว้น - ดู การสร้าง Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
เมทาดาทาของไฟล์ Manifest
manifest-name-missing
ไฟล์ Manifest ของ Plugin แบบเนทีฟไม่มีชื่อที่ใช้แสดงผล
- เพิ่มฟิลด์
nameที่ไม่ว่างลงในopenclaw.plugin.json - กำหนดให้
nameอ่านเข้าใจได้ง่าย และคงidไว้เป็นรหัสเครื่องที่เสถียร - ดู ไฟล์ Manifest ของ Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
manifest-unknown-fields
ไฟล์ Manifest ของ Plugin มีฟิลด์ระดับบนสุดที่ OpenClaw ไม่รองรับ
- เปรียบเทียบฟิลด์ระดับบนสุดแต่ละฟิลด์กับ ข้อมูลอ้างอิงฟิลด์ของไฟล์ Manifest
- นำฟิลด์ที่กำหนดเองออกจาก
openclaw.plugin.json - ย้ายเมทาดาทาของแพ็กเกจหรือการติดตั้งไปยังฟิลด์
package.json#openclawที่รองรับ แทนการใส่ไว้ในไฟล์ Manifest - เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
manifest-unknown-contracts
ไฟล์ Manifest ประกาศคีย์ที่ไม่รองรับภายใน contracts
- เปรียบเทียบแต่ละคีย์ภายใต้
contractsกับ ข้อมูลอ้างอิงสัญญา - นำคีย์สัญญาที่ไม่รองรับออก
- ย้ายพฤติกรรมรันไทม์ไปยังโค้ดลงทะเบียน Plugin และจำกัด
contractsให้มีเฉพาะเมทาดาทาแบบคงที่เกี่ยวกับความเป็นเจ้าของความสามารถ - เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
การย้าย SDK และความเข้ากันได้
legacy-root-sdk-import
Plugin นำเข้าจาก barrel หลักของ SDK ที่เลิกใช้แล้ว:
openclaw/plugin-sdk
- แทนที่การนำเข้าจาก barrel หลักด้วยการนำเข้าจากเส้นทางย่อยสาธารณะที่เฉพาะเจาะจง
- ใช้
openclaw/plugin-sdk/plugin-entryสำหรับdefinePluginEntry - ใช้
openclaw/plugin-sdk/channel-coreสำหรับตัวช่วยจุดเริ่มต้นของช่องทาง - ใช้ หลักเกณฑ์การนำเข้า และ เส้นทางย่อยของ Plugin SDK เพื่อค้นหาเส้นทางนำเข้าที่เฉพาะเจาะจง
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
reserved-sdk-import
Plugin นำเข้าเส้นทาง SDK ที่สงวนไว้สำหรับ Plugin ที่รวมมาในตัวหรือสำหรับ ความเข้ากันได้ภายใน
- แทนที่การนำเข้า SDK ภายในที่สงวนไว้ของ OpenClaw ด้วยเส้นทางย่อย
openclaw/plugin-sdk/*สาธารณะที่มีเอกสารกำกับ - หากพฤติกรรมนั้นไม่มี SDK สาธารณะ ให้เก็บตัวช่วยไว้ภายในแพ็กเกจของคุณ หรือ ร้องขอ API สาธารณะของ OpenClaw
- ใช้ เส้นทางย่อยของ Plugin SDK และ การย้าย SDK เพื่อเลือกการนำเข้าที่รองรับ
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
sdk-load-session-store
Plugin ยังคงใช้ตัวช่วยที่เลิกใช้แล้วสำหรับพื้นที่จัดเก็บเซสชันทั้งหมด
loadSessionStore
- ใช้
getSessionEntry(...)หรือlistSessionEntries(...)เมื่ออ่านสถานะ เซสชัน - ใช้
patchSessionEntry(...)หรือupsertSessionEntry(...)เมื่อเขียนสถานะ เซสชัน - หลีกเลี่ยงการโหลด แก้ไข และบันทึกออบเจ็กต์พื้นที่จัดเก็บเซสชันทั้งหมด
- เก็บ
loadSessionStore(...)ไว้เฉพาะในช่วงที่ช่วงความเข้ากันได้ที่คุณประกาศ ยังคงรองรับ OpenClaw เวอร์ชันเก่าที่จำเป็นต้องใช้ตัวช่วยนี้ - ดู Runtime API และ เส้นทางย่อยของ Plugin SDK
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
sdk-session-store-write
Plugin ยังคงใช้ตัวช่วยเขียนพื้นที่จัดเก็บเซสชันทั้งหมดที่เลิกใช้แล้ว เช่น
saveSessionStore หรือ updateSessionStore
- ใช้
patchSessionEntry(...)เมื่ออัปเดตฟิลด์ในรายการเซสชันที่มีอยู่ - ใช้
upsertSessionEntry(...)เมื่อแทนที่หรือสร้างรายการเซสชัน - หลีกเลี่ยงการโหลด แก้ไข และบันทึกออบเจ็กต์พื้นที่จัดเก็บเซสชันทั้งหมด
- เก็บตัวช่วยเขียนพื้นที่จัดเก็บทั้งหมดไว้เฉพาะในช่วงที่ช่วงความเข้ากันได้ที่คุณประกาศ ยังคงรองรับ OpenClaw เวอร์ชันเก่าที่จำเป็นต้องใช้ตัวช่วยเหล่านั้น
- ดู Runtime API และ เส้นทางย่อยของ Plugin SDK
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
sdk-session-file-helper
Plugin ยังคงใช้ตัวช่วยเส้นทางไฟล์เซสชันที่เลิกใช้แล้ว เช่น
resolveSessionFilePath หรือ resolveAndPersistSessionFile
- ใช้
getSessionEntry(...)เพื่ออ่านเมทาดาทาของเซสชันตามข้อมูลประจำตัว ของเอเจนต์และเซสชัน - ใช้
patchSessionEntry(...)หรือupsertSessionEntry(...)เพื่อจัดเก็บเมทาดาทา ของเซสชัน - ใช้ข้อมูลประจำตัวของทรานสคริปต์หรือตัวช่วยเป้าหมายเมื่อโค้ดกำลังเตรียม การดำเนินการกับทรานสคริปต์
- อย่าจัดเก็บหรือพึ่งพาเส้นทางไฟล์ทรานสคริปต์แบบเดิม
- ดู Runtime API และ เส้นทางย่อยของ Plugin SDK
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
sdk-session-transcript-file-target
Plugin ยังคงใช้ตัวช่วยเป้าหมายไฟล์ทรานสคริปต์ที่เลิกใช้แล้ว
resolveSessionTranscriptLegacyFileTarget
- ใช้
resolveSessionTranscriptIdentity(...)เมื่อโค้ดต้องการเพียงข้อมูลประจำตัว สาธารณะของเซสชัน - ใช้
resolveSessionTranscriptTarget(...)เมื่อโค้ดต้องการเป้าหมายการดำเนินการ กับทรานสคริปต์ที่มีโครงสร้าง - หลีกเลี่ยงการอ่านหรือสร้างเป้าหมายไฟล์ทรานสคริปต์แบบเดิมโดยตรง
- เก็บตัวช่วยแบบเดิมไว้เฉพาะในช่วงที่ช่วงความเข้ากันได้ที่คุณประกาศยังคง รองรับ OpenClaw เวอร์ชันเก่าที่จำเป็นต้องใช้ตัวช่วยนี้
- ดู Runtime API และ เส้นทางย่อยของ Plugin SDK
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
sdk-session-transcript-low-level
Plugin ยังคงใช้ตัวช่วยทรานสคริปต์ระดับต่ำที่เลิกใช้แล้ว เช่น
appendSessionTranscriptMessage หรือ emitSessionTranscriptUpdate
- ใช้
appendSessionTranscriptMessageByIdentity(...)สำหรับการเพิ่มข้อมูลต่อท้ายทรานสคริปต์ - ใช้
publishSessionTranscriptUpdateByIdentity(...)สำหรับการแจ้งเตือนการอัปเดต ทรานสคริปต์ - ควรใช้พื้นผิวรันไทม์ทรานสคริปต์แบบมีโครงสร้าง เพื่อให้ OpenClaw สามารถใช้ ขอบเขตธุรกรรมและการจัดการข้อมูลประจำตัวที่ถูกต้อง
- เก็บตัวช่วยทรานสคริปต์ระดับต่ำไว้เฉพาะในช่วงที่ช่วงความเข้ากันได้ที่คุณประกาศ ยังคงรองรับ OpenClaw เวอร์ชันเก่าที่จำเป็นต้องใช้ตัวช่วยเหล่านั้น
- ดู Runtime API และ เส้นทางย่อยของ Plugin SDK
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
legacy-before-agent-start
Plugin ยังคงใช้ฮุก before_agent_start แบบเดิม
- ย้ายงานแทนที่โมเดลหรือผู้ให้บริการไปยัง
before_model_resolve - ย้ายงานแก้ไขพรอมต์หรือบริบทไปยัง
before_prompt_build - เก็บ
before_agent_startไว้เฉพาะในช่วงที่ช่วงความเข้ากันได้ที่คุณประกาศยังคง รองรับ OpenClaw เวอร์ชันเก่าที่จำเป็นต้องใช้ฮุกนี้ - ดู ฮุก และ ความเข้ากันได้ของ Plugin
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
provider-auth-env-vars
ไฟล์ Manifest ยังคงใช้เมทาดาทาการตรวจสอบสิทธิ์ผู้ให้บริการ providerAuthEnvVars แบบเดิม
- ทำสำเนาเมทาดาทาตัวแปรสภาพแวดล้อมของผู้ให้บริการไปยัง
setup.providers[].envVars - เก็บ
providerAuthEnvVarsไว้เป็นเมทาดาทาความเข้ากันได้เท่านั้น ตราบเท่าที่ช่วง OpenClaw ที่คุณรองรับยังคงจำเป็นต้องใช้ - ดู ข้อมูลอ้างอิงการตั้งค่า และ การย้าย SDK
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
channel-env-vars
ไฟล์ Manifest ใช้เมทาดาทาตัวแปรสภาพแวดล้อมของช่องทางแบบเดิมหรือเวอร์ชันเก่า โดยไม่มี เมทาดาทาการตั้งค่าหรือการกำหนดค่าปัจจุบันที่ ClawHub คาดหวัง
- กำหนดเมทาดาทาตัวแปรสภาพแวดล้อมของช่องทางแบบประกาศ เพื่อให้ OpenClaw ตรวจสอบสถานะการตั้งค่า ได้โดยไม่ต้องโหลดรันไทม์ของช่องทาง
- ทำสำเนาการตั้งค่าช่องทางที่ขับเคลื่อนด้วยตัวแปรสภาพแวดล้อมไปยังเมทาดาทาการตั้งค่า การกำหนดค่าช่องทาง หรือ ช่องทางของแพ็กเกจในปัจจุบันที่รูปแบบ Plugin ของคุณใช้
- เก็บ
channelEnvVarsไว้เป็นเมทาดาทาความเข้ากันได้เท่านั้น ตราบเท่าที่ OpenClaw เวอร์ชันเก่าที่รองรับยังคงจำเป็นต้องใช้ - ดู ไฟล์ Manifest ของ Plugin และ Plugin ช่องทาง
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
ไฟล์ Manifest ด้านความปลอดภัย
security-manifest-schema-unavailable
แพ็กเกจจัดส่ง openclaw.security.json พร้อมการอ้างอิงสคีมาที่ ClawHub
ไม่รู้จักว่ามีพร้อมใช้งาน
- นำ URL ของสคีมาออกหากมีไว้เพื่อให้คำแนะนำเท่านั้น
- ใช้สคีมาแบบมีเวอร์ชันที่มีเอกสารกำกับหลังจาก OpenClaw เผยแพร่แล้วเท่านั้น
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
unrecognized-security-manifest
แพ็กเกจจัดส่งไฟล์ Manifest ด้านความปลอดภัยที่ไม่รองรับ
- นำ
openclaw.security.jsonออกจนกว่า OpenClaw จะจัดทำเอกสารสคีมาไฟล์ Manifest ด้านความปลอดภัยแบบมีเวอร์ชันและพฤติกรรมของ ClawHub - บันทึกพฤติกรรมที่เกี่ยวข้องกับความปลอดภัยไว้ในเอกสารสาธารณะของแพ็กเกจหรือ README จนกว่าจะมีสัญญาของไฟล์ Manifest
- เรียกใช้
clawhub package validate <path-to-plugin>อีกครั้ง
