Fusi orari

OpenClaw standardizza i timestamp affinché il modello veda un unico orario di riferimento invece di un insieme di orologi locali dei provider. Ci sono tre superfici in cui compaiono i fusi orari, ciascuna con il proprio scopo:

# Tre superfici di fuso orario

Superficie	Cosa mostra	Predefinito	Configurato tramite
Envelope dei messaggi	Avvolge i messaggi in ingresso dei canali: [Signal +1555 2026-01-18 00:19 PST] hello	Locale dell'host	agents.defaults.envelopeTimezone
Payload degli strumenti	Gli strumenti in stile readMessages del canale restituiscono l'ora grezza del provider + timestampMs / timestampUtc normalizzati	Campi UTC sempre presenti	Non configurabile — conserva i timestamp nativi del provider
Prompt di sistema	Un piccolo blocco Current Date & Time con solo il fuso orario (senza valore dell'orologio, per la stabilità della cache)	Fuso orario dell'host se userTimezone non è impostato	agents.defaults.userTimezone

Il prompt di sistema omette deliberatamente l'orologio live per mantenere stabile la cache dei prompt tra i turni. Quando l'agente ha bisogno dell'ora attuale, chiama session_status.

# Impostare il fuso orario dell'utente

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}

Se userTimezone non è impostato, OpenClaw risolve il fuso orario dell'host in fase di esecuzione (senza scrivere configurazione). agents.defaults.timeFormat (auto | 12 | 24) controlla la resa a 12/24 ore negli envelope e nelle superfici downstream, non nella sezione del prompt di sistema.

# Quando sovrascrivere

• Usa envelope UTC (envelopeTimezone: "utc") quando vuoi timestamp stabili tra host in regioni diverse, oppure quando vuoi che i log allineati a UTC corrispondano all'output diagnostico.
• Usa una zona IANA fissa (ad esempio "Europe/Vienna") quando l'host del Gateway si trova in una zona ma l'utente in un'altra e vuoi che gli envelope siano letti nella zona dell'utente indipendentemente dalla migrazione dell'host.
• Imposta envelopeTimestamp: "off" per envelope a basso numero di token quando il contesto del timestamp non è utile per la conversazione.

Per il riferimento completo del comportamento, esempi per provider e formattazione del tempo trascorso, vedi Data e ora.

# Correlati

• Data e ora — comportamento completo di envelope/strumenti/prompt ed esempi.
• Heartbeat — le ore attive usano il fuso orario per la pianificazione.
• Processi Cron — le espressioni cron usano il fuso orario per la pianificazione.