Skip to main content
OpenClaw menstandarkan stempel waktu agar model melihat satu waktu acuan alih-alih campuran waktu lokal penyedia. Tiga permukaan menampilkan zona waktu, masing-masing dengan tujuannya sendiri:

​
Tiga permukaan zona waktu

Prompt sistem sengaja tidak menyertakan waktu saat ini agar cache prompt tetap stabil antarputaran. Ketika agen memerlukan waktu saat ini, agen memanggil session_status.

​
Mengatur zona waktu pengguna

Jika userTimezone tidak disetel, OpenClaw menentukan zona waktu host saat runtime melalui Intl.DateTimeFormat().resolvedOptions().timeZone (tanpa menulis konfigurasi). agents.defaults.timeFormat (auto | 12 | 24) mengontrol penyajian format 12 jam/24 jam dalam amplop dan permukaan hilir, bukan dalam bagian prompt sistem.

​
Nilai zona waktu amplop

agents.defaults.envelopeTimezone menerima:
  • "local" (bawaan) atau "host" - zona waktu mesin host.
  • "utc" atau "gmt" - UTC.
  • "user" - agents.defaults.userTimezone yang telah ditentukan (kembali menggunakan zona waktu host jika tidak disetel).
  • String zona IANA eksplisit apa pun, misalnya "Europe/Vienna".

​
Kapan perlu mengganti

  • Gunakan "utc" untuk stempel waktu yang konsisten pada host di wilayah berbeda, atau agar sesuai dengan keluaran diagnostik/log yang diselaraskan dengan UTC.
  • Gunakan "user" agar amplop tetap selaras dengan zona waktu pengguna yang dikonfigurasi, terlepas dari zona tempat host Gateway berjalan.
  • Gunakan zona IANA tetap ketika host Gateway berada di satu zona, tetapi amplop harus selalu dibaca dalam zona lain terlepas dari migrasi host.
  • Setel envelopeTimestamp: "off" ketika konteks stempel waktu tidak berguna bagi percakapan. Ini menghapus stempel waktu absolut dari amplop, prefiks prompt agen langsung, dan prefiks masukan model yang disematkan.
Untuk referensi perilaku lengkap, contoh per penyedia, dan pemformatan waktu berlalu, lihat Tanggal & Waktu.

​
Terkait

  • Tanggal & Waktu - perilaku lengkap amplop/alat/prompt beserta contohnya.
  • Heartbeat - jam aktif menggunakan zona waktu untuk penjadwalan.
  • Pekerjaan Cron - ekspresi cron menggunakan zona waktu untuk penjadwalan.