Harness OpenClaw Codex: sesi, kredensial, dan penagihan

Harness Codex OpenClaw adalah plugin @openclaw/codex resmi: plugin ini menyerahkan giliran agen OpenClaw ke app-server Codex milik OpenAI sehingga Codex mengelola loop model, pelanjutan thread, kelanjutan alat, dan kompaksi. Ini bukan produk pendelegasian coding, bukan lapisan penagihan, dan — bagian yang paling sering membingungkan penyiapan — bukan cara untuk menjalankan Codex terhadap endpoint API pihak ketiga. Mana yang sebenarnya Anda perlukan adalah keputusan yang perlu dibuat halaman ini.

Tanggal terlebih dahulu, agar tidak ada yang tidak bertanggal di sini. Paket npm openclaw berada pada 2026.9.5 dan memerlukan Node >=24.16.0 <25 || >=26.1.0; @openclaw/codex berada pada 2026.9.5, diterbitkan pada 18 September 2026. Keduanya dibaca dari registry pada 21 September 2026. Tiga proyek yang tidak berkaitan berbagi nama-nama ini, dan tidak satu pun nomornya relevan di sini: pjasicek/OpenClaw menyebut dirinya sebagai implementasi ulang platformer tahun 1997 Captain Claw, paket npm tanpa scope codex adalah "generator situs statis dan dokumentasi kode" yang terakhir diterbitkan pada 2012, dan CLI OpenAI adalah @openai/codex (0.155.1 pada tanggal yang sama).

Lima permukaan OpenClaw menggunakan nama "Codex"

Dokumentasi agent-runtimes OpenClaw menyebutnya "sengaja independen". Memilih yang keliru adalah alasan paling umum mengapa konfigurasi tampak benar tetapi tidak melakukan apa-apa.

Nama keenam sama sekali bukan milik OpenClaw. openclaw-code-agent adalah plugin pihak ketiga yang menjalankan sesi coding di latar belakang dengan persetujuan rencana dan isolasi worktree; README-nya sendiri menyatakan bahwa plugin tersebut terpisah dari plugin runtime acpx bawaan OpenClaw dan plugin core codex bawaan. Jika Anda datang ke sini untuk pendelegasian, bukan pertukaran runtime, itu adalah produk berbeda dengan kunci konfigurasi berbeda.

Mengaktifkan harness, dan membuktikan bahwa harness aktif

Jalur yang didokumentasikan terdiri dari dua perintah — plugin, lalu login.

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

Kemudian konfigurasi minimum. Jika Anda menggunakan daftar plugins.allow, tambahkan "codex" ke dalamnya juga.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      // The docs' own example ref. Legacy codex-cli/* refs are
      // repaired to the same openai/<model> route by doctor --fix.
      model: "openai/gpt-6-astra",
    },
  },
}

Dua detail yang dinyatakan secara eksplisit oleh dokumentasi harness. Perubahan konfigurasi plugin diterapkan otomatis dalam mode pemuatan ulang hybrid, tetapi chat yang sudah ada memerlukan /new atau /reset terlebih dahulu agar giliran berikutnya menyelesaikan harness dari konfigurasi terkini. Dan profil alat yang efektif harus mengizinkan kemampuan shell native dan sistem berkas: coding dan full mengizinkannya, sedangkan messaging dan minimal menonaktifkan permukaan native. Sandbox OpenClaw biasa atau kebijakan alat terbatas merupakan pembatasan yang lebih sempit dalam dokumentasi yang sama — ini menonaktifkan mode kode native kecuali Anda memilih jalur sandbox exec-server eksperimental — dan ketika sandbox menonaktifkan permukaan native, perintah shell yang diizinkan tetap dapat diakses melalui sandbox_exec.

Persyaratan versi, diperiksa pada 21 September 2026 terhadap referensi transport app-server: plugin mengelola Codex app-server stabil 0.154.0, sedangkan executable kustom eksplisit, app-server jarak jauh, dan biner desktop macOS harus melaporkan versi semantik yang dapat diurai, yaitu 0.149.0 atau yang lebih baru. Versi terbaru npm @openai/codex adalah 0.155.1 pada hari yang sama, sehingga pin terkelola tertinggal satu patch — itulah sebabnya tutorial apa pun yang menyebut "Codex terbaru" tanpa tanggal menjadi usang dalam hitungan hari. Migrasi penyiapan lama juga penting: halaman agent-runtimes menyatakan bahwa backend Codex CLI bawaan OpenClaw dihapus pada v2026.5.14, dan ref legacy codex-cli/* diperbaiki ke rute app-server Codex openai/<model> yang sama di bawah openclaw doctor --fix, yang secara umum menangani perbaikan rute Codex lama.

Untuk memverifikasi: giliran yang didukung Codex melaporkan Runtime: OpenAI Codex di bawah /status, dan /codex status, /codex models, serta /codex binding memeriksa status app-server. Lint — openclaw doctor --lint --only codex/managed-app-server --json — memeriksa biner terkelola, tetapi dokumentasi menjelaskannya sebagai hanya-baca dan menempatkan biner Codex Desktop yang dipilih, perintah kustom eksplisit, serta app-server jarak jauh di luar pemeriksaan paket tersebut.

Ada satu ketegangan yang perlu diketahui sebelum Anda membangun di atasnya. Dokumentasi app-server milik OpenAI sendiri menyatakan bahwa "perintah app-server dan transport WebSocket bersifat eksperimental dan tidak didukung untuk beban kerja produksi" — perhatikan bahwa peringatan tersebut menyebut perintah maupun transport. OpenClaw membangun fitur yang dirilis di atas perintah itu, dan bidang transport-nya secara default adalah stdio, dengan websocket hanya digunakan ketika Anda mengonfigurasi url. Kedua pernyataan tersebut benar secara bersamaan; putuskan dengan mempertimbangkan keduanya.

Artefak pendelegasian, izin, pembatalan, dan pelanjutan

Dokumentasi harness bersikap jujur tentang batasan yang dapat dibuktikan oleh status subagen native: eksekusi, hasil tugas, dan pengiriman hasil adalah fakta yang terpisah, thread native yang menganggur, terinterupsi, atau dibongkar tidak membuktikan bahwa tugas berhasil, dan ketika konfirmasi penutupan tidak tersedia, tugas meminta Anda mencoba kembali penutupan tersebut. Subagen Codex native adalah mekanisme milik Codex sendiri — pendelegasian eksplisit OpenClaw atau ACP tetap melalui sessions_spawn.

Menurut tabel bidang konfigurasi plugin, izin eksekusi untuk app-server yang dibuat oleh OpenClaw secara default menggunakan mode yolo, kebijakan persetujuan never, dan sandbox danger-full-access, kecuali persyaratan Codex lokal tidak mengizinkan sikap tersebut; dalam hal itu, default guardian lebih memilih persetujuan sesuai permintaan dan workspace-write, atau read-only; requestTimeoutMs, batas waktu untuk panggilan bidang kontrol app-server, secara default adalah 60000. Ini adalah default OpenClaw untuk proses yang diluncurkannya, bukan milik Codex CLI, dan pada repositori yang belum dikenal, default pertama itulah pengaturan yang perlu ditinjau sebelum proses pertama.

Kontrol selama giliran bersifat native: /codex stop, /codex steer, /codex resume, /codex detach, /codex bind, /codex compact, /codex threads, /codex goal, /codex model, /codex fast, dan /codex permissions. Giliran terbatas berlaku per giliran, bukan sebagai mode sesi, dan hanya untuk giliran tersebut menonaktifkan Code Mode native, pemilihan lingkungan, server MCP yang dikonfigurasi, dan relay hook native. Kontrak dukungan runtime v1 OpenClaw juga mencantumkan hal-hal yang tidak didukung: mutasi argumen alat native (hook sebelum alat dapat memblokir, tetapi OpenClaw tidak menulis ulang argumen), riwayat transkrip native Codex yang dapat diedit, intervensi kompaksi, dan perekaman permintaan API model byte demi byte — jadi jika persyaratan audit Anda adalah permintaan keluar yang persis, runtime ini tidak dapat menyediakannya.

Otorisasi, hak paket, dan penggunaan token adalah tiga hal yang berbeda

Baca dari halaman kebijakan app-server Codex OpenClaw pada 21 September 2026. Ada jebakan penamaan yang perlu diperhatikan: halaman harga API OpenAI menyatakan bahwa pemrosesan Priority diubah namanya menjadi mode Fast pada 30 Juli 2026 dan Anda dapat mengirim service_tier berupa "priority" atau "fast", sedangkan appServer.serviceTier OpenClaw mendokumentasikan "priority" dan "flex" serta menormalkan "fast" legacy menjadi "priority" — arah yang berlawanan. "Aktifkan mode cepat" berarti hal yang berbeda dalam kedua sistem.

Mengapa endpoint pihak ketiga membuat harness tidak lagi digunakan

Ini adalah satu fakta yang paling sering dibalik oleh tulisan pihak ketiga. Tabel runtime agen implisit OpenClaw, untuk runtime penyedia atau model yang tidak disetel atau auto:

Jadi, menunjuk OpenClaw ke URL dasar pihak ketiga mana pun — termasuk Kunavo — menempatkan giliran pada runtime bawaan OpenClaw, sesuai desain. Awalan openai/* saja tidak pernah memilih harness, dan memaksa agentRuntime.id: "codex" tidak akan menyelamatkannya. Halaman runtime menyatakan bahwa pengaturan tersebut "memerlukan harness Codex yang terdaftar; rute/auth yang tidak didukung gagal secara tertutup, kecuali penggantian permintaan yang ditulis sendiri dapat menggunakan fallback OpenClaw dengan permintaan persis yang dinyatakan Codex sebelum eksekusi" — jadi hasilnya adalah giliran gagal atau giliran OpenClaw, dan tidak satu pun merupakan Codex pada endpoint kustom. Bidang konfigurasi terdokumentasi plugin juga tidak memuat pengaturan URL dasar model; satu-satunya bidang url di sana adalah alamat WebSocket atau unix:// milik app-server sendiri. Apakah appServer.args dapat menyelundupkan penggantian penyedia ke app-server terkelola tidak terdokumentasi dan belum diuji; halaman ini tidak menyajikannya sebagai solusi.

Rute runtime bawaan juga mengubah bentuk permintaan, dan halaman penyedia kustom OpenClaw menjelaskan secara spesifik cakupan setiap aturan. Untuk api: "openai-completions" pada endpoint non-native — yang didefinisikannya sebagai setiap baseUrl yang tidak kosong dan host-nya bukan api.openai.com — OpenClaw memaksa compat.supportsDeveloperRole menjadi false dan mengganti true eksplisit. Secara terpisah, rute bergaya proxy yang kompatibel dengan OpenAI "melewati pembentukan permintaan native yang hanya untuk OpenAI": tanpa service_tier, tanpa store Responses, tanpa store Completions, tanpa petunjuk cache prompt, tanpa pembentukan payload kompatibilitas penalaran OpenAI, dan tanpa header atribusi tersembunyi. Tanpa service_tier pada kabel, mode Fast dan Flex tidak dapat dipilih pada rute seperti itu. Sebagai gantinya, halaman yang sama menawarkan pass-through params.extra_body untuk proxy Completions yang kompatibel dengan OpenAI, headers per penyedia, dan models.providers.<id>.timeoutSeconds untuk host yang lambat atau jarak jauh.

Codex sendiri adalah separuh cerita lainnya, dan lebih permisif: halaman konfigurasi lanjutan Codex menunjukkan bahwa ~/.codex/config.toml mendukung [model_providers.<id>] dengan base_url dan env_key. Namun ada gerbang tegas — referensi konfigurasi menyatakan bahwa untuk model_providers.<id>.wire_api, "responses adalah satu-satunya nilai yang didukung, dan merupakan nilai default jika dihilangkan". Endpoint yang hanya menyediakan Chat Completions karena itu tidak dapat menggerakkan Codex. Halaman konfigurasi lanjutan yang sama mencadangkan ID bawaan openai, ollama, dan lmstudio, serta mencantumkan model_provider dan model_providers di antara kunci yang diabaikan Codex dalam .codex/config.toml tingkat proyek, sehingga kunci penyedia harus ditempatkan dalam konfigurasi tingkat pengguna. Kunavo menyediakan permukaan Responses native di /v1/responses, yang memungkinkan penyiapan Codex CLI — tetapi itu adalah Codex CLI mandiri, bukan harness OpenClaw, dan Kunavo belum menguji runtime kedua klien tersebut.

Biaya perangkat lunaknya, dan biaya tokennya

OpenClaw sendiri berharga $0. Indeks dokumentasinya menjelaskan proyek tersebut sebagai berlisensi MIT, digerakkan komunitas, dikembangkan oleh yayasan independen 501(c)(3), dengan "Tidak ada tingkat berbayar"; @openclaw/codex diterbitkan di registry npm publik tanpa biaya. Setiap biaya nyata adalah mesin tempat Anda menjalankan Gateway ditambah penggunaan model, dan penggunaan model hadir melalui salah satu dari tiga kontrak.

Menurut halaman harga Codex OpenAI, diperiksa pada 21 September 2026. Tiga catatan penting perlu disertakan pada tabel tersebut. Kartu harga hanya menerbitkan "Mulai dari $100" untuk Pro; artikel terpisah OpenAI Mengenai tingkat ChatGPT Pro menyebut tingkat $200 yang lebih tinggi, yang pendaftaran dan peningkatan barunya dihentikan sementara per 10 September 2026, jadi konfirmasikan saat pembayaran alih-alih menganggarkan angka yang tidak terlihat oleh halaman ini pada kartu harga. Penggunaan yang disertakan hanya diterbitkan sebagai kisaran perkiraan pesan lokal per periode lima jam, bukan jumlah pesan tetap. Dan tarif kredit setelah batas yang disertakan diterbitkan dalam kredit per juta token, tanpa nilai dolar untuk satu kredit pada halaman harga tersebut — jadi halaman itu tidak menyediakan konversi dolar untuk baris tersebut. Secara terpisah, GPT-5.5 dihentikan dari ChatGPT, ChatGPT Work, dan Codex pada semua paket pada 14 Oktober 2026, sedangkan API OpenAI tidak terpengaruh.

Kontrak ketiga adalah gateway pada runtime bawaan OpenClaw. Asumsikan satu giliran yang didelegasikan yang mengirim 180.000 token input yang tidak di-cache dan menerima 9.000 token output; tarifnya adalah harga terkini dalam katalog Kunavo per juta token.

Ini adalah aritmetika token ilustratif, bukan biaya tugas yang diukur dan bukan batas atas tagihan — bentuk giliran merupakan asumsi, dan giliran agen nyata mengirim ulang konteks pada setiap perjalanan bolak-balik alat. Jumlah katalog Kunavo adalah dasar penagihan, bukan batas maksimum: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream dikalikan markup yang berlaku. Biaya cache dan alat eksternal berada di luar contoh ini. Top-up minimum adalah $10 dalam kredit prabayar, yang mendanai saldo, bukan membeli paket — lihat detail penagihan.

Kunavo tidak menyediakan model embedding, model text-to-speech, maupun model speech-to-text. Langkah-langkah tersebut tidak disediakan oleh Kunavo pada rute mana pun, jadi gunakan penyedia yang menawarkannya.

Batasan tersebut penting di sini karena tabel permukaan di atas memisahkan rute OpenAI Platform non-agen dari harness, dan kunci Gateway hanya mencakup model chat dalam katalog Kunavo.

Rute mana yang unggul ketika

Jika jawabannya adalah baris gateway, mulai dari integrasi Codex CLI untuk bentuk Responses API, bandingkan opsi di API terbaik untuk OpenClaw dan API terbaik untuk Codex, lalu buat akun Kunavo ketika Anda siap mengisi dana untuk sebuah kunci. Untuk sisi anggaran asisten yang di-host sendiri, harga OpenClaw memisahkan biaya perangkat lunak, hosting, dan penggunaan model.

Pertanyaan umum

Tabel runtime, urutan autentikasi, peringatan app-server, gerbang wire_api, pin versi, dan harga paket di atas diambil pada 21 September 2026 dari dokumentasi milik OpenClaw dan OpenAI, pusat bantuan OpenAI, serta entri registry npm untuk openclaw, @openclaw/codex, @openai/codex, codex, dan openclaw-code-agent. Setiap klaim ditautkan ke halaman asalnya; jika suatu dokumen tidak menyelesaikan pertanyaan, teks menyatakannya demikian alih-alih mengisi celah. Kunavo belum menjalankan pengujian runtime OpenClaw maupun harness Codex, sehingga setiap konfigurasi di sini diperiksa terhadap dokumentasi sumber, bukan didemonstrasikan terhadap endpoint Kunavo. Tarif token Kunavo berasal dari katalog langsung, dan setiap angka dolar merupakan aritmetika ilustratif.