---
read_when:
    - คุณต้องการให้เอเจนต์ OpenClaw ในโหมด Codex ใช้ Plugin ของ Codex แบบเนทีฟ
    - คุณกำลังย้าย Plugin Codex ที่คัดสรรโดย OpenAI ซึ่งติดตั้งจากซอร์ส
    - คุณกำลังแก้ไขปัญหา codexPlugins, คลังรายการแอป, การดำเนินการที่ทำลายข้อมูล หรือการวินิจฉัยแอป Plugin
summary: กำหนดค่า Plugin Codex แบบเนทีฟที่ย้ายมาแล้วสำหรับเอเจนต์ OpenClaw ในโหมด Codex
title: Plugin ของ Codex แบบเนทีฟ
x-i18n:
    generated_at: "2026-05-12T23:30:55Z"
    model: gpt-5.5
    provider: openai
    source_hash: ddec40cd5f9a74b43d55f327cdcd7088e024392fbafc7f1aa5bd9b136d3ecc13
    source_path: plugins/codex-native-plugins.md
    workflow: 16
---

การรองรับ Plugin ของ Codex แบบเนทีฟช่วยให้เอเจนต์ OpenClaw ในโหมด Codex สามารถใช้ความสามารถของแอปและ Plugin ของ Codex
app-server เองภายในเธรด Codex เดียวกันที่
จัดการเทิร์นของ OpenClaw

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

ใช้หน้านี้หลังจาก [Codex harness](/th/plugins/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 ต้นทาง:

```bash
openclaw migrate codex --dry-run
```

ใช้การตรวจสอบแอปต้นทางแบบเข้มงวดเมื่อคุณต้องการให้การย้ายข้อมูลตรวจสอบ
การเข้าถึงแอปต้นทางก่อนวางแผนเปิดใช้งาน Plugin แบบเนทีฟ:

```bash
openclaw migrate codex --dry-run --verify-plugin-apps
```

ใช้การย้ายข้อมูลเมื่อแผนดูถูกต้อง:

```bash
openclaw migrate apply codex --yes
```

การย้ายข้อมูลจะเขียนรายการ `codexPlugins` ที่ชัดเจนสำหรับ Plugin ที่มีสิทธิ์ และเรียก
Codex app-server `plugin/install` สำหรับ Plugin ที่เลือก การกำหนดค่าที่ถูกย้าย
โดยทั่วไปมีลักษณะดังนี้:

```json5
{
  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 ที่คลุมเครือยังคงล้มเหลวแบบปิด

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

- [Codex harness](/th/plugins/codex-harness)
- [ข้อมูลอ้างอิง Codex harness](/th/plugins/codex-harness-reference)
- [รันไทม์ Codex harness](/th/plugins/codex-harness-runtime)
- [ข้อมูลอ้างอิงการกำหนดค่า](/th/gateway/configuration-reference#codex-harness-plugin-config)
- [Migrate CLI](/th/cli/migrate)