Referensi harness Codex

Referensi ini mencakup konfigurasi terperinci untuk plugin resmi codex. Untuk keputusan penyiapan dan perutean, mulailah dengan harness Codex.

Permukaan konfigurasi Plugin

Semua pengaturan harness Codex berada di bawah plugins.entries.codex.config.

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          discovery: {            enabled: true,            timeoutMs: 2500,          },          appServer: {            mode: "guardian",          },        },      },    },  },}

Kolom tingkat atas:

Supervisi

Supervisi mencantumkan sesi Codex yang tidak diarsipkan dari komputer Gateway dan Node berpasangan yang telah ikut serta. Aktifkan secara terpisah dari harness agen:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          supervision: {            enabled: true,          },        },      },    },  },}

Kolom supervision:

Entri titik akhir menerima kolom berikut:

Halaman Sesi Codex menggunakan App Server supervisi milik plugin dan hanya menampilkan sesi yang tidak diarsipkan. Tanpa pengaturan koneksi appServer secara eksplisit, koneksi tersebut berupa stdio direktori rumah pengguna yang terkelola. Baris lokal yang tersimpan atau tidak aktif dapat membuat Chat yang terkunci pada model dengan riwayat pengguna dan asisten terbatas hingga giliran sumber persisten terminal terakhir. Pengikatan privatnya mempertahankan fork snapshot, cabang sumber appServer kanonis, injeksi riwayat, dan giliran berikutnya pada koneksi tersebut. Awal kanonis pertama menggunakan pasangan yang dikembalikan oleh fork. Pelanjutan berikutnya tidak menyertakan penggantian model dan penyedia OpenClaw agar Codex memulihkan pasangan persisten utas kanonis; perubahan native terpisah dapat memperbarui pasangan tersebut, tetapi model luar dan rantai fallback tidak pernah menggantikannya. Baris yang tersimpan dan tidak aktif dapat diarsipkan setelah konfirmasi bahwa tidak ada pelaksana lain, kecuali pengikatan OpenClaw aktif lain memiliki target yang sama persis atau salah satu turunan yang dibuatnya dan belum diarsipkan. OpenClaw mengikuti paginasi turunan Codex dan secara tertutup menggagalkan operasi jika terjadi kesalahan enumerasi, siklus, atau batas keselamatan habis. Konfirmasi tetap mencakup klien native yang tidak dikenal dan kondisi balapan antara status dan pengarsipan. Chat terkunci pada model yang disupervisi tidak dapat dihapus selama melindungi pengikatan native. Sumber aktif tidak dapat membuat cabang atau diarsipkan, tetapi Chat tersupervisi yang sudah ada tetap dapat dibuka. Setiap baris Node berpasangan tetap hanya-baca; transportasi Node belum menyediakan siklus hidup streaming yang diperlukan oleh harness.

appServer.homeScope: "user" saja mengubah direktori rumah Codex yang digunakan proses harness terkelola; pengaturan ini tidak memublikasikan katalog armada. Mengaktifkan supervisi tidak mengubah bawaan harness. Sebagai gantinya, koneksi supervisi terpisah secara bawaan menggunakan stdio direktori rumah pengguna terkelola saat tidak ada pengaturan koneksi appServer eksplisit. Pengaturan eksplisit dipatuhi untuk koneksi tersebut. Pengikatan tersupervisi yang tertunda dan sudah diterapkan mempertahankan koneksi tersebut untuk setiap giliran; supervisi yang dinonaktifkan atau penyimpangan koneksi/siklus hidup akan gagal secara tertutup alih-alih beralih ke harness direktori rumah agen. Koneksi bawaan berbagi sesi tersimpan dengan klien native Codex, bukan status aktivitas lokal prosesnya.

Pengaturan lama plugins.entries.codex-supervisor telah dihentikan. Jalankan openclaw doctor --fix untuk memigrasikan entri lama, definisi titik akhir, flag kebijakan, dan referensi izinkan/tolak plugin ke blok ini. Nilai kanonis eksplisit codex.config.supervision akan diutamakan jika terjadi konflik.

Transportasi app-server

Untuk giliran harness biasa, OpenClaw memulai biner Codex terkelola yang disertakan bersama plugin resmi (saat ini @openai/codex 0.144.1):

codex app-server --listen stdio://

Hal ini menjaga versi app-server tetap terikat dengan plugin resmi codex, bukan dengan CLI Codex terpisah yang kebetulan terinstal secara lokal. Tetapkan appServer.command hanya jika Anda memang sengaja ingin menggunakan berkas eksekutabel yang berbeda. Giliran terkelola biasa dengan direktori rumah agen terisolasi bawaan lebih memilih paket yang disematkan ini, bahkan ketika bundel desktop macOS terinstal. Ketika Computer Use diaktifkan, atau ketika homeScope bernilai "user" dan dapat memuat status Computer Use native, proses mulai terkelola akan lebih memilih biner aplikasi desktop yang memiliki izin macOS yang diperlukan. Aturan yang sama untuk memprioritaskan desktop berlaku ketika konfigurasi Codex efektif milik direktori rumah agen terisolasi mengaktifkan Computer Use native. Jika tidak ada bundel aplikasi desktop yang terinstal, OpenClaw beralih ke biner paket yang disematkan.

Penyerahan berkas eksekutabel dan pemagaran konfigurasi native mengoordinasikan klien dalam satu proses Gateway yang berjalan. Mulai ulang Gateway setelah proses lain mengubah konfigurasi plugin native Codex.

Supervisi menetapkan koneksi terpisah. Tanpa pengaturan koneksi appServer eksplisit, supervisi menggunakan stdio terkelola dengan homeScope: "user"; harness biasa tetap menggunakan stdio terkelola dengan homeScope: "agent". Pengaturan koneksi eksplisit dipatuhi oleh kedua jalur. Tetapkan homeScope: "user" secara eksplisit ketika harness biasa harus berbagi $CODEX_HOME (atau ~/.codex) dengan klien native. Pengikatan tersupervisi privat menggunakan koneksi supervisi terlepas dari bawaan harness biasa. Proses App Server independen mempertahankan status langsung dan status persetujuan yang terpisah.

Untuk app-server yang sudah berjalan, gunakan transportasi WebSocket:

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

Kolom appServer:

appServer.networkProxy bersifat eksplisit karena mengubah kontrak sandbox Codex. Saat diaktifkan, OpenClaw juga menetapkan features.network_proxy.enabled dan default_permissions dalam konfigurasi utas Codex agar profil izin yang dihasilkan dapat memulai jaringan yang dikelola Codex. Secara bawaan, OpenClaw menghasilkan nama profil openclaw-network-<fingerprint> yang tahan benturan dari isi profil; gunakan profileName hanya ketika nama lokal yang stabil diperlukan.

export default {  plugins: {    entries: {      codex: {        config: {          appServer: {            sandbox: "workspace-write",            networkProxy: {              enabled: true,              domains: {                "api.openai.com": "allow",                "blocked.example.com": "deny",              },              allowUpstreamProxy: true,              proxyUrl: "http://127.0.0.1:3128",            },          },        },      },    },  },};

Jika runtime app-server normal akan menggunakan danger-full-access, mengaktifkan networkProxy akan menggunakan akses sistem berkas bergaya ruang kerja untuk profil izin yang dihasilkan. Penegakan jaringan yang dikelola Codex menggunakan jaringan dalam sandbox, sehingga profil akses penuh tidak akan melindungi lalu lintas keluar.

Plugin memblokir handshake app-server lama atau tanpa versi: app-server Codex harus melaporkan versi stabil 0.143.0 atau yang lebih baru.

OpenClaw memperlakukan URL app-server WebSocket non-loopback sebagai remote dan mewajibkan autentikasi WebSocket yang memuat identitas melalui appServer.authToken atau header Authorization. appServer.authToken dan setiap nilai appServer.headers.* dapat berupa SecretInput; runtime rahasia menyelesaikan SecretRef dan bentuk singkat variabel lingkungan sebelum OpenClaw membuat opsi awal app-server, dan SecretRef terstruktur yang tidak terselesaikan akan gagal sebelum token atau header apa pun dikirim. Ketika plugin native Codex dikonfigurasi, OpenClaw menggunakan bidang kontrol plugin app-server yang terhubung untuk memasang atau memperbarui plugin tersebut, lalu memperbarui inventaris aplikasi agar aplikasi milik plugin terlihat oleh utas Codex. app/list tetap menjadi sumber inventaris dan metadata yang otoritatif, tetapi kebijakan OpenClaw menentukan apakah thread/start mengirim config.apps[appId].enabled = true untuk aplikasi terdaftar yang dapat diakses meskipun Codex saat ini menandainya sebagai dinonaktifkan. ID aplikasi yang tidak dikenal atau tidak ada tetap gagal secara tertutup; jalur ini hanya mengaktifkan plugin lokapasar melalui plugin/install dan memperbarui inventaris. Hubungkan OpenClaw hanya ke app-server remote yang dipercaya untuk menerima pemasangan plugin yang dikelola OpenClaw dan pembaruan inventaris aplikasi.

Mode persetujuan dan sandbox

Sesi app-server stdio lokal secara default menggunakan mode YOLO: approvalPolicy: "never", approvalsReviewer: "user", dan sandbox: "danger-full-access". Postur operator lokal tepercaya ini memungkinkan giliran OpenClaw tanpa pengawasan dan heartbeat tetap berjalan tanpa permintaan persetujuan native yang tidak dapat dijawab karena tidak ada orang yang tersedia.

Jika berkas persyaratan sistem lokal Codex melarang nilai persetujuan YOLO, peninjau, atau sandbox implisit, OpenClaw akan memperlakukan default implisit sebagai guardian dan memilih izin guardian yang diizinkan. tools.exec.mode: "auto" juga memaksa persetujuan Codex yang ditinjau guardian dan tidak mempertahankan penggantian lama yang tidak aman berupa approvalPolicy: "never" atau sandbox: "danger-full-access"; tetapkan tools.exec.mode: "full" untuk postur tanpa persetujuan yang disengaja. Entri [[remote_sandbox_config]] yang mencocokkan nama host dalam berkas persyaratan yang sama dipatuhi dalam keputusan default sandbox.

Tetapkan appServer.mode: "guardian" untuk persetujuan Codex yang ditinjau guardian:

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

Preset guardian diperluas menjadi approvalPolicy: "on-request", approvalsReviewer: "auto_review", dan sandbox: "workspace-write" ketika nilai-nilai tersebut diizinkan. Setiap bidang kebijakan dapat menggantikan mode. Nilai peninjau lama guardian_subagent masih diterima sebagai alias kompatibilitas, tetapi konfigurasi baru sebaiknya menggunakan auto_review.

Ketika sandbox OpenClaw aktif, proses app-server Codex lokal tetap berjalan pada host Gateway. Karena itu, OpenClaw menonaktifkan Code Mode native Codex, server MCP pengguna, dan eksekusi Plugin yang didukung aplikasi untuk giliran tersebut, alih-alih menganggap sandbox sisi host Codex setara dengan backend sandbox OpenClaw. Akses shell diekspos melalui alat dinamis yang didukung sandbox OpenClaw, seperti sandbox_exec dan sandbox_process, ketika alat exec/proses normal tersedia.

Eksekusi native dalam sandbox

Default stabilnya adalah gagal secara tertutup: sandbox OpenClaw yang aktif menonaktifkan permukaan eksekusi native Codex yang jika tidak dinonaktifkan akan berjalan dari host app-server Codex. Gunakan appServer.experimental.sandboxExecServer: true hanya jika Anda ingin mencoba dukungan lingkungan remote Codex dengan backend sandbox OpenClaw. Jalur pratinjau ini bekerja dengan setiap versi app-server Codex yang didukung.

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            experimental: {              sandboxExecServer: true,            },          },        },      },    },  },}

Ketika tanda tersebut aktif dan sesi OpenClaw saat ini berada dalam sandbox, OpenClaw memulai exec-server local loopback yang didukung sandbox aktif, mendaftarkannya ke app-server Codex, lalu memulai utas dan giliran Codex dengan lingkungan milik OpenClaw tersebut. Jika app-server tidak dapat mendaftarkan lingkungan, proses akan gagal secara tertutup, bukan diam-diam kembali ke eksekusi host.

Jalur pratinjau ini hanya untuk penggunaan lokal. App-server WebSocket remote tidak dapat menjangkau exec-server loopback kecuali berjalan pada host yang sama, sehingga OpenClaw menolak kombinasi tersebut.

Autentikasi dan isolasi lingkungan

Dalam direktori beranda per agen default, autentikasi dipilih dengan urutan berikut:

1. Profil autentikasi Codex OpenClaw yang eksplisit untuk agen.
2. Akun app-server yang sudah ada dalam direktori beranda Codex agen tersebut.
3. Hanya untuk peluncuran app-server stdio lokal, CODEX_API_KEY, lalu OPENAI_API_KEY, ketika tidak ada akun app-server dan autentikasi OpenAI masih diperlukan.

Ketika OpenClaw melihat profil autentikasi Codex bergaya langganan ChatGPT (jenis kredensial OAuth atau token), OpenClaw menghapus CODEX_API_KEY dan OPENAI_API_KEY dari proses turunan Codex yang dijalankan. Hal ini menjaga kunci API tingkat Gateway tetap tersedia untuk embedding atau model OpenAI langsung tanpa secara tidak sengaja menagihkan giliran app-server native Codex melalui API.

Profil kunci API Codex eksplisit dan fallback kunci lingkungan stdio lokal menggunakan login app-server, bukan lingkungan proses turunan yang diwariskan. Koneksi app-server WebSocket tidak menerima fallback kunci API lingkungan Gateway; gunakan profil autentikasi eksplisit atau akun milik app-server remote.

Peluncuran app-server stdio secara default mewarisi lingkungan proses OpenClaw. OpenClaw memiliki jembatan akun app-server Codex dan menetapkan CODEX_HOME ke direktori per agen di bawah status OpenClaw agen tersebut. Ini menjaga konfigurasi, akun, tembolok/data plugin, dan status utas Codex tetap terbatas pada agen OpenClaw, alih-alih bocor dari direktori beranda ~/.codex pribadi milik operator.

Tetapkan appServer.homeScope: "user" untuk berbagi status native Codex dengan Codex Desktop dan CLI. Mode direktori beranda pengguna lokal ini mendukung stdio terkelola dan transport Unix eksplisit. Mode ini menggunakan $CODEX_HOME jika ditetapkan dan ~/.codex jika tidak, termasuk autentikasi native, konfigurasi, plugin, dan utas. OpenClaw melewati jembatan profil autentikasinya untuk app-server. Giliran pemilik terverifikasi dapat menggunakan codex_threads untuk mencantumkan (dengan filter search opsional), membaca, membuat fork, mengganti nama, mengarsipkan, dan membatalkan pengarsipan utas tersebut. Buat fork utas sebelum melanjutkannya di OpenClaw; proses Codex independen tidak mengoordinasikan penulis serentak untuk utas yang sama.

Pilihan eksplisit homeScope tersebut berlaku untuk sesi harness biasa. Chat yang dibuat melalui Codex Sessions menggunakan koneksi supervisi privatnya, yang mempertahankan konfigurasi autentikasi dan penyedia koneksi native untuk cabang kanonis dan pelanjutan mendatang.

Dalam Chat dengan model terkunci yang disupervisi, codex_threads tidak dapat melampirkan fork lain atau mengarsipkan utas native yang terikat ke Chat. Pencantuman dan pembacaan metadata saja tetap tersedia. Pembacaan transkrip mentah memerlukan allowRawTranscripts; ketika dinonaktifkan, pencarian daftar juga ditolak karena pencarian native dapat mencocokkan pratinjau transkrip. Mengganti nama, membatalkan pengarsipan, membuat fork terpisah, dan mengarsipkan utas yang tidak terkait serta tidak dimiliki Chat OpenClaw lain memerlukan allowWriteControls. Tidak satu pun opsi tersebut dapat melewati pengikatan yang terkunci.

OpenClaw tidak menulis ulang HOME untuk peluncuran app-server lokal normal. Subproses yang dijalankan Codex seperti openclaw, gh, git, CLI cloud, dan perintah shell melihat direktori beranda proses normal dan dapat menemukan konfigurasi serta token di direktori beranda pengguna. Codex juga dapat menemukan $HOME/.agents/skills dan $HOME/.agents/plugins/marketplace.json; penemuan .agents tersebut sengaja dibagikan dengan direktori beranda operator dan terpisah dari status ~/.codex yang terisolasi.

Dalam cakupan agen default, Plugin OpenClaw dan snapshot Skills OpenClaw tetap mengalir melalui registri Plugin dan pemuat Skills milik OpenClaw sendiri; aset pribadi Codex ~/.codex tidak ikut mengalir. Jika Anda memiliki Skills atau plugin CLI Codex yang berguna dari direktori beranda Codex dan ingin menjadikannya bagian dari agen OpenClaw yang terisolasi, inventarisasikan secara eksplisit:

openclaw migrate codex --dry-runopenclaw migrate apply codex --yes

Jika deployment memerlukan 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 turunan app-server Codex yang dijalankan. OpenClaw menghapus CODEX_HOME dan HOME dari daftar ini selama normalisasi peluncuran lokal: CODEX_HOME tetap diarahkan ke cakupan agen atau pengguna yang dipilih, dan HOME tetap diwariskan agar subproses dapat menggunakan status direktori beranda pengguna normal.

Alat dinamis

Alat dinamis Codex secara default menggunakan pemuatan searchable, diekspos di bawah namespace openclaw dengan deferLoading: true. OpenClaw tidak mengekspos alat dinamis yang menduplikasi operasi ruang kerja native Codex atau permukaan pencarian alat milik Codex sendiri:

• read
• write
• edit
• apply_patch
• exec
• process
• update_plan
• tool_call
• tool_describe
• tool_search
• tool_search_code

Sebagian besar alat integrasi OpenClaw yang tersisa, seperti perpesanan, media, cron, peramban, node, gateway, heartbeat_respond, dan web_search, tersedia melalui pencarian alat Codex dalam namespace tersebut. Hal ini menjaga konteks model awal tetap lebih kecil. Sejumlah kecil alat tetap dapat dipanggil secara langsung terlepas dari codexDynamicToolsLoading, karena pencarian alat Codex mungkin tidak tersedia atau hanya menghasilkan himpunan konektor: agents_list, sessions_spawn, dan sessions_yield. Instruksi pengembang tetap mengarahkan subagen Codex normal ke spawn_agent native untuk pekerjaan subagen native Codex, sedangkan sessions_spawn tetap tersedia untuk delegasi OpenClaw atau ACP yang eksplisit. Balasan sumber yang hanya menggunakan alat pesan juga tetap langsung karena itu merupakan kontrak kontrol giliran.

Alat yang ditandai catalogMode: "direct-only", termasuk alat computer OpenClaw, dikelompokkan di bawah openclaw_direct. OpenClaw menambahkan namespace tersebut ke daftar code_mode.direct_only_tool_namespaces Codex tanpa mengganti entri yang disediakan operator. Karena itu, Codex mengekspos alat tersebut sebagai DirectModelOnly dalam utas normal dan utas khusus mode kode, alih-alih merutekannya melalui panggilan tools.* Code Mode bertingkat. Batas ini diperlukan untuk hasil yang memuat gambar: serialisasi Code Mode bertingkat meratakan keluaran gambar menjadi teks, yang akan membuang tangkapan layar yang diperlukan untuk tindakan komputer berikutnya.

Tetapkan codexDynamicToolsLoading: "direct" hanya saat menghubungkan ke app-server Codex khusus yang tidak dapat mencari alat dinamis tertunda atau saat men-debug payload alat lengkap.

Batas waktu

Pemanggilan alat dinamis milik OpenClaw dibatasi secara independen dari appServer.requestTimeoutMs. Setiap permintaan Codex item/tool/call menggunakan batas waktu pertama yang tersedia dalam urutan berikut:

• Argumen timeoutMs per pemanggilan yang bernilai positif.
• Untuk image_generate, agents.defaults.imageGenerationModel.timeoutMs.
• Untuk image_generate tanpa batas waktu yang dikonfigurasi, nilai bawaan pembuatan gambar sebesar 120 detik.
• Untuk alat image pemahaman media, tools.media.image.timeoutSeconds dikonversi menjadi milidetik, atau nilai bawaan media sebesar 60 detik. Untuk pemahaman gambar, ini berlaku pada permintaan itu sendiri dan tidak dikurangi oleh pekerjaan persiapan sebelumnya.
• Untuk alat message, nilai bawaan tetap sebesar 120 detik.
• Nilai bawaan alat dinamis sebesar 90 detik.

Pengawas ini merupakan anggaran terluar item/tool/call dinamis. Batas waktu permintaan khusus penyedia berjalan di dalam pemanggilan tersebut dan tetap mempertahankan semantik batas waktunya sendiri. Anggaran alat dinamis dibatasi hingga 600000 md. Saat batas waktu tercapai, OpenClaw membatalkan sinyal alat jika didukung dan mengembalikan respons alat dinamis yang gagal kepada Codex agar giliran dapat dilanjutkan, alih-alih membiarkan sesi tetap dalam status processing.

Setelah Codex menerima suatu giliran, dan setelah OpenClaw merespons permintaan server aplikasi yang cakupannya terbatas pada giliran, harness mengharapkan Codex membuat kemajuan pada giliran saat ini dan pada akhirnya menyelesaikan giliran native dengan turn/completed. Jika server aplikasi tidak memberikan aktivitas selama appServer.turnCompletionIdleTimeoutMs, OpenClaw sebisa mungkin menginterupsi giliran Codex, mencatat batas waktu diagnostik, dan membebaskan jalur sesi OpenClaw agar pesan obrolan lanjutan tidak mengantre di belakang giliran native yang sudah usang.

Sebagian besar notifikasi nonterminal untuk giliran yang sama menonaktifkan pengawas singkat tersebut karena Codex telah membuktikan bahwa giliran masih aktif. Penyerahan alat menggunakan anggaran tidak aktif pasca-alat yang lebih panjang: setelah OpenClaw mengembalikan respons item/tool/call, setelah item alat native seperti commandExecution selesai, setelah penyelesaian mentah custom_tool_call_output, serta setelah kemajuan mentah asisten pasca-alat, penyelesaian penalaran mentah, atau kemajuan penalaran. Pelindung menggunakan appServer.postToolRawAssistantCompletionIdleTimeoutMs jika dikonfigurasi dan jika tidak, nilai bawaannya adalah lima menit. Anggaran pasca-alat yang sama juga memperpanjang pengawas kemajuan untuk jendela sintesis senyap sebelum Codex memancarkan peristiwa berikutnya pada giliran saat ini. Penyelesaian penalaran, penyelesaian agentMessage komentar, serta penalaran mentah pra-alat atau kemajuan asisten dapat diikuti oleh balasan akhir otomatis, sehingga semuanya menggunakan pelindung balasan pasca-kemajuan alih-alih langsung membebaskan jalur sesi. Hanya item agentMessage akhir/nonkomentar yang selesai dan penyelesaian mentah asisten pra-alat yang mengaktifkan pelepasan keluaran asisten: jika Codex kemudian tidak memberikan aktivitas tanpa turn/completed, OpenClaw sebisa mungkin menginterupsi giliran native dan membebaskan jalur sesi. Kegagalan server aplikasi stdio yang aman untuk diputar ulang, termasuk batas waktu tidak aktif penyelesaian giliran tanpa bukti asisten, alat, item aktif, atau efek samping, dicoba ulang satu kali melalui percobaan server aplikasi baru. Batas waktu yang tidak aman tetap menghentikan klien server aplikasi yang macet dan membebaskan jalur sesi OpenClaw. Batas waktu tersebut juga menghapus pengikatan utas native yang sudah usang, alih-alih memutarnya ulang secara otomatis. Batas waktu pengawasan penyelesaian menampilkan teks batas waktu khusus Codex: kasus yang aman untuk diputar ulang menyatakan bahwa respons mungkin tidak lengkap, sedangkan kasus yang tidak aman meminta pengguna memverifikasi keadaan saat ini sebelum mencoba lagi. Diagnostik batas waktu publik menyertakan bidang struktural seperti metode notifikasi server aplikasi terakhir, id/jenis/peran item respons mentah asisten, jumlah permintaan/item aktif, dan status pengawasan yang aktif. Jika notifikasi terakhir merupakan item respons mentah asisten, diagnostik juga menyertakan pratinjau teks asisten yang dibatasi. Diagnostik tersebut tidak menyertakan isi mentah prompt atau alat.

Penemuan model

Secara bawaan, Plugin Codex meminta model yang tersedia kepada server aplikasi. Ketersediaan model dikelola oleh server aplikasi Codex, sehingga daftar dapat berubah saat OpenClaw meningkatkan versi bawaan @openai/codex atau saat suatu deployment mengarahkan appServer.command ke biner Codex yang berbeda. Ketersediaan juga dapat dibatasi berdasarkan akun. Gunakan /codex models pada Gateway yang sedang berjalan untuk melihat katalog langsung bagi harness dan akun tersebut.

Jika penemuan gagal atau mencapai batas waktu, OpenClaw menggunakan katalog cadangan bawaan:

Sesuaikan penemuan melalui plugins.entries.codex.config.discovery:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          discovery: {            enabled: true,            timeoutMs: 2500,          },        },      },    },  },}

Nonaktifkan penemuan jika Anda ingin proses awal menghindari pemeriksaan Codex dan hanya menggunakan katalog cadangan:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          discovery: {            enabled: false,          },        },      },    },  },}

Berkas bootstrap ruang kerja

Codex menangani AGENTS.md sendiri melalui penemuan dokumen proyek native. OpenClaw tidak menulis berkas dokumen proyek Codex sintetis atau bergantung pada nama berkas cadangan Codex untuk berkas persona, karena cadangan Codex hanya berlaku jika AGENTS.md tidak tersedia.

Untuk kesetaraan ruang kerja OpenClaw, harness Codex meneruskan berkas bootstrap lainnya sebagai instruksi pengembang, tetapi tidak secara identik:

• TOOLS.md diteruskan sebagai instruksi pengembang Codex yang diwarisi, sehingga subagen Codex native yang dibuat selama giliran juga dapat melihatnya.
• SOUL.md, IDENTITY.md, dan USER.md diteruskan sebagai instruksi kolaborasi bercakupan giliran. Subagen Codex native tidak mewarisinya, sehingga giliran subagen tidak mengambil persona agen induk dan profil pengguna.
• Daftar ringkas Skills OpenClaw yang dimuat juga diteruskan sebagai instruksi pengembang kolaborasi bercakupan giliran, sehingga subagen Codex native juga tidak mewarisinya.
• Isi HEARTBEAT.md tidak disuntikkan; giliran Heartbeat mendapatkan penunjuk mode kolaborasi untuk membaca berkas tersebut jika tersedia dan tidak kosong.
• Isi MEMORY.md dari ruang kerja agen yang dikonfigurasi tidak ditempelkan ke masukan giliran Codex native jika alat memori tersedia untuk ruang kerja tersebut; jika berkas tersedia, harness menambahkan penunjuk memori ruang kerja kecil ke instruksi pengembang kolaborasi bercakupan giliran dan Codex harus menggunakan memory_search atau memory_get jika memori persisten relevan. Jika alat dinonaktifkan, pencarian memori tidak tersedia, atau ruang kerja aktif berbeda dari ruang kerja memori agen, MEMORY.md menggunakan jalur konteks giliran terbatas yang normal.
• BOOTSTRAP.md, jika tersedia, diteruskan sebagai konteks referensi masukan giliran OpenClaw.

Penimpaan lingkungan

Penimpaan 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 jika appServer.command tidak ditetapkan.

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 satu kali. Konfigurasi lebih disarankan untuk deployment yang dapat diulang karena menjaga perilaku Plugin dalam berkas yang ditinjau yang sama dengan seluruh penyiapan harness Codex lainnya.

Terkait

• Harness Codex
• Runtime harness Codex
• Supervisi Codex
• Plugin Codex native
• Penggunaan Komputer Codex
• Penyedia OpenAI
• Referensi konfigurasi