Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw menstandarkan stempel waktu sehingga 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 ditampilkanBawaanDikonfigurasi melalui
Amplop pesanMembungkus pesan kanal masuk: [Signal +1555 2026-01-18 00:19 PST] helloLokal hostagents.defaults.envelopeTimezone
Payload alatAlat bergaya readMessages kanal mengembalikan waktu mentah penyedia + timestampMs / timestampUtc ternormalisasiKolom UTC selalu adaTidak dapat dikonfigurasi — mempertahankan stempel waktu native penyedia
Prompt sistemBlok kecil Current Date & Time dengan zona waktu saja (tanpa nilai jam, untuk stabilitas cache)Zona waktu host jika userTimezone belum diaturagents.defaults.userTimezone
Prompt sistem sengaja menghilangkan jam langsung agar caching prompt tetap stabil antar giliran. Saat agent membutuhkan waktu saat ini, agent memanggil session_status.

​
Mengatur zona waktu pengguna

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Jika userTimezone belum diatur, 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 menimpa

  • Gunakan amplop UTC (envelopeTimezone: "utc") saat Anda menginginkan stempel waktu yang stabil di berbagai host di wilayah berbeda, atau saat Anda ingin log yang selaras 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.
  • Atur envelopeTimestamp: "off" untuk amplop rendah token saat konteks stempel waktu tidak berguna untuk percakapan.
Untuk referensi perilaku lengkap, contoh per penyedia, dan format waktu berlalu, lihat Tanggal & Waktu.

​
Terkait

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