Plugin guides
Plugin แบบเนทีฟของ Codex
การรองรับ Plugin ของ Codex แบบเนทีฟช่วยให้เอเจนต์ OpenClaw ในโหมด Codex ใช้ความสามารถของแอปและ Plugin จาก app-server ของ Codex ภายในเธรด Codex เดียวกันกับที่จัดการรอบการทำงานของ OpenClaw การเรียก Plugin จะยังคงอยู่ในทรานสคริปต์ Codex แบบเนทีฟ โดย app-server ของ Codex เป็นผู้ดำเนินการ MCP ที่มีแอปรองรับ OpenClaw จะไม่แปลง Plugin ของ Codex เป็นเครื่องมือไดนามิก codex_plugin_* สังเคราะห์ของ OpenClaw
ใช้หน้านี้หลังจากที่ ชุดควบคุม Codex พื้นฐานทำงานแล้ว
ข้อกำหนด
- รันไทม์ของเอเจนต์ต้องเป็นชุดควบคุม Codex แบบเนทีฟ
plugins.entries.codex.enabledต้องเป็นtrueplugins.entries.codex.config.codexPlugins.enabledต้องเป็นtrue- app-server ของ Codex เป้าหมายต้องมองเห็นรายการมาร์เก็ตเพลส, Plugin และแอปที่คาดไว้
- การย้ายข้อมูลรองรับเฉพาะ Plugin
openai-curatedที่ตรวจพบว่าติดตั้งจากซอร์สใน Codex home ต้นทาง - Plugin
workspace-directoryที่กำหนดค่าด้วยตนเองต้องใช้ app-server ของ Codex ซึ่งplugin/listยอมรับmarketplaceKindsและข้อมูลสรุปเวิร์กสเปซที่ไม่มีพาธมีremotePluginIdPlugin ต้องติดตั้งและเปิดใช้งานไว้แล้ว และแอปที่ Plugin เป็นเจ้าของต้องเข้าถึงได้ในapp/list
codexPlugins ไม่มีผลต่อการทำงานผ่านผู้ให้บริการ OpenClaw, การเชื่อมโยงบทสนทนา ACP หรือชุดควบคุมอื่น เนื่องจากเส้นทางเหล่านั้นไม่เคยสร้างเธรด app-server ของ Codex ที่มีการกำหนดค่า apps แบบเนทีฟ
บัญชี Codex, ความพร้อมใช้งานของแอป และการควบคุมแอป/Plugin ของเวิร์กสเปซในฝั่ง OpenAI มาจากบัญชี Codex ที่ลงชื่อเข้าใช้ โปรดดู การใช้ Codex กับแพ็กเกจ ChatGPT ของคุณ สำหรับรูปแบบบัญชีและการดูแลระบบของ OpenAI
เริ่มต้นอย่างรวดเร็ว
แสดงตัวอย่างการย้ายข้อมูลจาก Codex home ต้นทาง:
openclaw migrate codex --dry-runเพิ่ม --verify-plugin-apps เพื่อให้การย้ายข้อมูลเรียก app/list ของต้นทาง และกำหนดให้แอปทุกแอปที่ Plugin เป็นเจ้าของต้องมีอยู่ เปิดใช้งาน และเข้าถึงได้ก่อนวางแผนเปิดใช้งานแบบเนทีฟ:
openclaw migrate codex --dry-run --verify-plugin-appsนำการย้ายข้อมูลไปใช้เมื่อแผนถูกต้อง:
openclaw migrate apply codex --yesการย้ายข้อมูลจะเขียนรายการ codexPlugins อย่างชัดเจนสำหรับ Plugin ที่มีสิทธิ์ และเรียก plugin/install ของ app-server ของ Codex สำหรับ Plugin ที่เลือก การกำหนดค่าหลังย้ายข้อมูลจะมีลักษณะดังนี้:
{ plugins: { entries: { codex: { enabled: true, config: { codexPlugins: { enabled: true, allow_destructive_actions: true, plugins: { "google-calendar": { enabled: true, marketplaceName: "openai-curated", pluginName: "google-calendar", }, }, }, }, }, }, },}การย้ายข้อมูลยังคงจำกัดเฉพาะ openai-curated หากต้องการใช้ Plugin workspace-directory ที่มีอยู่ ให้เพิ่มด้วยตนเองโดยใช้ summary.id แบบระบุมาร์เก็ตเพลสอย่างถูกต้องตรงตามที่ plugin/list ส่งคืน ตัวอย่างเช่น หาก Codex ส่งคืน example-plugin@workspace-directory ให้กำหนดค่าด้วยค่าที่ครบถ้วนนั้นแทนชื่อที่แสดง:
{ plugins: { entries: { codex: { enabled: true, config: { codexPlugins: { enabled: true, plugins: { "example-plugin": { enabled: true, marketplaceName: "workspace-directory", pluginName: "example-plugin@workspace-directory", }, }, }, }, }, }, },}OpenClaw จะไม่เรียก plugin/install หรือเริ่มการยืนยันตัวตนสำหรับ Plugin workspace-directory ให้ติดตั้ง เปิดใช้งาน และยืนยันตัวตนใน Codex ก่อนเพิ่มหรือเปิดใช้งานนโยบาย OpenClaw โดย OpenClaw จะซ่อนแอปไว้เมื่อการตอบกลับไม่มีหลักฐานที่ตรงกันทุกประการเกี่ยวกับมาร์เก็ตเพลส, รหัส Plugin, รหัสรายละเอียด หรือความพร้อมของแอป หาก Codex ปฏิเสธคำขอ plugin/list ของเวิร์กสเปซแบบระบุชัดเจน OpenClaw จะรายงาน marketplace_missing สำหรับ Plugin ของเวิร์กสเปซที่เปิดใช้งานแต่ละรายการ และยังคงให้ Plugin แบบคัดสรรที่ค้นพบแยกต่างหากใช้งานได้
หลังจากเปลี่ยน codexPlugins บทสนทนา Codex ใหม่จะรับชุดแอปที่อัปเดตโดยอัตโนมัติ เรียกใช้ /new หรือ /reset เพื่อรีเฟรชบทสนทนาปัจจุบัน การเปลี่ยนการเปิด/ปิดใช้งาน Plugin ไม่จำเป็นต้องรีสตาร์ต Gateway
จัดการ Plugin จากแชต
/codex plugins ใช้ตรวจสอบหรือเปลี่ยน Plugin ของ Codex แบบเนทีฟที่กำหนดค่าไว้จากแชตเดียวกับที่คุณใช้ควบคุมชุดควบคุม Codex:
/codex plugins/codex plugins list/codex plugins disable google-calendar/codex plugins enable google-calendar/codex plugins เป็นนามแฝงของ /codex plugins list รายการจะแสดงคีย์ สถานะเปิด/ปิด ชื่อ Plugin ของ Codex และมาร์เก็ตเพลสของ Plugin ที่กำหนดค่าแต่ละรายการจาก plugins.entries.codex.config.codexPlugins.plugins
enable/disable เขียนเฉพาะใน ~/.openclaw/openclaw.json เท่านั้น โดยจะไม่แก้ไข ~/.codex/config.toml หรือติดตั้ง Plugin ของ Codex ใหม่ มีเพียงเจ้าของหรือไคลเอนต์ Gateway ที่มีขอบเขต operator.admin เท่านั้นที่เรียกใช้ได้
การเปิดใช้งาน Plugin ที่กำหนดค่าไว้จะเปิดสวิตช์ส่วนกลาง codexPlugins.enabled ด้วย หาก Plugin แบบคัดสรรถูกเขียนไว้ในสถานะปิดใช้งานเพราะการย้ายข้อมูลส่งคืน auth_required ให้อนุญาตแอปอีกครั้งใน Codex ก่อนเปิดใช้งานใน OpenClaw สำหรับรายการ workspace-directory การเปิดใช้งานที่นี่จะเปลี่ยนเฉพาะนโยบาย OpenClaw เท่านั้น โดย Plugin และแอปต้องทำงานอยู่ใน Codex แล้ว
วิธีการตั้งค่า Plugin แบบเนทีฟ
การผสานรวมติดตามสถานะสามสถานะ:
| สถานะ | ความหมาย |
|---|---|
| ติดตั้งแล้ว | Codex มีชุด Plugin อยู่ในรันไทม์ app-server เป้าหมาย |
| เปิดใช้งานแล้ว | Codex รายงานว่า Plugin เปิดใช้งานอยู่ และการกำหนดค่า OpenClaw อนุญาตให้ใช้ในรอบการทำงานของชุดควบคุม Codex |
| เข้าถึงได้ | app-server ของ Codex ยืนยันว่ารายการแอปของ Plugin พร้อมใช้งานสำหรับบัญชีที่ใช้งานอยู่และเชื่อมโยงกับข้อมูลประจำตัว Plugin ที่กำหนดค่าไว้ |
สำหรับ Plugin openai-curated การย้ายข้อมูลคือขั้นตอนการติดตั้ง/ตรวจสอบสิทธิ์ที่คงทน:
- ระหว่างการวางแผน OpenClaw จะอ่านรายละเอียด
plugin/readของ Codex ต้นทาง และตรวจสอบว่าบัญชี app-server ของ Codex ต้นทางเป็นบัญชีที่สมัครใช้งาน ChatGPT การตอบกลับที่ระบุว่าไม่ใช่บัญชี ChatGPT หรือไม่มีบัญชี จะข้าม Plugin ที่มีแอปรองรับด้วยcodex_subscription_required - โดยค่าเริ่มต้น การย้ายข้อมูลจะข้ามการเรียก
app/listของต้นทาง: Plugin ต้นทางที่มีแอปรองรับและผ่านเกณฑ์บัญชีจะถูกวางแผนโดยไม่ตรวจสอบการเข้าถึงแอปต้นทาง และความล้มเหลวในการรับข้อมูลบัญชีผ่านการรับส่งข้อมูลจะถูกข้ามด้วยcodex_account_unavailable - เมื่อใช้
--verify-plugin-appsการย้ายข้อมูลจะบันทึกสแนปช็อตapp/listของต้นทางใหม่ และกำหนดให้แอปทุกแอปที่ Plugin เป็นเจ้าของต้องมีอยู่ เปิดใช้งาน และเข้าถึงได้ก่อนวางแผนเปิดใช้งานแบบเนทีฟ จากนั้นความล้มเหลวในการรับข้อมูลบัญชีผ่านการรับส่งข้อมูลจะไปตรวจสอบกับเกณฑ์รายการแอปต้นทางแทนที่จะข้ามทันที
สำหรับ Plugin workspace-directory การตั้งค่าจะเกิดขึ้นภายนอก OpenClaw โดย OpenClaw จะสอบถามมาร์เก็ตเพลสนั้นเฉพาะเมื่อมีการกำหนดค่ารายการเวิร์กสเปซที่เปิดใช้งานอย่างน้อยหนึ่งรายการ จากนั้นจะค้นหา Plugin แต่ละรายการด้วย summary.id ที่ตรงกันทุกประการ และนำการตรวจสอบความเป็นเจ้าของผ่าน plugin/read กับความพร้อมผ่าน app/list ที่มีอยู่กลับมาใช้ Plugin ที่ยังไม่ได้ติดตั้ง ปิดใช้งาน เข้าถึงไม่ได้ หรือยังไม่ได้ยืนยันตัวตนจะไม่เปิดเผยแอปใด ๆ และ OpenClaw จะไม่พยายามติดตั้งหรือยืนยันตัวตน
รายการแอปของรันไทม์เป็นการตรวจสอบการเข้าถึงของเซสชันเป้าหมายสำหรับทั้ง Plugin แบบคัดสรรที่ย้ายข้อมูลแล้วและ Plugin ของเวิร์กสเปซที่กำหนดค่าด้วยตนเอง การตั้งค่าเซสชันของชุดควบคุม Codex จะคำนวณการกำหนดค่าแอปแบบจำกัดสำหรับเธรดจากแอปของ Plugin ที่เปิดใช้งานและเข้าถึงได้ โดยจะไม่คำนวณใหม่ในทุกรอบการทำงาน ดังนั้น /codex plugins enable/disable จะมีผลเฉพาะกับบทสนทนา Codex ใหม่ ใช้ /new หรือ /reset เพื่อรับการเปลี่ยนแปลงในบทสนทนาปัจจุบัน
ขอบเขตการรองรับ V1
- เฉพาะ Plugin
openai-curatedที่ติดตั้งอยู่แล้วในรายการ app-server ของ Codex ต้นทางเท่านั้นที่มีสิทธิ์ย้ายข้อมูล - รันไทม์ยังรองรับรายการ
workspace-directoryที่ระบุชัดเจนบน app-server รุ่นที่plugin/listรองรับmarketplaceKindsและส่งคืนremotePluginIdสำหรับข้อมูลสรุปเวิร์กสเปซที่ไม่มีพาธ รายการเหล่านี้ต้องใช้summary.idแบบระบุมาร์เก็ตเพลสที่ตรงกันทุกประการ และต้องติดตั้ง เปิดใช้งาน และเข้าถึงแอปได้อยู่แล้ว คำขอรายการเวิร์กสเปซที่ถูกปฏิเสธจะสร้างการวินิจฉัยmarketplace_missingต่อ Plugin ตามที่มีอยู่ การไม่มีหลักฐานเกี่ยวกับมาร์เก็ตเพลส, Plugin, รายละเอียด หรือแอป จะไม่เปิดเผยแอปของเวิร์กสเปซ ส่วนรายการแบบคัดสรรจากคำขอรายการเริ่มต้นจะยังคงใช้งานได้ - Plugin ต้นทางที่มีแอปรองรับต้องผ่านเกณฑ์การสมัครใช้งานระหว่างการย้ายข้อมูล
--verify-plugin-appsจะเพิ่มเกณฑ์รายการแอปต้นทาง บัญชีที่ไม่ผ่านเกณฑ์การสมัครใช้งาน รวมถึงแอปต้นทางที่เข้าถึงไม่ได้/ปิดใช้งาน/หายไป หรือความล้มเหลวในการรีเฟรชรายการแอปในโหมดตรวจสอบ จะถูกรายงานเป็นรายการที่ข้ามและต้องจัดการด้วยตนเอง แทนที่จะเป็นรายการกำหนดค่าที่เปิดใช้งาน รายละเอียด Plugin ที่อ่านไม่ได้จะถูกข้ามก่อนเกณฑ์รายการแอป - การย้ายข้อมูลจะเขียนข้อมูลประจำตัว Plugin อย่างชัดเจน (
marketplaceNameและpluginName) โดยจะไม่เขียนพาธแคชmarketplacePathภายในเครื่อง codexPlugins.enabledเป็นสวิตช์เปิดใช้งานส่วนกลางเพียงรายการเดียว ไม่มีไวลด์การ์ดplugins["*"]หรือคีย์การกำหนดค่าที่มอบอำนาจติดตั้งโดยพลการ- มาร์เก็ตเพลสที่ไม่ใช่แบบคัดสรร ชุด Plugin ที่แคชไว้ ฮุก และไฟล์การกำหนดค่า Codex จะถูกเก็บไว้ในรายงานการย้ายข้อมูลเพื่อให้ตรวจสอบด้วยตนเอง และไม่เปิดใช้งานโดยอัตโนมัติ รันไทม์ยอมรับรายการ
workspace-directoryที่กำหนดค่าด้วยตนเอง แต่มาร์เก็ตเพลสอื่นยังไม่รองรับ
รายการแอปและความเป็นเจ้าของ
OpenClaw อ่านรายการแอปของ Codex ผ่าน app/list ของ app-server แคชไว้ในหน่วยความจำเป็นเวลาหนึ่งชั่วโมง และรีเฟรชรายการที่ล้าสมัยหรือขาดหายแบบอะซิงโครนัส แคชนี้อยู่เฉพาะในกระบวนการ การรีสตาร์ต CLI หรือ Gateway จะล้างแคช และ OpenClaw จะสร้างใหม่จากการอ่าน app/list ครั้งถัดไป
การย้ายข้อมูลและรันไทม์ใช้คีย์แคชแยกกัน:
- การตรวจสอบการย้ายข้อมูลต้นทางใช้ Codex home และตัวเลือกเริ่มต้นของต้นทาง โดยทำงานเฉพาะเมื่อใช้
--verify-plugin-appsและบังคับให้ไล่อ่านapp/listของต้นทางใหม่สำหรับการวางแผนรอบนั้น - การตั้งค่ารันไทม์เป้าหมายใช้ข้อมูลประจำตัว app-server ของ Codex ของเอเจนต์เป้าหมายเมื่อสร้างการกำหนดค่าแอปของเธรด การเปิดใช้งาน Plugin แบบคัดสรรจะทำให้คีย์แคชเป้าหมายนั้นใช้ไม่ได้ แล้วบังคับรีเฟรชหลังจาก
plugin/installการตั้งค่าworkspace-directoryจะไม่ผ่านเส้นทางการเปิดใช้งานนี้
แอปของ Plugin จะถูกเปิดเผยเฉพาะเมื่อ OpenClaw สามารถเชื่อมโยงกลับไปยัง Plugin ที่กำหนดค่าไว้ผ่านความเป็นเจ้าของที่เสถียร ได้แก่ รหัสแอปที่ตรงกันทุกประการจากรายละเอียด Plugin, ชื่อเซิร์ฟเวอร์ MCP ที่รู้จัก หรือเมทาดาทาที่เสถียรและไม่ซ้ำ ความเป็นเจ้าของที่อิงเฉพาะชื่อที่แสดงหรือมีความกำกวมจะถูกตัดออก จนกว่าการรีเฟรชรายการครั้งถัดไปจะพิสูจน์ความเป็นเจ้าของได้
แอปของบัญชีที่เชื่อมต่อ
เอเจนต์ที่เจ้าของเป็นผู้ดำเนินการสามารถเลือกใช้แอปทั้งหมดที่เชื่อมต่อกับบัญชี Codex อยู่แล้ว โดยไม่ต้องมีแพ็กเกจ Plugin ที่ตรงกัน:
{ plugins: { entries: { codex: { enabled: true, config: { codexPlugins: { enabled: true, allow_all_plugins: true, allow_destructive_actions: "auto", }, }, }, }, },}allow_all_plugins: true จะบันทึกสแนปช็อต app/list แบบครบถ้วนเมื่อสร้างเธรด Codex แบบเนทีฟใหม่ และอนุญาตเฉพาะแอปที่ทำเครื่องหมายว่าเข้าถึงได้สำหรับบัญชีนั้น โดยจะไม่ติดตั้ง ยืนยันตัวตน หรือเปิดใช้งานแอปแบบส่วนกลาง เธรดที่มีอยู่จะเก็บชุดแอปที่บันทึกไว้ ใช้ /new, /reset หรือรีสตาร์ต Gateway เพื่อรับแอปที่เพิ่งเชื่อมต่อหรือถูกเพิกถอน
แอปของบัญชีจะรับค่า codexPlugins.allow_destructive_actions ส่วนกลาง ซึ่งยอมรับ true, false, "auto" หรือ "ask" นโยบายต่อ Plugin ที่ระบุชัดเจนจะแทนที่นโยบายส่วนกลางสำหรับรหัสแอปที่ทับซ้อนกัน ความล้มเหลวของรายการจะปฏิเสธการเข้าถึงโดยค่าเริ่มต้น แทนที่จะย้อนกลับไปใช้ค่าเริ่มต้นที่ไม่จำกัด
การกำหนดค่าแอปของเธรด
OpenClaw แทรกแพตช์ config.apps ที่มีข้อจำกัดเข้มงวดสำหรับเธรด Codex:
ปิดใช้งาน _default และเปิดใช้งานเฉพาะแอปที่เป็นของ Plugin ที่กำหนดค่าและเปิดใช้งานไว้ หรือแอปของบัญชีที่เข้าถึงได้และได้รับอนุญาตจาก allow_all_plugins
ค่า destructive_enabled ของแต่ละแอปมาจากนโยบาย allow_destructive_actions ส่วนกลางหรือระดับ Plugin ที่มีผลบังคับใช้ โดย true, "auto" และ "ask" จะตั้งค่า destructive_enabled: true ส่วน false จะตั้งค่าเป็น false Codex ยังคงบังคับใช้ข้อมูลเมตาของเครื่องมือที่มีผลทำลายจากคำอธิบายประกอบเครื่องมือของแอปโดยตรง
ระบบปิดใช้งาน _default ด้วย open_world_enabled: false ส่วนแอปของ Plugin ที่เปิดใช้งานจะได้รับ open_world_enabled: true OpenClaw ไม่มีตัวเลือกนโยบายแบบเปิดกว้างแยกต่างหากในระดับ Plugin และไม่เก็บรายการปฏิเสธชื่อเครื่องมือที่มีผลทำลายแยกตาม Plugin
โหมดอนุมัติเครื่องมือมีค่าเริ่มต้นเป็นอัตโนมัติสำหรับแอปที่ได้รับอนุญาต ดังนั้นเครื่องมืออ่านที่ไม่มีผลทำลายจะทำงานโดยไม่แสดงข้อความขออนุมัติในเธรดเดียวกัน เครื่องมือที่มีผลทำลายยังคงอยู่ภายใต้การควบคุมของนโยบาย destructive_enabled ของแต่ละแอป
นโยบายการดำเนินการที่มีผลทำลาย
โดยค่าเริ่มต้น ระบบอนุญาตคำขอข้อมูลเพิ่มเติมที่มีผลทำลายจาก Plugin สำหรับ Plugin ของ Codex ที่กำหนดค่าไว้ แต่จะปฏิเสธโดยอัตโนมัติเมื่อสคีมาไม่ปลอดภัยหรือไม่สามารถระบุความเป็นเจ้าของได้อย่างชัดเจน:
allow_destructive_actionsส่วนกลางมีค่าเริ่มต้นเป็นtrueallow_destructive_actionsระดับ Plugin จะลบล้างนโยบายส่วนกลางสำหรับ Plugin นั้นfalse: OpenClaw ส่งคืนการปฏิเสธที่ให้ผลลัพธ์แน่นอนtrue: OpenClaw ยอมรับโดยอัตโนมัติเฉพาะสคีมาที่ปลอดภัยและสามารถแมปเป็นการตอบกลับการอนุมัติได้ เช่น ฟิลด์อนุมัติแบบบูลีน"auto": OpenClaw เปิดเผยการดำเนินการที่มีผลทำลายของ Plugin ให้ Codex จากนั้น แปลงคำขออนุมัติของ MCP ที่พิสูจน์ความเป็นเจ้าของได้เป็นการอนุมัติ Plugin ของ OpenClaw ก่อนส่งคืนการตอบกลับการอนุมัติของ Codex"ask": OpenClaw ใช้การควบคุมการเขียนและการดำเนินการที่มีผลทำลายของ Codex แบบเดียวกับ"auto"ล้างค่าลบล้างการอนุมัติรายเครื่องมือแบบถาวรของ Codex สำหรับแอป ก่อนเริ่มเธรด และเสนอเฉพาะการอนุมัติหรือปฏิเสธแบบครั้งเดียว เพื่อไม่ให้ การอนุมัติแบบถาวรระงับข้อความขออนุมัติการเขียนในภายหลัง สำหรับแต่ละ แอปที่ได้รับอนุญาตซึ่งใช้"ask"OpenClaw จะเลือกผู้ตรวจสอบการอนุมัติโดยมนุษย์ของ Codex สำหรับแอปนั้น เพื่อให้ Codex ส่งคำขออนุมัติมายัง OpenClaw ส่วนแอปอื่นและการอนุมัติในเธรดที่ไม่เกี่ยวกับแอปจะยังคงใช้ ผู้ตรวจสอบและนโยบายที่กำหนดค่าไว้- หากไม่มีข้อมูลระบุตัวตนของ Plugin ไม่สามารถระบุความเป็นเจ้าของได้อย่างชัดเจน ไม่มีรหัสรอบการทำงานหรือรหัสไม่ตรงกัน หรือสคีมาคำขอข้อมูลเพิ่มเติมไม่ปลอดภัย ระบบจะปฏิเสธแทนการแสดงข้อความขออนุมัติ
การแก้ไขปัญหา
| รหัส | ความหมาย | วิธีแก้ไข |
|---|---|---|
auth_required |
การย้ายข้อมูลติดตั้ง Plugin แล้ว แต่แอปใดแอปหนึ่งยังต้องยืนยันตัวตน รายการดังกล่าวจะถูกเขียนโดยปิดใช้งานไว้จนกว่าคุณจะให้สิทธิ์อีกครั้ง | ให้สิทธิ์แอปอีกครั้งใน Codex แล้วเปิดใช้งาน Plugin ใน OpenClaw |
app_inaccessible, app_disabled, app_missing |
เมื่อใช้ --verify-plugin-apps รายการแอป Codex ต้นทางไม่ได้แสดงว่าแอปทั้งหมดที่เป็นเจ้าของมีอยู่ เปิดใช้งาน และเข้าถึงได้ |
ให้สิทธิ์หรือเปิดใช้งานแอปใน Codex แล้วเรียกใช้การย้ายข้อมูลอีกครั้งด้วย --verify-plugin-apps |
app_inventory_unavailable |
มีการร้องขอให้ตรวจสอบแอปต้นทางอย่างเข้มงวด แต่การรีเฟรชรายการแอป Codex ต้นทางล้มเหลว | แก้ไขการเข้าถึงเซิร์ฟเวอร์แอป Codex ต้นทาง หรือลองอีกครั้งโดยไม่ใช้ --verify-plugin-apps เพื่อยอมรับแผนแบบตรวจสอบบัญชีที่รวดเร็วกว่า |
codex_subscription_required |
บัญชีเซิร์ฟเวอร์แอป Codex ต้นทางไม่ใช่บัญชีที่สมัครสมาชิก ChatGPT | เข้าสู่ระบบแอป Codex ด้วยการยืนยันตัวตนของสมาชิก แล้วเรียกใช้การย้ายข้อมูลอีกครั้ง |
codex_account_unavailable |
ไม่สามารถอ่านบัญชีเซิร์ฟเวอร์แอป Codex ต้นทางได้ | แก้ไขการยืนยันตัวตนของเซิร์ฟเวอร์แอป Codex ต้นทาง หรือเรียกใช้อีกครั้งด้วย --verify-plugin-apps เพื่อให้รายการแอปต้นทางเป็นตัวตัดสินคุณสมบัติ |
marketplace_missing, plugin_missing |
มาร์เก็ตเพลสหรือ Plugin ที่มีรหัสตรงกันทุกประการไม่พร้อมใช้งาน คำขอแค็ตตาล็อกพื้นที่ทำงานที่ระบุอย่างชัดเจนอาจถูกปฏิเสธ และแอปพื้นที่ทำงานจะถูกปฏิเสธโดยอัตโนมัติ | ตรวจสอบสัญญาของเซิร์ฟเวอร์แอปที่เข้ากันได้และรหัสที่ตรงกันทุกประการตามที่อธิบายด้านล่าง |
plugin_detail_unavailable |
OpenClaw ไม่สามารถอ่านรายละเอียดความเป็นเจ้าของ Plugin ได้ | ตรวจสอบการตอบกลับ plugin/list และ plugin/read ของเซิร์ฟเวอร์แอปเป้าหมาย |
plugin_disabled |
Codex รายงานว่า Plugin ติดตั้งแล้วแต่ถูกปิดใช้งาน | การเปิดใช้งานรายการที่คัดสรรไว้อาจแก้ไขได้ ให้เปิดใช้งาน Plugin พื้นที่ทำงานใน Codex ก่อนลองอีกครั้ง |
plugin_activation_failed |
การเปิดใช้งาน Plugin ไม่เสร็จสมบูรณ์ | ใช้ข้อมูลวินิจฉัยที่แนบมาเพื่อแยกแยะความล้มเหลวของมาร์เก็ตเพลส การยืนยันตัวตน การรีเฟรช หรือความพร้อมของพื้นที่ทำงาน |
app_inventory_missing, app_inventory_stale |
สถานะความพร้อมของแอปมาจากแคชที่ว่างเปล่าหรือล้าสมัย | OpenClaw กำหนดเวลารีเฟรชแบบอะซิงโครนัสโดยอัตโนมัติ โดยจะยังไม่รวมแอปของ Plugin จนกว่าจะทราบความเป็นเจ้าของและความพร้อม |
app_ownership_ambiguous |
รายการแอปตรงกันเฉพาะตามชื่อที่แสดง | แอปจะยังคงถูกซ่อนจากเธรด Codex จนกว่าการรีเฟรชในภายหลังจะพิสูจน์ความเป็นเจ้าของได้ |
ติดตั้ง Plugin พื้นที่ทำงานแล้วแต่ไม่ปรากฏ: ยืนยันว่าผลลัพธ์ plugin/list
ของพื้นที่ทำงานรายงานรหัสที่กำหนดค่าไว้อย่างตรงกันทุกประการว่าติดตั้งและเปิดใช้งานแล้ว
จากนั้นยืนยันว่า app/list รายงานว่าแอปทั้งหมดที่เป็นเจ้าของสามารถเข้าถึงได้ด้วยบัญชี Codex
เดียวกัน OpenClaw สามารถเปิดใช้งานแอปที่เข้าถึงได้สำหรับเธรด แม้ว่ารายการของ
บัญชีจะรายงานว่าแอปนั้นถูกปิดใช้งานอยู่ก็ตาม หากคุณเปลี่ยนสถานะดังกล่าวหลังจาก Gateway แคชรายการ
แอปแล้ว ให้รอการรีเฟรชแคชหนึ่งชั่วโมงหรือเริ่ม Gateway ใหม่ จากนั้นใช้
/new หรือ /reset OpenClaw จะไม่ซ่อมแซมหรือยืนยันตัวตนให้ Plugin พื้นที่ทำงาน
หากคำขอรายการพื้นที่ทำงานที่ระบุอย่างชัดเจนถูกปฏิเสธ รายการพื้นที่ทำงานที่เปิดใช้งานแต่ละรายการ
จะรายงาน marketplace_missing ส่วนรายการที่คัดสรรไว้อื่นซึ่งไม่เกี่ยวข้องจะดำเนินการต่อ
จากการตอบกลับรายการเริ่มต้น
สำหรับ plugin_detail_unavailable สรุปพื้นที่ทำงานที่ไม่มีพาธต้องมี
remotePluginId โดย OpenClaw จะซ่อนแอปที่เป็นเจ้าของไว้เมื่อไม่มีตัวเลือกดังกล่าวหรือ
ไม่มีผลลัพธ์ plugin/read ที่ตามมา สำหรับ
plugin_activation_failed Plugin ที่คัดสรรไว้อาจรายงานความล้มเหลวของมาร์เก็ตเพลส การยืนยันตัวตน หรือ
การรีเฟรชหลังการติดตั้ง Plugin พื้นที่ทำงานจะรายงานรหัสนี้เมื่อยังไม่ได้
เปิดใช้งาน ให้ติดตั้ง เปิดใช้งาน และยืนยันตัวตนนอก OpenClaw
เปลี่ยนการกำหนดค่าแล้วแต่เอเจนต์มองไม่เห็น Plugin: เรียกใช้ /codex plugins list เพื่อยืนยันสถานะที่กำหนดค่าไว้ จากนั้นใช้ /new หรือ /reset การผูกเธรด
Codex ที่มีอยู่จะคงการกำหนดค่าแอปที่ใช้เมื่อเริ่มต้นไว้ จนกว่า OpenClaw
จะสร้างเซสชันชุดควบคุมใหม่หรือแทนที่การผูกที่ล้าสมัย
การดำเนินการที่มีผลทำลายถูกปฏิเสธ: ตรวจสอบค่า allow_destructive_actions
ส่วนกลางและระดับ Plugin แม้ใช้ true, "auto" หรือ "ask"
สคีมาคำขอข้อมูลเพิ่มเติมที่ไม่ปลอดภัยและข้อมูลระบุตัวตนของ Plugin ที่กำกวมจะยังคงถูกปฏิเสธโดยอัตโนมัติ