Langsung ke konten utama
OpenClaw menstandarkan stempel waktu agar model melihat satu waktu referensi alih-alih campuran jam lokal penyedia. Ada tiga permukaan tempat zona waktu muncul, masing-masing dengan tujuannya sendiri:

​
Tiga permukaan zona waktu

PermukaanYang ditampilkanDefaultDikonfigurasi melalui
Amplop pesanMembungkus pesan channel masuk: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloLokal hostagents.defaults.envelopeTimezone
Muatan toolTool bergaya readMessages channel mengembalikan waktu penyedia mentah + timestampMs / timestampUtc ternormalisasiField UTC selalu adaTidak dapat dikonfigurasi — mempertahankan stempel waktu asli penyedia
Prompt sistemBlok kecil Current Date & Time dengan zona waktu saja (tanpa nilai jam, untuk stabilitas cache)Zona waktu host jika userTimezone belum disetelagents.defaults.userTimezone
Prompt sistem sengaja menghilangkan jam langsung agar cache prompt tetap stabil lintas giliran. Saat agen membutuhkan waktu saat ini, agen memanggil session_status.

​
Menyetel zona waktu pengguna

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Jika userTimezone belum disetel, OpenClaw menyelesaikan zona waktu host saat runtime (tanpa menulis konfigurasi). agents.defaults.timeFormat (auto | 12 | 24) mengontrol rendering 12 jam/24 jam di amplop dan permukaan downstream, bukan di bagian prompt sistem.

​
Kapan harus mengganti

  • Gunakan amplop UTC (envelopeTimezone: "utc") saat Anda menginginkan stempel waktu stabil lintas host di berbagai wilayah, atau saat Anda ingin log yang selaras dengan UTC cocok dengan output diagnostik.
  • Gunakan zona IANA tetap (mis. "Europe/Vienna") saat host Gateway berada di satu zona tetapi pengguna berada di zona lain dan Anda ingin amplop terbaca dalam zona pengguna terlepas dari migrasi host.
  • Setel envelopeTimestamp: "off" saat konteks stempel waktu tidak berguna untuk percakapan. Ini menghapus stempel waktu absolut dari amplop, prefiks prompt agen langsung, dan prefiks input model tertanam.
Untuk referensi perilaku lengkap, contoh per penyedia, dan pemformatan waktu berlalu, lihat Tanggal & Waktu.

​
Terkait

  • Tanggal & Waktu — perilaku dan contoh lengkap untuk amplop/tool/prompt.
  • Heartbeat — jam aktif menggunakan zona waktu untuk penjadwalan.
  • Pekerjaan Cron — ekspresi cron menggunakan zona waktu untuk penjadwalan.