Skip to main content
OpenClaw standardizza i timestamp affinché il modello veda un unico orario di riferimento anziché una combinazione di orologi locali dei provider. Tre superfici mostrano i fusi orari, ciascuna con uno scopo specifico:

​
Tre superfici per i fusi orari

Il prompt di sistema omette deliberatamente l’ora corrente per mantenere stabile la memorizzazione nella cache del prompt tra i turni. Quando l’agente deve conoscere l’ora corrente, chiama session_status.

​
Impostazione del fuso orario dell’utente

Se userTimezone non è impostato, OpenClaw determina il fuso orario dell’host in fase di esecuzione tramite Intl.DateTimeFormat().resolvedOptions().timeZone (senza scrivere nella configurazione). agents.defaults.timeFormat (auto | 12 | 24) controlla la visualizzazione in formato 12/24 ore nelle buste e nelle superfici a valle, ma non nella sezione del prompt di sistema.

​
Valori del fuso orario delle buste

agents.defaults.envelopeTimezone accetta:
  • "local" (valore predefinito) o "host" - il fuso orario della macchina host.
  • "utc" o "gmt" - UTC.
  • "user" - il valore determinato di agents.defaults.userTimezone (se non è impostato, usa il fuso orario dell’host).
  • Qualsiasi stringa esplicita di un fuso IANA, ad esempio "Europe/Vienna".

​
Quando sostituire il valore predefinito

  • Usa "utc" per ottenere timestamp coerenti tra host situati in regioni diverse o per uniformarli all’output di diagnostica e dei log basato su UTC.
  • Usa "user" per mantenere le buste allineate al fuso orario configurato per l’utente, indipendentemente dal fuso in cui viene eseguito l’host del Gateway.
  • Usa un fuso IANA fisso quando l’host del Gateway si trova in un fuso, ma la busta deve essere sempre visualizzata in un altro, indipendentemente dalla migrazione dell’host.
  • Imposta envelopeTimestamp: "off" quando il contesto temporale non è utile per la conversazione. Questa impostazione rimuove i timestamp assoluti dalle buste, dai prefissi dei prompt diretti dell’agente e dai prefissi incorporati nell’input del modello.
Per il riferimento completo sul comportamento, esempi per ciascun provider e la formattazione del tempo trascorso, consulta Data e ora.

​
Contenuti correlati

  • Data e ora - comportamento completo ed esempi per buste, strumenti e prompt.
  • Heartbeat - le ore di attività usano il fuso orario per la pianificazione.
  • Processi Cron - le espressioni cron usano il fuso orario per la pianificazione.