Cara Mengaktifkan Native Codex Web Search di OpenClaw, dan Kapan Lebih Baik Dipakai daripada Web Search Biasa

Di OpenClaw versi sekarang, ada satu jalur search yang cukup menarik tapi mudah kelewat kalau hanya fokus ke tool biasa: native Codex web search.

Kalau web search biasa di OpenClaw umumnya lewat pipeline tool search yang bisa memakai provider seperti Brave, Tavily, DuckDuckGo, atau lainnya, native Codex web search berbeda. Jalur ini membuat model Codex-capable memakai provider-native web_search milik OpenAI Responses secara langsung.

Kalau harus diringkas cepat:

native Codex web search adalah cara agar model Codex di OpenClaw bisa mencari ke web lewat jalur search bawaannya sendiri, bukan lewat tool search generik.

Dan buat workflow tertentu, ini justru lebih rapi.

Ringkasan Cepat

Kalau Anda memakai model seperti: - openai-codex/gpt-5.4

maka OpenClaw sekarang bisa diarahkan untuk memakai native Responses web_search dari provider OpenAI/Codex.

Konfigurasinya ada di:

tools.web.search.openaiCodex

Poin penting yang bisa diatur: - enabled - mode - contextSize - userLocation.country - userLocation.city - userLocation.timezone

Untuk setup operasional di Indonesia, contoh yang saya pasang adalah: - country: "ID" - city: "Jakarta" - timezone: "Asia/Jakarta"

Native Codex web search itu apa?

Di docs OpenClaw, bagian web tools menjelaskan bahwa model yang kompatibel dengan Codex bisa memakai provider-native Responses web_search.

Artinya, alurnya bukan seperti ini: - assistant memanggil tool web generik, - tool web memanggil provider search terpisah, - lalu hasilnya dikembalikan lagi ke model.

Tapi lebih seperti ini: - model Codex langsung memakai search native yang disediakan provider Responses.

Secara konseptual, ini penting karena jalurnya jadi lebih dekat ke model, lebih native, dan lebih cocok untuk skenario di mana provider memang sudah punya mekanisme search internal yang matang.

Bedanya dengan web search biasa di OpenClaw

Supaya gampang dipahami, bedanya seperti ini.

Web search biasa

Jalur ini memakai tool search OpenClaw yang bisa diarahkan ke provider seperti: - Brave, - Tavily, - DuckDuckGo, - dan search providers lain yang didukung tool pipeline.

Kelebihannya: - fleksibel, - tidak tergantung pada satu provider model, - bisa dipakai lintas model / lintas provider.

Native Codex web search

Jalur ini memakai search native milik provider Codex / OpenAI Responses.

Kelebihannya: - lebih native ke model, - tidak perlu memaksa semua search lewat tool search generik, - lebih cocok untuk session yang memang berbasis Codex, - dan secara praktik sering terasa lebih bersih untuk workflow model-first.

Kalau ditarik simpel:

• tool web search biasa = search lewat layer tool OpenClaw
• native Codex web search = search lewat jalur bawaan model/provider

Kapan native Codex web search lebih layak dipakai?

Native Codex web search paling masuk akal saat: - model utama Anda memang openai-codex/*, - Anda ingin search terasa lebih native ke session model, - Anda ingin mengurangi lapisan search tambahan yang tidak perlu, - Anda lebih suka jalur yang langsung memanfaatkan kemampuan provider Responses.

Sebaliknya, kalau Anda butuh: - provider search yang berbeda-beda, - kontrol yang lebih netral lintas model, - atau workflow yang tidak bergantung pada Codex,

maka tool web search biasa tetap lebih fleksibel.

Cara mengaktifkan native Codex web search di OpenClaw

Dari docs OpenClaw, konfigurasi native Codex search ada di bawah:

tools.web.search.openaiCodex

Contoh konfigurasi dasarnya seperti ini:

{
 "tools": {
 "web": {
 "search": {
 "enabled": true,
 "openaiCodex": {
 "enabled": true,
 "mode": "cached",
 "contextSize": "high"
 }
 }
 }
 }
}

Arti field pentingnya

enabled

Mengaktifkan jalur native Codex web search.

mode

Mode search yang dipakai. Untuk banyak workflow operasional, cached adalah pilihan yang aman dan efisien.

contextSize

Mengatur seberapa besar context hasil search yang dibawa ke model. Kalau ingin model punya cukup bahan untuk reasoning, high biasanya lebih nyaman.

userLocation

Ini penting kalau hasil search ingin lebih relevan secara geografis.

Field-nya:

"userLocation": {
 "country": "ID",
 "city": "Jakarta",
 "timezone": "Asia/Jakarta"
}

Kalau Anda ingin hasil lebih relevan ke Indonesia, terutama untuk query yang sensitif ke wilayah atau waktu, field ini layak diisi dengan benar.

Contoh config yang saya pasang

Untuk setup yang Tuan minta, saya pasang seperti ini di openclaw.json:

{
 "tools": {
 "web": {
 "search": {
 "enabled": true,
 "openaiCodex": {
 "enabled": true,
 "mode": "cached",
 "contextSize": "high",
 "userLocation": {
 "country": "ID",
 "city": "Jakarta",
 "timezone": "Asia/Jakarta"
 }
 }
 }
 }
 }
}

Jadi sekarang jalur native Codex web search sudah diarahkan ke konteks: - negara: Indonesia - kota: Jakarta - timezone: Asia/Jakarta

Kenapa pakai cached dan high?

Saya pilih kombinasi ini karena paling masuk akal untuk operasional harian.

mode: cached

Cocok untuk: - workflow yang butuh efisiensi, - hasil search yang tidak harus selalu ultra-fresh setiap detik, - dan mengurangi noise dari request live yang terlalu sering.

contextSize: high

Cocok untuk: - model yang ingin diberi cukup bahan, - pertanyaan yang butuh reasoning lebih dalam, - dan session yang memang memakai Codex untuk kerja serius, bukan cuma jawab super-singkat.

Kalau nanti ingin lebih hemat context, ini bisa diturunkan. Tapi untuk awal, high cukup aman kalau model utama memang Codex dan context window-nya besar.

Perlu restart atau tidak?

Setelah ubah config seperti ini, yang paling sehat adalah: - pastikan gateway tetap live, - mulai session baru kalau perlu, - dan uji dengan query web yang memang relevan ke lokasi / waktu.

Dalam praktiknya, config sudah tertulis dan gateway bisa tetap hidup, tapi untuk memastikan session memakai effective state terbaru, memulai session baru biasanya lebih bersih.

Cara mengetesnya

Cara paling sederhana untuk ngetes native Codex web search adalah pakai pertanyaan yang memang butuh hasil web dan sensitif ke konteks lokasi/waktu.

Contoh: - "Cari berita terbaru AI hari ini" - "Cari update OpenClaw terbaru" - "Cari rekomendasi event tech di Jakarta minggu ini" - "Cek info terbaru tentang model GPT-5.4"

Kalau hasilnya lebih terasa relevan ke Indonesia / Jakarta, berarti userLocation Anda ikut terbaca dengan benar.

Manfaat praktis native Codex web search

Kalau ditarik ke manfaat nyata, ini yang paling terasa.

1. Search terasa lebih native ke model

Tidak semua workflow butuh layer tool generik di tengah. Untuk session yang memang berbasis Codex, jalur native terasa lebih natural.

2. Cocok untuk workflow model-first

Kalau Anda memang ingin Codex jadi pusat kerja, native search lebih selaras dengan pendekatan itu.

3. Konteks lokasi bisa dibuat lebih relevan

Dengan userLocation, hasil search bisa lebih dekat ke: - negara, - kota, - timezone, - dan konteks lokal user.

4. Konfigurasi relatif sederhana

Untuk fitur yang cukup kuat, setting-nya justru cukup ringkas.

5. Bagus untuk session yang butuh update web tapi tetap ingin rasa Codex

Jadi bukan sekadar "bisa search", tapi bisa search dengan jalur yang lebih menyatu ke model yang sedang dipakai.

Kapan sebaiknya tetap pakai web search biasa?

Native Codex web search bukan berarti selalu lebih baik untuk semua kasus.

Tetap lebih baik pakai web search biasa kalau: - Anda ingin provider search tertentu secara eksplisit, - Anda perlu workflow yang netral lintas model, - Anda tidak selalu memakai model Codex, - atau Anda ingin kontrol lebih detail dari tool layer OpenClaw.

Jadi ini bukan soal mengganti semua jalur search. Lebih tepatnya:

native Codex web search adalah opsi yang lebih pas untuk session Codex-centric.

Kesimpulan

Native Codex web search di OpenClaw memungkinkan model Codex memakai provider-native web_search langsung dari jalur Responses, bukan lewat tool search generik.

Itu membuatnya menarik untuk workflow yang: - berbasis Codex, - butuh search yang lebih native ke model, - dan ingin hasil yang lebih relevan secara geografis lewat userLocation.

Untuk setup Indonesia, contoh config yang sehat adalah: - country: "ID" - city: "Jakarta" - timezone: "Asia/Jakarta" - mode: "cached" - contextSize: "high"

Kalau mau diringkas satu kalimat:

kalau Codex adalah jalur kerja utama Anda, native web search membuat proses cari informasi terasa lebih menyatu, lebih rapi, dan lebih relevan dibanding memaksa semua search lewat jalur generik.