Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

การรองรับ Plugin ของ Codex แบบเนทีฟช่วยให้เอเจนต์ OpenClaw ในโหมด Codex สามารถใช้ความสามารถของแอปและ Plugin ของ Codex app-server เองภายในเธรด Codex เดียวกันที่ จัดการเทิร์นของ OpenClaw OpenClaw ไม่แปล Plugin ของ Codex เป็นเครื่องมือไดนามิกของ OpenClaw แบบสังเคราะห์ codex_plugin_* การเรียก Plugin จะอยู่ในทรานสคริปต์ Codex แบบเนทีฟ และ Codex app-server เป็นเจ้าของการดำเนินการ MCP ที่มีแอปหนุนหลัง ใช้หน้านี้หลังจาก Codex harness พื้นฐานทำงานแล้ว

​
ข้อกำหนด

  • รันไทม์เอเจนต์ OpenClaw ที่เลือกต้องเป็น Codex harness แบบเนทีฟ
  • plugins.entries.codex.enabled ต้องเป็น true
  • plugins.entries.codex.config.codexPlugins.enabled ต้องเป็น true
  • V1 รองรับเฉพาะ Plugin openai-curated ที่การย้ายข้อมูลสังเกตเห็นว่า ติดตั้งจากซอร์สในหน้าแรก Codex ต้นทาง
  • Codex app-server เป้าหมายต้องสามารถมองเห็น Marketplace, Plugin และรายการแอปที่คาดไว้ได้
codexPlugins ไม่มีผลกับการรัน PI, การรันผู้ให้บริการ OpenAI ปกติ, การผูกการสนทนา ACP หรือ harness อื่น ๆ เพราะเส้นทางเหล่านั้นไม่ได้สร้าง เธรด Codex app-server พร้อมการกำหนดค่า apps แบบเนทีฟ

​
เริ่มต้นอย่างรวดเร็ว

ดูตัวอย่างการย้ายข้อมูลจากหน้าแรก Codex ต้นทาง: 
openclaw migrate codex --dry-run
ใช้การตรวจสอบแอปต้นทางแบบเข้มงวดเมื่อคุณต้องการให้การย้ายข้อมูลตรวจสอบ การเข้าถึงแอปต้นทางก่อนวางแผนเปิดใช้งาน Plugin แบบเนทีฟ: 
openclaw migrate codex --dry-run --verify-plugin-apps
ใช้การย้ายข้อมูลเมื่อแผนดูถูกต้อง: 
openclaw migrate apply codex --yes
การย้ายข้อมูลจะเขียนรายการ codexPlugins ที่ชัดเจนสำหรับ Plugin ที่มีสิทธิ์ และเรียก Codex app-server plugin/install สำหรับ 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",
              },
            },
          },
        },
      },
    },
  },
}
หลังจากเปลี่ยน codexPlugins ให้ใช้ /new, /reset หรือรีสตาร์ต Gateway เพื่อให้ เซสชัน Codex harness ในอนาคตเริ่มต้นด้วยชุดแอปที่อัปเดตแล้ว

​
วิธีการตั้งค่า Plugin แบบเนทีฟทำงาน

การผสานรวมมีสถานะแยกกันสามสถานะ:
  • ติดตั้งแล้ว: Codex มีบันเดิล Plugin ภายในเครื่องในรันไทม์ app-server เป้าหมาย
  • เปิดใช้งานแล้ว: การกำหนดค่า OpenClaw ยินยอมให้ Plugin พร้อมใช้งานสำหรับ เทิร์น Codex harness
  • เข้าถึงได้: Codex app-server ยืนยันว่ารายการแอปของ Plugin พร้อมใช้งาน สำหรับบัญชีที่ใช้งานอยู่ และสามารถแมปกับอัตลักษณ์ Plugin ที่ย้ายมาได้
การย้ายข้อมูลเป็นขั้นตอนการติดตั้ง/การมีสิทธิ์ที่คงทน ระหว่างการวางแผน OpenClaw อ่านรายละเอียด plugin/read ของ Codex ต้นทาง และตรวจสอบว่าการตอบกลับบัญชี Codex app-server ต้นทางเป็นบัญชีการสมัครสมาชิก ChatGPT การตอบกลับบัญชีที่ไม่ใช่ ChatGPT หรือ ขาดหายไปจะข้าม Plugin ที่มีแอปหนุนหลังด้วย codex_subscription_required ตามค่าเริ่มต้น การย้ายข้อมูลจะไม่เรียก app/list ต้นทาง; Plugin ต้นทางที่มีแอปหนุนหลังซึ่งผ่านด่านบัญชีจะถูกวางแผน โดยไม่มีการตรวจสอบการเข้าถึงแอปต้นทาง และความล้มเหลวของการขนส่งการค้นหาบัญชี จะถูกข้ามด้วย codex_account_unavailable เมื่อใช้ --verify-plugin-apps การย้ายข้อมูลจะถ่ายสแนปช็อต app/list ต้นทางใหม่ และกำหนดให้ทุกแอปที่เป็นเจ้าของ ต้องมีอยู่ เปิดใช้งาน และเข้าถึงได้ก่อนวางแผนเปิดใช้งานแบบเนทีฟ ใน โหมดนั้น ความล้มเหลวของการขนส่งการค้นหาบัญชีจะผ่านไปยังด่าน รายการแอปต้นทาง รายการแอปรันไทม์คือการตรวจสอบ การเข้าถึงของเซสชันเป้าหมายหลังการย้ายข้อมูล จากนั้นการตั้งค่าเซสชัน Codex harness จะคำนวณการกำหนดค่าแอปของเธรดแบบจำกัดสำหรับแอป Plugin ที่เปิดใช้งานและเข้าถึงได้ การกำหนดค่าแอปของเธรดจะถูกคำนวณเมื่อ OpenClaw สร้างเซสชัน Codex harness หรือแทนที่การผูกเธรด Codex ที่ล้าสมัย ระบบจะไม่คำนวณใหม่ในทุกเทิร์น

​
ขอบเขตการรองรับ V1

V1 ถูกตั้งใจให้มีขอบเขตแคบ:
  • เฉพาะ Plugin openai-curated ที่ติดตั้งอยู่แล้วในรายการ Codex app-server ต้นทางเท่านั้นที่มีสิทธิ์ย้ายข้อมูล
  • Plugin ต้นทางที่มีแอปหนุนหลังต้องผ่านด่านการสมัครสมาชิก ณ เวลาย้ายข้อมูล --verify-plugin-apps จะเพิ่มด่านรายการแอปต้นทาง บัญชีที่ถูกกั้นด้วยการสมัครสมาชิก รวมถึงในโหมดตรวจสอบ แอปต้นทางที่เข้าถึงไม่ได้ ปิดใช้งาน ขาดหายไป หรือความล้มเหลวในการรีเฟรชรายการแอปต้นทาง จะถูกรายงานเป็นรายการแบบแมนนวลที่ถูกข้าม แทนที่จะเป็นรายการการกำหนดค่าที่เปิดใช้งาน รายละเอียด Plugin ที่อ่านไม่ได้จะถูกข้าม ก่อนด่านรายการแอปต้นทาง
  • การย้ายข้อมูลจะเขียนอัตลักษณ์ Plugin ที่ชัดเจนด้วย marketplaceName และ pluginName; จะไม่เขียนเส้นทางแคช marketplacePath ภายในเครื่อง
  • codexPlugins.enabled คือสวิตช์เปิดใช้งานส่วนกลาง
  • ไม่มีไวลด์การ์ด plugins["*"] และไม่มีคีย์การกำหนดค่าที่ให้สิทธิ์ ติดตั้งตามอำเภอใจ
  • Marketplace ที่ไม่รองรับ, บันเดิล Plugin ที่แคชไว้, hooks และไฟล์การกำหนดค่า Codex จะถูกเก็บไว้ในรายงานการย้ายข้อมูลเพื่อการตรวจสอบแบบแมนนวล

​
รายการแอปและความเป็นเจ้าของ

OpenClaw อ่านรายการแอป Codex ผ่าน app/list ของ app-server, แคชไว้ หนึ่งชั่วโมง และรีเฟรชรายการที่ล้าสมัยหรือขาดหายไปแบบอะซิงโครนัส แคชนี้ อยู่ในหน่วยความจำเท่านั้น; การรีสตาร์ต CLI หรือ Gateway จะล้างแคช และ OpenClaw จะสร้างใหม่ จากการอ่าน app/list ครั้งถัดไป การย้ายข้อมูลและรันไทม์ใช้คีย์แคชแยกกัน:
  • การตรวจสอบการย้ายข้อมูลต้นทางใช้หน้าแรก Codex ต้นทางและตัวเลือกการเริ่ม app-server ต้นทาง สิ่งนี้ทำงานเฉพาะเมื่อมีการตั้งค่า --verify-plugin-apps และจะ บังคับการสำรวจ app/list ต้นทางใหม่สำหรับการวางแผนรันนั้น
  • การตั้งค่ารันไทม์เป้าหมายใช้อัตลักษณ์ Codex app-server ของเอเจนต์เป้าหมายเมื่อ สร้างการกำหนดค่าแอปของเธรด Codex การเปิดใช้งาน Plugin จะทำให้คีย์แคชเป้าหมายนั้น ใช้ไม่ได้ แล้วบังคับรีเฟรชหลังจาก plugin/install
แอป Plugin จะถูกเปิดเผยก็ต่อเมื่อ OpenClaw สามารถแมปกลับไปยัง Plugin ที่ย้ายมา ผ่านความเป็นเจ้าของที่เสถียร:
  • id แอปตรงจากรายละเอียด Plugin
  • ชื่อเซิร์ฟเวอร์ MCP ที่รู้จัก
  • เมตาดาต้าที่เสถียรและไม่ซ้ำกัน
ความเป็นเจ้าของที่ตรงกันเฉพาะชื่อที่แสดงหรือคลุมเครือจะถูกตัดออกจนกว่าการรีเฟรชรายการ ครั้งถัดไปจะพิสูจน์ความเป็นเจ้าของ

​
การกำหนดค่าแอปของเธรด

OpenClaw แทรกแพตช์ config.apps แบบจำกัดสำหรับเธรด Codex: _default ถูกปิดใช้งาน และเปิดใช้งานเฉพาะแอปที่เป็นของ Plugin ที่ย้ายมาและเปิดใช้งานแล้วเท่านั้น OpenClaw ตั้งค่า destructive_enabled ระดับแอปจากนโยบายส่วนกลางหรือ ต่อ Plugin ของ allow_destructive_actions ที่มีผล และให้ Codex บังคับใช้ เมตาดาต้าเครื่องมือแบบทำลายล้างจากคำอธิบายประกอบเครื่องมือแอปแบบเนทีฟ การกำหนดค่าแอป _default ถูกปิดใช้งานด้วย open_world_enabled: false แอป Plugin ที่เปิดใช้งาน จะถูกปล่อยออกมาพร้อม open_world_enabled: true; OpenClaw ไม่เปิดเผยปุ่มปรับ นโยบาย open-world ของ Plugin แยกต่างหาก และไม่ดูแลรายการปฏิเสธ ชื่อเครื่องมือแบบทำลายล้างต่อ Plugin โหมดการอนุมัติเครื่องมือเป็นอัตโนมัติตามค่าเริ่มต้นสำหรับแอป Plugin เพื่อให้เครื่องมืออ่าน ที่ไม่ทำลายล้างสามารถทำงานได้โดยไม่มี UI การอนุมัติในเธรดเดียวกัน เครื่องมือแบบทำลายล้างยังคง ถูกควบคุมโดยนโยบาย destructive_enabled ของแต่ละแอป

​
นโยบายการกระทำแบบทำลายล้าง

การ elicitation ของ Plugin แบบทำลายล้างได้รับอนุญาตตามค่าเริ่มต้นสำหรับ Plugin Codex ที่ย้ายมา ขณะที่สคีมาที่ไม่ปลอดภัยและความเป็นเจ้าของที่คลุมเครือยังคงล้มเหลวแบบปิด:
  • allow_destructive_actions ส่วนกลางมีค่าเริ่มต้นเป็น true
  • allow_destructive_actions ต่อ Plugin จะเขียนทับนโยบายส่วนกลางสำหรับ Plugin นั้น
  • เมื่อนโยบายเป็น false OpenClaw จะส่งคืนการปฏิเสธแบบกำหนดได้
  • เมื่อนโยบายเป็น true OpenClaw จะยอมรับอัตโนมัติเฉพาะสคีมาที่ปลอดภัยซึ่งสามารถแมปกับ การตอบกลับการอนุมัติได้ เช่น ฟิลด์อนุมัติแบบบูลีน
  • อัตลักษณ์ Plugin ที่ขาดหายไป, ความเป็นเจ้าของที่คลุมเครือ, id เทิร์นที่ขาดหายไป, id เทิร์นที่ผิด หรือสคีมา elicitation ที่ไม่ปลอดภัยจะปฏิเสธแทนการแจ้งถาม

​
การแก้ไขปัญหา

auth_required: การย้ายข้อมูลติดตั้ง Plugin แล้ว แต่หนึ่งในแอปของ Plugin นั้นยัง ต้องมีการยืนยันตัวตน รายการ Plugin ที่ชัดเจนจะถูกเขียนแบบปิดใช้งานจนกว่าคุณจะ ให้สิทธิ์ใหม่และเปิดใช้งาน app_inaccessible, app_disabled, หรือ app_missing: การย้ายข้อมูลไม่ได้ติดตั้ง Plugin เพราะรายการแอป Codex ต้นทางไม่ได้ แสดงว่าแอปที่เป็นเจ้าของทั้งหมดมีอยู่ เปิดใช้งาน และเข้าถึงได้ขณะ ตั้งค่า --verify-plugin-apps ให้ให้สิทธิ์ใหม่หรือเปิดใช้งานแอปใน Codex แล้ว รันการย้ายข้อมูลอีกครั้งด้วย --verify-plugin-apps app_inventory_unavailable: การย้ายข้อมูลไม่ได้ติดตั้ง Plugin เพราะ มีการขอการตรวจสอบแอปต้นทางแบบเข้มงวด และการรีเฟรชรายการแอป Codex ต้นทาง ล้มเหลว แก้ไขการเข้าถึง Codex app-server ต้นทาง หรือลองใหม่โดยไม่มี --verify-plugin-apps หากคุณยอมรับแผนที่เร็วกว่าและใช้ด่านบัญชี codex_subscription_required: การย้ายข้อมูลไม่ได้ติดตั้ง Plugin ที่มีแอปหนุนหลัง เพราะบัญชี Codex app-server ต้นทางไม่ได้เข้าสู่ระบบด้วยบัญชีการสมัครสมาชิก ChatGPT เข้าสู่ระบบแอป Codex ด้วยการยืนยันตัวตนแบบสมัครสมาชิก แล้วรันการย้ายข้อมูลอีกครั้ง codex_account_unavailable: การย้ายข้อมูลไม่ได้ติดตั้ง Plugin ที่มีแอปหนุนหลัง เพราะไม่สามารถอ่านบัญชี Codex app-server ต้นทางได้ แก้ไขการยืนยันตัวตน Codex app-server ต้นทาง หรือรันอีกครั้งด้วย --verify-plugin-apps หากคุณต้องการให้รายการแอปต้นทาง ตัดสินสิทธิ์เมื่อการค้นหาบัญชีล้มเหลว marketplace_missing หรือ plugin_missing: Codex app-server เป้าหมาย ไม่สามารถมองเห็น Marketplace หรือ Plugin openai-curated ที่คาดไว้ได้ รันการย้ายข้อมูลอีกครั้ง กับรันไทม์เป้าหมาย หรือตรวจสอบสถานะ Plugin ของ Codex app-server app_inventory_missing หรือ app_inventory_stale: ความพร้อมของแอปมาจาก แคชที่ว่างเปล่าหรือล้าสมัย OpenClaw จัดกำหนดการรีเฟรชแบบอะซิงโครนัสและตัดแอป Plugin ออกจนกว่าจะทราบความเป็นเจ้าของและความพร้อม app_ownership_ambiguous: รายการแอปตรงกันจากชื่อที่แสดงเท่านั้น ดังนั้น แอปจะไม่ถูกเปิดเผยต่อเธรด Codex การกำหนดค่าเปลี่ยนแล้วแต่เอเจนต์มองไม่เห็น Plugin: ใช้ /new, /reset หรือ รีสตาร์ต Gateway การผูกเธรด Codex ที่มีอยู่จะคงการกำหนดค่าแอปที่ เริ่มต้นไว้จนกว่า OpenClaw จะสร้างเซสชัน harness ใหม่หรือแทนที่ การผูกที่ล้าสมัย การกระทำแบบทำลายล้างถูกปฏิเสธ: ตรวจสอบค่า allow_destructive_actions ส่วนกลางและต่อ Plugin แม้นโยบายจะเป็น true สคีมา elicitation ที่ไม่ปลอดภัย และอัตลักษณ์ Plugin ที่คลุมเครือยังคงล้มเหลวแบบปิด

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