Runtime harness Codex

Halaman ini mendokumentasikan kontrak runtime untuk giliran harness Codex. Untuk penyiapan dan routing, mulai dengan harness Codex. Untuk kolom konfigurasi, lihat referensi harness Codex.

​

Gambaran umum

Mode Codex bukan OpenClaw dengan panggilan model berbeda di bawahnya. Codex memiliki lebih banyak bagian dari loop model native, dan OpenClaw menyesuaikan permukaan Plugin, alat, sesi, dan diagnostiknya di sekitar batas tersebut. OpenClaw tetap memiliki routing channel, file sesi, pengiriman pesan yang terlihat, alat dinamis OpenClaw, persetujuan, pengiriman media, dan cermin transkrip. Codex memiliki utas native kanonis, loop model native, kelanjutan alat native, dan Compaction native. Routing prompt mengikuti runtime yang dipilih, bukan hanya string penyedia. Sebuah giliran Codex native menerima instruksi developer app-server Codex, sementara rute kompatibilitas OpenClaw eksplisit mempertahankan prompt sistem OpenClaw normal meskipun menggunakan autentikasi atau transport OpenAI bercorak Codex. Codex native mempertahankan instruksi dasar/model milik Codex dan perilaku dokumen proyek sesuai konfigurasi utas Codex aktif. OpenClaw memulai dan melanjutkan utas Codex native dengan personality bawaan Codex dinonaktifkan agar file personality workspace dan identitas agen OpenClaw tetap menjadi otoritas. Eksekusi ringan OpenClaw tetap mempertahankan penekanan dokumen proyek yang sudah ada. Instruksi developer OpenClaw mencakup kepentingan runtime OpenClaw seperti pengiriman channel sumber, alat dinamis OpenClaw, delegasi ACP, konteks adapter, dan file profil workspace agen aktif. Katalog Skills OpenClaw dan pointer MEMORY.md yang dirutekan alat diproyeksikan sebagai instruksi developer kolaborasi berskup giliran untuk Codex native. Konten BOOTSTRAP.md aktif dan injeksi fallback MEMORY.md penuh tetap menggunakan konteks referensi input giliran.

​

Binding utas dan perubahan model

Ketika sesi OpenClaw dilampirkan ke utas Codex yang sudah ada, giliran berikutnya mengirim lagi model OpenAI, kebijakan persetujuan, sandbox, dan tingkat layanan yang saat ini dipilih ke app-server. Beralih dari openai/gpt-5.5 ke openai/gpt-5.2 mempertahankan binding utas tetapi meminta Codex untuk melanjutkan dengan model yang baru dipilih.

​

Balasan yang terlihat dan heartbeat

Ketika giliran chat langsung/sumber berjalan melalui harness Codex, balasan yang terlihat secara default dikirim otomatis sebagai final assistant untuk permukaan WebChat internal. Ini menjaga Codex tetap selaras dengan kontrak prompt harness Pi: agen membalas secara normal, dan OpenClaw memposting teks final ke percakapan sumber. Atur messages.visibleReplies: "message_tool" ketika chat langsung/sumber harus secara sengaja menjaga teks final assistant tetap privat kecuali agen memanggil message(action="send"). Giliran Heartbeat Codex juga mendapatkan heartbeat_respond di katalog alat OpenClaw yang dapat dicari secara default, sehingga agen dapat mencatat apakah wake harus tetap diam atau memberi notifikasi tanpa mengodekan alur kontrol itu dalam teks final. Panduan inisiatif khusus Heartbeat dikirim sebagai instruksi developer mode kolaborasi Codex pada giliran Heartbeat itu sendiri. Giliran chat biasa memulihkan mode Default Codex alih-alih membawa filosofi Heartbeat dalam prompt runtime normalnya. Ketika HEARTBEAT.md yang tidak kosong ada, instruksi mode kolaborasi Heartbeat mengarahkan Codex ke file tersebut alih-alih menyisipkan isinya secara inline.

​

Batas hook

Harness Codex memiliki tiga lapisan hook: OpenClaw tidak menggunakan file hooks.json Codex proyek atau global untuk merutekan perilaku Plugin OpenClaw. Untuk alat native dan bridge izin yang didukung, OpenClaw menyuntikkan konfigurasi Codex per utas untuk PreToolUse, PostToolUse, PermissionRequest, dan Stop. Ketika persetujuan app-server Codex diaktifkan, artinya approvalPolicy bukan "never", konfigurasi hook native default yang disuntikkan menghilangkan PermissionRequest sehingga reviewer app-server Codex dan bridge persetujuan OpenClaw menangani eskalasi nyata setelah review. Operator dapat secara eksplisit menambahkan permission_request ke nativeHookRelay.events ketika mereka memerlukan relay kompatibilitas. Hook Codex lain seperti SessionStart dan UserPromptSubmit tetap menjadi kontrol tingkat Codex. Keduanya tidak diekspos sebagai hook Plugin OpenClaw dalam kontrak v1. Untuk alat dinamis OpenClaw, OpenClaw mengeksekusi alat setelah Codex meminta panggilan, sehingga OpenClaw menjalankan perilaku Plugin dan middleware yang dimilikinya di adapter harness. Untuk alat native Codex, Codex memiliki catatan alat kanonis. OpenClaw dapat mencerminkan event tertentu, tetapi tidak dapat menulis ulang utas Codex native kecuali Codex mengekspos operasi tersebut melalui app-server atau callback hook native. Event PreToolUse mode laporan app-server Codex menunda permintaan persetujuan Plugin ke persetujuan app-server yang cocok. Jika hook OpenClaw before_tool_call mengembalikan requireApproval sementara payload native menetapkan mode persetujuan laporan (openclaw_approval_mode adalah "report"), relay hook native mencatat persyaratan persetujuan Plugin dan tidak mengembalikan keputusan native. Ketika Codex mengirim permintaan persetujuan app-server untuk penggunaan alat yang sama, OpenClaw membuka prompt persetujuan Plugin dan memetakan keputusan kembali ke Codex. Event PermissionRequest Codex adalah jalur persetujuan terpisah dan masih dapat dirutekan melalui persetujuan OpenClaw ketika runtime dikonfigurasi untuk bridge tersebut. Notifikasi item app-server Codex juga menyediakan observasi after_tool_call async untuk penyelesaian alat native yang belum tercakup oleh relay PostToolUse native. Observasi ini hanya untuk telemetri dan kompatibilitas Plugin; observasi tersebut tidak dapat memblokir, menunda, atau memutasi panggilan alat native. Proyeksi siklus hidup Compaction dan LLM berasal dari notifikasi app-server Codex dan status adapter OpenClaw, bukan perintah hook native Codex. Event before_compaction, after_compaction, llm_input, dan llm_output OpenClaw adalah observasi tingkat adapter, bukan tangkapan byte-per-byte dari permintaan internal atau payload Compaction Codex. Notifikasi app-server hook/started dan hook/completed native Codex diproyeksikan sebagai event agen codex_app_server.hook untuk trajectory dan debugging. Notifikasi tersebut tidak memanggil hook Plugin OpenClaw.

​

Kontrak dukungan V1

Didukung dalam runtime Codex v1: Tidak didukung di runtime Codex v1:

​

Izin bawaan dan elisitasi MCP

Untuk PermissionRequest, OpenClaw hanya mengembalikan keputusan izinkan atau tolak yang eksplisit ketika kebijakan memutuskan. Hasil tanpa keputusan bukanlah izin. Codex memperlakukannya sebagai tanpa keputusan hook dan meneruskannya ke jalur guardian atau persetujuan penggunanya sendiri. Mode persetujuan app-server Codex menghilangkan hook bawaan ini secara default. Perilaku ini berlaku ketika permission_request disertakan secara eksplisit dalam nativeHookRelay.events atau runtime kompatibilitas memasangnya. Ketika operator memilih allow-always untuk permintaan izin bawaan Codex, OpenClaw mengingat fingerprint provider/sesi/input alat/cwd yang tepat itu untuk jendela sesi terbatas. Keputusan yang diingat sengaja hanya cocok-persis: perintah, argumen, muatan alat, atau cwd yang berubah akan membuat persetujuan baru. Elisitasi persetujuan alat MCP Codex dirutekan melalui alur persetujuan plugin OpenClaw ketika Codex menandai _meta.codex_approval_kind sebagai "mcp_tool_call". Prompt request_user_input Codex dikirim kembali ke chat asal, dan pesan tindak lanjut berikutnya yang diantrekan menjawab permintaan server bawaan tersebut alih-alih diarahkan sebagai konteks tambahan. Permintaan elisitasi MCP lainnya gagal tertutup. Untuk alur persetujuan plugin umum yang membawa prompt ini, lihat Permintaan izin plugin.

​

Pengarahan antrean

Pengarahan antrean aktif-berjalan dipetakan ke turn/steer app-server Codex. Dengan default messages.queue.mode: "steer", OpenClaw menggabungkan pesan chat mode-steer untuk jendela hening yang dikonfigurasi dan mengirimkannya sebagai satu permintaan turn/steer sesuai urutan kedatangan. Tinjauan Codex dan giliran Compaction manual dapat menolak pengarah pada giliran yang sama. Dalam hal itu, OpenClaw menunggu proses aktif selesai sebelum memulai prompt. Gunakan /queue followup atau /queue collect ketika pesan seharusnya masuk antrean secara default alih-alih diarahkan. Lihat Antrean pengarah.

​

Unggahan umpan balik Codex

Ketika /diagnostics [note] disetujui untuk sesi yang menggunakan harness Codex native, OpenClaw juga memanggil feedback/upload app-server Codex untuk thread Codex yang relevan. Unggahan meminta app-server menyertakan log untuk setiap thread yang tercantum dan subthread Codex yang dibuat ketika tersedia. Unggahan melewati jalur umpan balik normal Codex ke server OpenAI. Jika umpan balik Codex dinonaktifkan di app-server tersebut, perintah mengembalikan galat app-server. Balasan diagnostik yang selesai mencantumkan channel, ID sesi OpenClaw, ID thread Codex, dan perintah lokal codex resume <thread-id> untuk thread yang dikirim. Jika Anda menolak atau mengabaikan persetujuan, OpenClaw tidak mencetak ID Codex tersebut dan tidak mengirim umpan balik Codex. Unggahan tidak menggantikan ekspor diagnostik Gateway lokal. Lihat Ekspor diagnostik untuk perilaku persetujuan, privasi, bundel lokal, dan obrolan grup. Gunakan /codex diagnostics [note] hanya ketika Anda secara khusus menginginkan unggahan umpan balik Codex untuk thread yang saat ini terlampir tanpa bundel diagnostik Gateway lengkap.

​

Compaction dan cermin transkrip

Ketika model yang dipilih menggunakan harness Codex, Compaction thread native menjadi milik app-server Codex. OpenClaw tidak menjalankan Compaction preflight untuk giliran Codex, tidak mengganti Compaction Codex dengan Compaction context-engine, dan tidak fallback ke peringkasan OpenClaw atau OpenAI publik ketika Compaction Codex native tidak dapat dimulai. OpenClaw menyimpan cermin transkrip untuk riwayat channel, pencarian, /new, /reset, dan peralihan model atau harness di masa mendatang. Permintaan Compaction eksplisit, seperti /compact atau operasi compact manual yang diminta Plugin, memulai Compaction Codex native dengan thread/compact/start. OpenClaw mempertahankan permintaan dan lease klien bersama tetap terbuka hingga Codex memancarkan item penyelesaian contextCompaction yang cocok, lalu melaporkan giliran Compaction sebagai selesai. Jika giliran terminal tersebut melebihi timeout Compaction yang dikonfigurasi, OpenClaw meminta interupsi giliran native. Lease dan fence Compaction per-thread tetap ditahan hingga Codex melaporkan status terminal atau mengonfirmasi RPC interupsi. Jika Codex tidak mengonfirmasi dalam periode tenggang interupsi, OpenClaw memensiunkan koneksi sebelum melepas fence. Koneksi jarak jauh juga melepas binding thread yang cocok sehingga pekerjaan berikutnya tidak dapat tumpang tindih dengan giliran jarak jauh yang belum dikonfirmasi. Giliran lain pada koneksi yang dipensiunkan gagal dan dapat dicoba ulang pada klien baru. Penutupan klien, pembatalan permintaan, atau giliran Compaction yang gagal mengembalikan operasi gagal. Ketika context engine meminta proyeksi bootstrap thread Codex, OpenClaw memproyeksikan nama dan ID panggilan alat, bentuk input, dan konten hasil alat yang telah disunting ke thread Codex baru. Ini tidak menyalin nilai argumen panggilan alat mentah ke dalam proyeksi tersebut. Cermin mencakup prompt pengguna, teks akhir asisten, dan catatan penalaran atau rencana Codex ringan ketika app-server memancarkannya. OpenClaw merekam awal Compaction native dan status terminal, tetapi tidak mengekspos ringkasan Compaction yang dapat dibaca manusia atau daftar yang dapat diaudit tentang entri mana yang dipertahankan Codex setelah Compaction. Karena Codex memiliki thread native kanonis, tool_result_persist saat ini tidak menulis ulang catatan hasil alat native Codex. Ini hanya berlaku ketika OpenClaw menulis hasil alat transkrip sesi milik OpenClaw.

​

Media dan pengiriman

OpenClaw tetap memiliki pengiriman media dan pemilihan penyedia media. Gambar, video, musik, PDF, TTS, dan pemahaman media menggunakan pengaturan penyedia/model yang sesuai seperti agents.defaults.imageGenerationModel, videoGenerationModel, pdfModel, dan messages.tts. Teks, gambar, video, musik, TTS, persetujuan, dan output alat pesan tetap melewati jalur pengiriman OpenClaw normal. Pembuatan media tidak memerlukan runtime legacy. Ketika Codex memancarkan item pembuatan gambar native dengan savedPath, OpenClaw meneruskan file persis tersebut melalui jalur media balasan normal meskipun giliran Codex tidak memiliki teks asisten.

​

Terkait

• Harness Codex
• Referensi harness Codex
• Plugin Codex native
• Hook Plugin
• Plugin harness agen
• Ekspor diagnostik
• Ekspor lintasan