ฮาร์เนส Codex

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.

​

ข้อกำหนด

• OpenClaw ที่มี Plugin codex แบบ bundled พร้อมใช้งาน
• หาก config ของคุณใช้ plugins.allow ให้รวม codex
• Codex app-server 0.125.0 หรือใหม่กว่า Plugin ที่มาพร้อมแพ็กเกจจะจัดการ ไบนารี Codex app-server ที่เข้ากันได้โดยค่าเริ่มต้น ดังนั้นคำสั่ง codex ในเครื่องบน PATH จะไม่ส่งผลต่อการเริ่มต้น harness ตามปกติ
• Codex auth พร้อมใช้งานผ่าน openclaw models auth login --provider openai-codex, บัญชี app-server ใน Codex home ของเอเจนต์ หรือโปรไฟล์ Codex API-key auth แบบชัดเจน

​

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

openclaw models auth login --provider openai-codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

{
  plugins: {
    allow: ["codex"],
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

การกำหนดค่า

{
  auth: {
    order: {
      openai: ["openai-codex:user@example.com", "openai:api-key-backup"],
    },
  },
}

​

ตรวจสอบรันไทม์ Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

การ routing และการเลือกโมเดล

• ใช้ openai/gpt-* สำหรับเทิร์นเอเจนต์ OpenAI ผ่าน Codex
• อย่าใช้ openai-codex/gpt-* ใน config รัน openclaw doctor --fix เพื่อ ซ่อม refs แบบ legacy และ session route pins ที่ค้างอยู่
• agentRuntime.id: "codex" เป็นตัวเลือกสำหรับโหมด OpenAI อัตโนมัติทั่วไป แต่มีประโยชน์ เมื่อ deployment ควร fail closed หาก Codex ไม่พร้อมใช้งาน
• agentRuntime.id: "pi" เลือกให้ผู้ให้บริการหรือโมเดลใช้พฤติกรรม PI โดยตรงเมื่อ ตั้งใจให้เป็นเช่นนั้น
• /codex ... ควบคุมการสนทนา Codex app-server แบบ native จากแชท
• ACP/acpx เป็นเส้นทาง harness ภายนอกที่แยกต่างหาก ใช้เฉพาะเมื่อผู้ใช้ขอ ACP/acpx หรือ adapter harness ภายนอก

​

รูปแบบการ deploy

​

deployment Codex พื้นฐาน

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

​

deployment แบบผู้ให้บริการผสม

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-6",
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
      },
    ],
  },
}

​

deployment Codex แบบ fail-closed

{
  models: {
    providers: {
      openai: {
        agentRuntime: {
          id: "codex",
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

นโยบาย app-server

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            authToken: "${CODEX_APP_SERVER_TOKEN}",
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

​

คำสั่งและการวินิจฉัย

• /codex status ตรวจสอบการเชื่อมต่อ app-server, โมเดล, บัญชี, rate limits, เซิร์ฟเวอร์ MCP และ skills
• /codex models แสดงรายการโมเดล app-server ของ Codex ที่ใช้งานอยู่
• /codex threads [filter] แสดงรายการ thread app-server ของ Codex ล่าสุด
• /codex resume <thread-id> แนบเซสชัน OpenClaw ปัจจุบันเข้ากับ thread Codex ที่มีอยู่
• /codex compact ขอให้ app-server ของ Codex compact thread ที่แนบอยู่
• /codex review เริ่ม review แบบ native ของ Codex สำหรับ thread ที่แนบอยู่
• /codex diagnostics [note] ถามก่อนส่ง feedback ของ Codex สำหรับ thread ที่แนบอยู่
• /codex account แสดงสถานะบัญชีและ rate-limit
• /codex mcp แสดงรายการสถานะเซิร์ฟเวอร์ MCP ของ app-server Codex
• /codex skills แสดงรายการ skills ของ app-server Codex

​

ตรวจสอบ thread ของ Codex ในเครื่อง

codex resume <thread-id>

1. โปรไฟล์ auth ของ OpenAI ที่เรียงลำดับไว้สำหรับ agent โดยควรอยู่ใต้ auth.order.openai id โปรไฟล์ openai-codex:* ที่มีอยู่ยังคงใช้งานได้
2. บัญชีที่มีอยู่ของ app-server ใน Codex home ของ agent นั้น
3. สำหรับการเปิด app-server stdio ในเครื่องเท่านั้น CODEX_API_KEY จากนั้น OPENAI_API_KEY เมื่อไม่มีบัญชี app-server อยู่และยังต้องใช้ auth ของ OpenAI

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],
          },
        },
      },
    },
  },
}

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

​

Plugin native ของ Codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}

​

Computer Use

​

ขอบเขต runtime

• รองรับเครื่องมือแบบไดนามิกของ OpenClaw Codex ขอให้ OpenClaw execute เครื่องมือเหล่านั้น ดังนั้น OpenClaw จึงยังอยู่ในเส้นทางการ execute
• เครื่องมือ shell, patch, MCP, และ native app แบบ Codex-native เป็นของ Codex OpenClaw สามารถสังเกตหรือบล็อกเหตุการณ์ native บางรายการผ่าน relay ที่รองรับ แต่จะไม่เขียนอาร์กิวเมนต์ของเครื่องมือ native ใหม่
• Codex เป็นเจ้าของ Compaction native OpenClaw เก็บสำเนา transcript mirror สำหรับประวัติ channel, search, /new, /reset, และการสลับ model หรือ harness ในอนาคต
• การสร้างสื่อ, การทำความเข้าใจสื่อ, TTS, approvals, และเอาต์พุต messaging-tool ยังคงผ่านการตั้งค่า provider/model ของ OpenClaw ที่ตรงกัน
• tool_result_persist ใช้กับผลลัพธ์เครื่องมือ transcript ที่ OpenClaw เป็นเจ้าของ ไม่ใช่ record ผลลัพธ์เครื่องมือแบบ Codex-native

​

การแก้ปัญหา

​

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

• Codex harness reference
• Codex harness runtime
• Plugin native ของ Codex
• Codex Computer Use
• Agent runtimes
• Model providers
• OpenAI provider
• Agent harness plugins
• Plugin hooks
• Diagnostics export
• Status
• Testing