Concept internals
Zona waktu
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
| Permukaan | Yang ditampilkan | Default | Dikonfigurasi melalui |
|---|---|---|---|
| Amplop pesan | Membungkus pesan channel masuk: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
Lokal host | agents.defaults.envelopeTimezone |
| Muatan tool | Tool bergaya readMessages channel mengembalikan waktu penyedia mentah + timestampMs / timestampUtc ternormalisasi |
Field UTC selalu ada | Tidak dapat dikonfigurasi — mempertahankan stempel waktu asli penyedia |
| Prompt sistem | Blok kecil Current Date & Time dengan zona waktu saja (tanpa nilai jam, untuk stabilitas cache) |
Zona waktu host jika userTimezone belum disetel |
agents.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.
Was this useful?
