Tanggal dan waktu

OpenClaw secara default menggunakan waktu lokal host untuk stempel waktu transport dan zona waktu pengguna hanya di prompt sistem. Stempel waktu penyedia dipertahankan agar alat tetap menjaga semantik aslinya (waktu saat ini tersedia melalui session_status).

# Amplop pesan (lokal secara default)

Pesan masuk dibungkus dengan stempel waktu (presisi menit):

[Provider ... 2026-01-05 16:26 PST] message text

Stempel waktu amplop ini lokal host secara default, terlepas dari zona waktu penyedia.

Anda dapat mengganti perilaku ini:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

• envelopeTimezone: "utc" menggunakan UTC.
• envelopeTimezone: "local" menggunakan zona waktu host.
• envelopeTimezone: "user" menggunakan agents.defaults.userTimezone (kembali ke zona waktu host).
• Gunakan zona waktu IANA eksplisit (misalnya, "America/Chicago") untuk zona tetap.
• envelopeTimestamp: "off" menghapus stempel waktu absolut dari header amplop.
• envelopeElapsed: "off" menghapus sufiks waktu berlalu (gaya +2m).

# Contoh

Lokal (default):

[WhatsApp +1555 2026-01-18 00:19 PST] hello

Zona waktu pengguna:

[WhatsApp +1555 2026-01-18 00:19 CST] hello

Waktu berlalu diaktifkan:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

# Prompt sistem: tanggal dan waktu saat ini

Jika zona waktu pengguna diketahui, prompt sistem menyertakan bagian khusus Tanggal & Waktu Saat Ini dengan zona waktu saja (tanpa format jam/waktu) untuk menjaga cache prompt tetap stabil:

Time zone: America/Chicago

Saat agen memerlukan waktu saat ini, gunakan alat session_status; kartu status menyertakan baris stempel waktu.

# Baris peristiwa sistem (lokal secara default)

Peristiwa sistem antrean yang dimasukkan ke dalam konteks agen diawali dengan stempel waktu menggunakan pemilihan zona waktu yang sama seperti amplop pesan (default: lokal host).

System: [2026-01-12 12:19:17 PST] Model switched.

# Konfigurasikan zona waktu pengguna + format

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

• userTimezone menetapkan zona waktu lokal pengguna untuk konteks prompt.
• timeFormat mengontrol tampilan 12j/24j dalam prompt. auto mengikuti preferensi OS.

# Deteksi format waktu (auto)

Saat timeFormat: "auto", OpenClaw memeriksa preferensi OS (macOS/Windows) dan kembali ke pemformatan lokal. Nilai yang terdeteksi di-cache per proses untuk menghindari panggilan sistem berulang.

# Payload alat + konektor (waktu mentah penyedia + bidang ternormalisasi)

Alat kanal mengembalikan stempel waktu asli penyedia dan menambahkan bidang ternormalisasi untuk konsistensi:

• timestampMs: milidetik epoch (UTC)
• timestampUtc: string UTC ISO 8601

Bidang mentah penyedia dipertahankan agar tidak ada yang hilang.

• Slack: string mirip epoch dari API
• Discord: stempel waktu ISO UTC
• Telegram/WhatsApp: stempel waktu numerik/ISO khusus penyedia

Jika Anda memerlukan waktu lokal, konversikan di hilir menggunakan zona waktu yang diketahui.

# Dokumen terkait

• Prompt Sistem
• Zona Waktu
• Pesan