Kerangka kerja Codex

Plugin codex bawaan memungkinkan OpenClaw menjalankan giliran agen OpenAI tertanam melalui app-server Codex, bukan harness PI bawaan. Gunakan harness Codex saat Anda ingin Codex memiliki sesi agen tingkat rendah: resume thread native, kelanjutan alat native, compaction native, dan eksekusi app-server. OpenClaw tetap memiliki channel chat, file sesi, pemilihan model, alat dinamis OpenClaw, persetujuan, pengiriman media, dan cermin transkrip yang terlihat. Setup normal menggunakan referensi model OpenAI kanonis seperti openai/gpt-5.5. Jangan mengonfigurasi referensi model openai-codex/gpt-*. Letakkan urutan auth agen OpenAI di bawah auth.order.openai; profil openai-codex:* lama dan entri auth.order.openai-codex tetap didukung untuk instalasi yang sudah ada. OpenClaw memulai thread app-server Codex dengan mode kode native Codex dan hanya-mode-kode diaktifkan. Itu menjaga alat dinamis OpenClaw yang ditunda/dapat dicari di dalam eksekusi kode dan permukaan pencarian-alat milik Codex sendiri, bukan menambahkan pembungkus pencarian-alat bergaya PI di atas Codex. Untuk pemisahan model/penyedia/runtime yang lebih luas, mulai dengan Runtime agen. Versi singkatnya adalah: openai/gpt-5.5 adalah referensi model, codex adalah runtime, dan Telegram, Discord, Slack, atau channel lain tetap menjadi permukaan komunikasi.

Persyaratan

OpenClaw dengan plugin codex bawaan tersedia.
Jika config Anda menggunakan plugins.allow, sertakan codex.
App-server Codex 0.125.0 atau lebih baru. Plugin bawaan mengelola biner app-server Codex yang kompatibel secara default, sehingga perintah codex lokal di PATH tidak memengaruhi startup harness normal.
Auth Codex tersedia melalui openclaw models auth login --provider openai-codex, akun app-server di home Codex agen, atau profil auth kunci API Codex eksplisit.

Untuk prioritas auth, isolasi environment, perintah app-server kustom, penemuan model, dan semua field config, lihat Referensi harness Codex.

Mulai cepat

Sebagian besar pengguna yang menginginkan Codex di OpenClaw menginginkan jalur ini: masuk dengan langganan ChatGPT/Codex, aktifkan plugin codex bawaan, dan gunakan referensi model openai/gpt-* kanonis. Masuk dengan OAuth Codex:

openclaw models auth login --provider openai-codex

Aktifkan plugin codex bawaan dan pilih model agen OpenAI:

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

Jika config Anda menggunakan plugins.allow, tambahkan codex di sana juga:

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

Restart gateway setelah mengubah config plugin. Jika chat yang sudah ada sudah memiliki sesi, gunakan /new atau /reset sebelum menguji perubahan runtime agar giliran berikutnya menyelesaikan harness dari config saat ini.

Konfigurasi

Config mulai cepat adalah config harness Codex minimum yang layak. Tetapkan opsi harness Codex di config OpenClaw, dan gunakan CLI hanya untuk auth Codex:

Kebutuhan	Tetapkan	Lokasi
Aktifkan harness	`plugins.entries.codex.enabled: true`	Config OpenClaw
Pertahankan instalasi plugin allowlist	Sertakan `codex` di `plugins.allow`	Config OpenClaw
Rutekan giliran agen OpenAI melalui Codex	`agents.defaults.model` atau `agents.list[].model` sebagai `openai/gpt-*`	Config agen OpenClaw
Masuk dengan OAuth Codex	`openclaw models auth login --provider openai-codex`	Profil auth CLI
Tambahkan cadangan kunci API untuk run Codex	Profil kunci API `openai:*` yang dicantumkan setelah auth langganan di `auth.order.openai`	Profil auth CLI + config OpenClaw
Gagal tertutup saat Codex tidak tersedia	`agentRuntime.id: "codex"` penyedia atau model	Config model/penyedia OpenClaw
Gunakan traffic API OpenAI langsung	`agentRuntime.id: "pi"` penyedia atau model dengan auth OpenAI normal	Config model/penyedia OpenClaw
Sesuaikan perilaku app-server	`plugins.entries.codex.config.appServer.*`	Config plugin Codex
Aktifkan aplikasi plugin Codex native	`plugins.entries.codex.config.codexPlugins.*`	Config plugin Codex
Aktifkan Codex Computer Use	`plugins.entries.codex.config.computerUse.*`	Config plugin Codex

Gunakan referensi model openai/gpt-* untuk giliran agen OpenAI yang didukung Codex. Utamakan auth.order.openai untuk urutan langganan-utama/cadangan-kunci-API. Profil auth openai-codex:* yang sudah ada dan auth.order.openai-codex tetap valid, tetapi jangan tulis referensi model openai-codex/gpt-* baru.

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

Dalam bentuk itu, kedua profil tetap berjalan melalui Codex untuk giliran agen openai/gpt-*. Kunci API hanya fallback auth, bukan permintaan untuk beralih ke PI atau OpenAI Responses biasa. Sisa halaman ini membahas varian umum yang harus dipilih pengguna: bentuk deployment, routing gagal-tertutup, kebijakan persetujuan guardian, plugin Codex native, dan Computer Use. Untuk daftar opsi lengkap, default, enum, penemuan, isolasi environment, timeout, dan field transport app-server, lihat Referensi harness Codex.

Verifikasi runtime Codex

Gunakan /status di chat tempat Anda mengharapkan Codex. Giliran agen OpenAI yang didukung Codex menampilkan:

Runtime: OpenAI Codex

Lalu periksa status app-server Codex:

/codex status
/codex models

/codex status melaporkan konektivitas app-server, akun, batas laju, server MCP, dan skills. /codex models mencantumkan katalog app-server Codex live untuk harness dan akun. Jika /status mengejutkan, lihat Pemecahan masalah.

Routing dan pemilihan model

Pisahkan referensi penyedia dan kebijakan runtime:

Gunakan openai/gpt-* untuk giliran agen OpenAI melalui Codex.
Jangan gunakan openai-codex/gpt-* di config. Jalankan openclaw doctor --fix untuk memperbaiki referensi legacy dan pin rute sesi yang basi.
agentRuntime.id: "codex" bersifat opsional untuk mode otomatis OpenAI normal, tetapi berguna saat deployment harus gagal tertutup jika Codex tidak tersedia.
agentRuntime.id: "pi" mengarahkan penyedia atau model ke perilaku PI langsung saat itu disengaja.
/codex ... mengontrol percakapan app-server Codex native dari chat.
ACP/acpx adalah jalur harness eksternal terpisah. Gunakan hanya saat pengguna meminta ACP/acpx atau adapter harness eksternal.

Routing perintah umum:

Niat pengguna	Gunakan
Lampirkan chat saat ini	`/codex bind [--cwd <path>]`
Resume thread Codex yang ada	`/codex resume <thread-id>`
Cantumkan atau filter thread Codex	`/codex threads [filter]`
Kirim feedback Codex saja	`/codex diagnostics [note]`
Mulai tugas ACP/acpx	Perintah sesi ACP/acpx, bukan `/codex`

Kasus penggunaan	Konfigurasi	Verifikasi	Catatan
Langganan ChatGPT/Codex dengan runtime Codex native	`openai/gpt-*` plus plugin `codex` aktif	`/status` menampilkan `Runtime: OpenAI Codex`	Jalur yang direkomendasikan
Gagal tertutup jika Codex tidak tersedia	`agentRuntime.id: "codex"` penyedia atau model	Giliran gagal alih-alih fallback PI	Gunakan untuk deployment khusus Codex
Traffic kunci API OpenAI langsung melalui PI	`agentRuntime.id: "pi"` penyedia atau model dan auth OpenAI normal	`/status` menampilkan runtime PI	Gunakan hanya saat PI disengaja
Config legacy	`openai-codex/gpt-*`	`openclaw doctor --fix` menulis ulangnya	Jangan tulis config baru dengan cara ini
Adapter Codex ACP/acpx	ACP `sessions_spawn({ runtime: "acp" })`	Status tugas/sesi ACP	Terpisah dari harness Codex native

agents.defaults.imageModel mengikuti pemisahan prefix yang sama. Gunakan openai/gpt-* untuk rute OpenAI normal dan codex/gpt-* hanya saat pemahaman gambar harus berjalan melalui giliran app-server Codex yang dibatasi. Jangan gunakan openai-codex/gpt-*; doctor menulis ulang prefix legacy itu menjadi openai/gpt-*.

Pola deployment

Deployment Codex dasar

Gunakan config mulai cepat saat semua giliran agen OpenAI harus menggunakan Codex secara default.

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

Deployment penyedia campuran

Bentuk ini mempertahankan Claude sebagai agen default dan menambahkan agen Codex bernama:

{
  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",
      },
    ],
  },
}

Dengan config ini, agen main menggunakan jalur penyedia normalnya dan agen codex menggunakan app-server Codex.

Deployment Codex gagal-tertutup

Untuk giliran agen OpenAI, openai/gpt-* sudah diselesaikan ke Codex saat plugin bawaan tersedia. Tambahkan kebijakan runtime eksplisit saat Anda menginginkan aturan gagal-tertutup tertulis:

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

Dengan Codex dipaksa, OpenClaw gagal lebih awal jika plugin Codex dinonaktifkan, jika app-server terlalu lama, atau jika app-server tidak dapat dimulai.

Kebijakan app-server

Secara default, plugin memulai biner Codex yang dikelola OpenClaw secara lokal dengan transport stdio. Tetapkan appServer.command hanya saat Anda sengaja ingin menjalankan executable yang berbeda. Gunakan transport WebSocket hanya saat app-server sudah berjalan di tempat lain:

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

Sesi app-server stdio lokal secara default menggunakan postur operator lokal tepercaya: approvalPolicy: "never", approvalsReviewer: "user", dan sandbox: "danger-full-access". Jika persyaratan Codex lokal tidak mengizinkan postur YOLO implisit itu, OpenClaw memilih izin guardian yang diizinkan sebagai gantinya. Saat sandbox OpenClaw aktif untuk sesi, OpenClaw mempersempit Codex danger-full-access menjadi Codex workspace-write agar giliran mode kode native Codex tetap berada di dalam ruang kerja yang disandbox. Gunakan mode guardian saat Anda menginginkan peninjauan otomatis native Codex sebelum keluar dari sandbox atau mendapatkan izin tambahan:

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

Mode guardian diperluas menjadi persetujuan app-server Codex, biasanya approvalPolicy: "on-request", approvalsReviewer: "auto_review", dan sandbox: "workspace-write" saat persyaratan lokal mengizinkan nilai-nilai tersebut. Untuk setiap field app-server, urutan auth, isolasi lingkungan, penemuan, dan perilaku timeout, lihat Referensi harness Codex.

Perintah dan diagnostik

Plugin bawaan mendaftarkan /codex sebagai perintah slash pada channel apa pun yang mendukung perintah teks OpenClaw. Bentuk umum:

/codex status memeriksa konektivitas app-server, model, akun, batas laju, server MCP, dan skills.
/codex models mencantumkan model app-server Codex live.
/codex threads [filter] mencantumkan thread app-server Codex terbaru.
/codex resume <thread-id> melampirkan sesi OpenClaw saat ini ke thread Codex yang sudah ada.
/codex compact meminta app-server Codex untuk memadatkan thread yang dilampirkan.
/codex review memulai peninjauan native Codex untuk thread yang dilampirkan.
/codex diagnostics [note] meminta konfirmasi sebelum mengirim umpan balik Codex untuk thread yang dilampirkan.
/codex account menampilkan status akun dan batas laju.
/codex mcp mencantumkan status server MCP app-server Codex.
/codex skills mencantumkan skills app-server Codex.

Untuk sebagian besar laporan dukungan, mulai dengan /diagnostics [note] dalam percakapan tempat bug terjadi. Perintah ini membuat satu laporan diagnostik Gateway dan, untuk sesi harness Codex, meminta persetujuan untuk mengirim bundel umpan balik Codex yang relevan. Lihat Ekspor diagnostik untuk model privasi dan perilaku chat grup. Gunakan /codex diagnostics [note] hanya saat Anda secara khusus menginginkan unggahan umpan balik Codex untuk thread yang saat ini dilampirkan tanpa bundel diagnostik Gateway lengkap.

Periksa thread Codex secara lokal

Cara tercepat untuk memeriksa proses Codex yang bermasalah sering kali adalah membuka thread native Codex secara langsung:

codex resume <thread-id>

Dapatkan id thread dari balasan /diagnostics yang selesai, /codex binding, atau /codex threads [filter]. Untuk mekanisme unggahan dan batas diagnostik tingkat runtime, lihat Runtime harness Codex. Auth dipilih dalam urutan ini:

Profil auth OpenAI yang diurutkan untuk agen, sebaiknya di bawah auth.order.openai. Id profil openai-codex:* yang ada tetap valid.
Akun app-server yang sudah ada di home Codex agen tersebut.
Hanya untuk peluncuran app-server stdio lokal, CODEX_API_KEY, lalu OPENAI_API_KEY, saat tidak ada akun app-server dan auth OpenAI masih diperlukan.

Saat OpenClaw melihat profil auth Codex bergaya langganan ChatGPT, OpenClaw menghapus CODEX_API_KEY dan OPENAI_API_KEY dari proses anak Codex yang diluncurkan. Hal itu membuat kunci API tingkat Gateway tetap tersedia untuk embeddings atau model OpenAI langsung tanpa secara tidak sengaja membuat giliran app-server native Codex ditagihkan melalui API. Profil kunci API Codex eksplisit dan fallback kunci env stdio lokal menggunakan login app-server alih-alih env proses anak yang diwarisi. Koneksi app-server WebSocket tidak menerima fallback kunci API env Gateway; gunakan profil auth eksplisit atau akun milik app-server jarak jauh. Jika profil langganan mencapai batas penggunaan Codex, OpenClaw mencatat waktu reset saat Codex melaporkannya dan mencoba profil auth terurut berikutnya untuk proses Codex yang sama. Saat waktu reset berlalu, profil langganan kembali memenuhi syarat tanpa mengubah model openai/gpt-* atau runtime Codex yang dipilih. Jika deployment membutuhkan isolasi lingkungan tambahan, tambahkan variabel tersebut ke appServer.clearEnv:

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

appServer.clearEnv hanya memengaruhi proses anak app-server Codex yang diluncurkan. Tool dinamis Codex secara default menggunakan pemuatan searchable. OpenClaw tidak mengekspos tool dinamis yang menduplikasi operasi ruang kerja native Codex: read, write, edit, apply_patch, exec, process, dan update_plan. Tool integrasi OpenClaw lainnya seperti messaging, sessions, media, cron, browser, nodes, gateway, heartbeat_respond, dan web_search tersedia melalui pencarian tool Codex di bawah namespace openclaw, sehingga konteks model awal tetap lebih kecil. sessions_yield dan balasan sumber khusus message-tool tetap langsung karena keduanya merupakan kontrak kontrol giliran. Instruksi kolaborasi Heartbeat memberi tahu Codex untuk mencari heartbeat_respond sebelum mengakhiri giliran heartbeat saat tool belum dimuat. Atur codexDynamicToolsLoading: "direct" hanya saat menghubungkan ke app-server Codex kustom yang tidak dapat mencari tool dinamis tertunda atau saat men-debug payload tool lengkap. Field Plugin Codex tingkat atas yang didukung:

Field	Default	Arti
`codexDynamicToolsLoading`	`"searchable"`	Gunakan `"direct"` untuk menempatkan tool dinamis OpenClaw langsung dalam konteks tool Codex awal.
`codexDynamicToolsExclude`	`[]`	Nama tool dinamis OpenClaw tambahan yang akan dihilangkan dari giliran app-server Codex.
`codexPlugins`	dinonaktifkan	Dukungan Plugin/app native Codex untuk plugin kurasi yang diinstal dari source dan telah dimigrasikan.

Field appServer yang didukung:

Field	Default	Arti
`transport`	`"stdio"`	`"stdio"` meluncurkan Codex; `"websocket"` terhubung ke `url`.
`command`	binary Codex terkelola	Executable untuk transport stdio. Biarkan tidak disetel untuk menggunakan binary terkelola; setel hanya untuk override eksplisit.
`args`	`["app-server", "--listen", "stdio://"]`	Argumen untuk transport stdio.
`url`	tidak disetel	URL app-server WebSocket.
`authToken`	tidak disetel	Token bearer untuk transport WebSocket.
`headers`	`{}`	Header WebSocket tambahan.
`clearEnv`	`[]`	Nama variabel lingkungan tambahan yang dihapus dari proses app-server stdio yang diluncurkan setelah OpenClaw membangun lingkungan warisannya. `CODEX_HOME` dan `HOME` dicadangkan untuk isolasi Codex per agen milik OpenClaw pada peluncuran lokal.
`requestTimeoutMs`	`60000`	Timeout untuk panggilan control-plane app-server.
`turnCompletionIdleTimeoutMs`	`60000`	Jendela senyap setelah permintaan app-server Codex yang dibatasi giliran saat OpenClaw menunggu `turn/completed`. Naikkan ini untuk fase sintesis pasca-tool atau hanya status yang lambat.
`mode`	`"yolo"` kecuali persyaratan Codex lokal tidak mengizinkan YOLO	Preset untuk eksekusi YOLO atau yang ditinjau guardian. Persyaratan stdio lokal yang menghilangkan `danger-full-access`, persetujuan `never`, atau reviewer `user` menjadikan default implisit sebagai guardian.
`approvalPolicy`	`"never"` atau kebijakan persetujuan guardian yang diizinkan	Kebijakan persetujuan native Codex yang dikirim ke mulai/lanjutkan/giliran thread. Default guardian lebih memilih `"on-request"` saat diizinkan.
`sandbox`	`"danger-full-access"` atau sandbox guardian yang diizinkan	Mode sandbox native Codex yang dikirim ke mulai/lanjutkan thread. Default guardian lebih memilih `"workspace-write"` saat diizinkan, jika tidak `"read-only"`. Saat sandbox OpenClaw aktif, `danger-full-access` dipersempit menjadi `"workspace-write"`.
`approvalsReviewer`	`"user"` atau reviewer guardian yang diizinkan	Gunakan `"auto_review"` agar Codex meninjau prompt persetujuan native saat diizinkan, jika tidak `guardian_subagent` atau `user`. `guardian_subagent` tetap menjadi alias lama.
`serviceTier`	tidak disetel	Tier layanan app-server Codex opsional. `"priority"` mengaktifkan routing fast-mode, `"flex"` meminta pemrosesan flex, `null` menghapus override, dan `"fast"` lama diterima sebagai `"priority"`.

Panggilan alat dinamis milik OpenClaw dibatasi secara independen dari appServer.requestTimeoutMs: permintaan item/tool/call Codex menggunakan watchdog OpenClaw 30 detik secara default. Argumen timeoutMs positif per panggilan memperpanjang atau mempersingkat anggaran alat spesifik tersebut. Alat image_generate juga menggunakan agents.defaults.imageGenerationModel.timeoutMs ketika panggilan alat tidak menyediakan timeout sendiri, dan alat image untuk pemahaman media menggunakan tools.media.image.timeoutSeconds atau default media 60 detiknya. Anggaran alat dinamis dibatasi hingga 600000 ms. Saat timeout, OpenClaw membatalkan sinyal alat jika didukung dan mengembalikan respons alat dinamis yang gagal ke Codex agar giliran dapat berlanjut alih-alih membiarkan sesi berada dalam processing. Setelah OpenClaw merespons permintaan server aplikasi bercakupan giliran dari Codex, harness juga mengharapkan Codex menyelesaikan giliran native dengan turn/completed. Jika server aplikasi tidak aktif selama appServer.turnCompletionIdleTimeoutMs setelah respons tersebut, OpenClaw sebisa mungkin menginterupsi giliran Codex, mencatat timeout diagnostik, dan melepaskan jalur sesi OpenClaw agar pesan chat lanjutan tidak mengantre di belakang giliran native yang basi. Notifikasi non-terminal apa pun untuk giliran yang sama, termasuk rawResponseItem/completed, menonaktifkan watchdog singkat tersebut karena Codex telah membuktikan giliran masih hidup; watchdog terminal yang lebih panjang tetap melindungi giliran yang benar-benar macet. Notifikasi server aplikasi global, seperti pembaruan batas laju, tidak mengatur ulang kemajuan idle giliran. Ketika Codex memancarkan item agentMessage yang selesai lalu tidak aktif tanpa turn/completed, OpenClaw memperlakukan keluaran asisten sebagai secara efektif selesai, sebisa mungkin menginterupsi giliran Codex native, dan melepaskan jalur sesi. Diagnostik timeout mencakup metode notifikasi server aplikasi terakhir dan, untuk item respons asisten mentah, jenis item, peran, id, serta pratinjau teks asisten yang dibatasi. Override lingkungan tetap tersedia untuk pengujian lokal:

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

OPENCLAW_CODEX_APP_SERVER_BIN melewati biner terkelola ketika appServer.command tidak disetel. OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1 telah dihapus. Gunakan plugins.entries.codex.config.appServer.mode: "guardian" sebagai gantinya, atau OPENCLAW_CODEX_APP_SERVER_MODE=guardian untuk pengujian lokal sekali pakai. Config lebih disarankan untuk deployment yang dapat diulang karena menjaga perilaku Plugin dalam file tertinjau yang sama dengan sisa setup harness Codex.

Plugin Codex native

Dukungan Plugin Codex native menggunakan kapabilitas aplikasi dan Plugin milik server aplikasi Codex sendiri dalam thread Codex yang sama dengan giliran harness OpenClaw. OpenClaw tidak menerjemahkan Plugin Codex menjadi alat dinamis OpenClaw codex_plugin_* sintetis. codexPlugins hanya memengaruhi sesi yang memilih harness Codex native. Ini tidak berpengaruh pada proses PI, proses penyedia OpenAI normal, binding percakapan ACP, atau harness lain. Config migrasi minimal:

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

Config aplikasi thread dihitung ketika OpenClaw membuat sesi harness Codex atau mengganti binding thread Codex yang basi. Ini tidak dihitung ulang pada setiap giliran. Setelah mengubah codexPlugins, gunakan /new, /reset, atau mulai ulang gateway agar sesi harness Codex berikutnya dimulai dengan set aplikasi yang diperbarui. Untuk kelayakan migrasi, inventaris aplikasi, kebijakan tindakan destruktif, elisitasi, dan diagnostik Plugin native, lihat Plugin Codex native.

Penggunaan Komputer

Penggunaan Komputer dibahas dalam panduan setup tersendiri: Penggunaan Komputer Codex. Versi singkatnya: OpenClaw tidak menyertakan aplikasi kontrol desktop sebagai vendor atau menjalankan tindakan desktop sendiri. OpenClaw menyiapkan server aplikasi Codex, memverifikasi bahwa server MCP computer-use tersedia, lalu membiarkan Codex memiliki panggilan alat MCP native selama giliran mode Codex.

Batas runtime

Harness Codex hanya mengubah eksekutor agen tertanam tingkat rendah.

Alat dinamis OpenClaw didukung. Codex meminta OpenClaw menjalankan alat tersebut, sehingga OpenClaw tetap berada di jalur eksekusi.
Alat shell, patch, MCP, dan aplikasi native milik Codex dimiliki oleh Codex. OpenClaw dapat mengamati atau memblokir peristiwa native tertentu melalui relay yang didukung, tetapi tidak menulis ulang argumen alat native.
Codex memiliki Compaction native. OpenClaw menyimpan cermin transkrip untuk riwayat channel, pencarian, /new, /reset, dan perpindahan model atau harness di masa mendatang.
Pembuatan media, pemahaman media, TTS, persetujuan, dan keluaran alat pesan terus melalui pengaturan penyedia/model OpenClaw yang sesuai.
tool_result_persist berlaku untuk hasil alat transkrip milik OpenClaw, bukan catatan hasil alat native Codex.

Untuk lapisan hook, permukaan V1 yang didukung, penanganan izin native, pengarah antrean, mekanisme unggah umpan balik Codex, dan detail Compaction, lihat Runtime harness Codex.

Pemecahan masalah

Codex tidak muncul sebagai penyedia /model normal: itu sudah sesuai untuk config baru. Pilih model openai/gpt-*, aktifkan plugins.entries.codex.enabled, dan periksa apakah plugins.allow mengecualikan codex. OpenClaw menggunakan PI alih-alih Codex: pastikan referensi model adalah openai/gpt-* pada penyedia OpenAI resmi dan Plugin Codex terpasang serta diaktifkan. Jika Anda memerlukan bukti ketat saat pengujian, setel provider atau model agentRuntime.id: "codex". Runtime Codex yang dipaksa akan gagal alih-alih fallback ke PI. Config lama openai-codex/* tetap ada: jalankan openclaw doctor --fix. Doctor menulis ulang referensi model lama ke openai/*, menghapus pin runtime sesi dan seluruh agen yang basi, serta mempertahankan override profil auth yang ada. Server aplikasi ditolak: gunakan server aplikasi Codex 0.125.0 atau yang lebih baru. Prerelease versi sama atau versi dengan suffix build seperti 0.125.0-alpha.2 atau 0.125.0+custom ditolak karena OpenClaw menguji batas bawah protokol stabil 0.125.0. /codex status tidak dapat terhubung: periksa bahwa Plugin codex bawaan diaktifkan, bahwa plugins.allow menyertakannya ketika allowlist dikonfigurasi, dan bahwa appServer.command, url, authToken, atau header kustom valid. Penemuan model lambat: turunkan plugins.entries.codex.config.discovery.timeoutMs atau nonaktifkan penemuan. Lihat Referensi harness Codex. Transport WebSocket langsung gagal: periksa appServer.url, authToken, header, dan bahwa server aplikasi remote berbicara dengan versi protokol server aplikasi Codex yang sama. Model non-Codex menggunakan PI: itu sudah sesuai kecuali kebijakan runtime penyedia atau model mengarahkannya ke harness lain. Referensi penyedia non-OpenAI biasa tetap berada pada jalur penyedia normalnya dalam mode auto. Penggunaan Komputer terpasang tetapi alat tidak berjalan: periksa /codex computer-use status dari sesi baru. Jika alat melaporkan Native hook relay unavailable, gunakan /new atau /reset; jika tetap terjadi, mulai ulang gateway untuk membersihkan registrasi hook native yang basi. Lihat Penggunaan Komputer Codex.

Documentation Index

​Persyaratan

​Mulai cepat

​Konfigurasi

​Verifikasi runtime Codex

​Routing dan pemilihan model

​Pola deployment

​Deployment Codex dasar

​Deployment penyedia campuran

​Deployment Codex gagal-tertutup

​Kebijakan app-server

​Perintah dan diagnostik

​Periksa thread Codex secara lokal

​Plugin Codex native

​Penggunaan Komputer

​Batas runtime

​Pemecahan masalah

​Terkait