Vai al contenuto principale
OpenClaw standardizza i timestamp in modo che 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 dei fusi orari

SuperficieCosa mostraPredefinitoConfigurato tramite
Involucri messaggioRacchiude i messaggi in ingresso dai canali: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloLocale dell’hostagents.defaults.envelopeTimezone
Payload degli strumentiGli strumenti di canale in stile readMessages restituiscono l’ora grezza del provider + timestampMs / timestampUtc normalizzatiCampi UTC sempre presentiNon configurabile — preserva i timestamp nativi del provider
Prompt di sistemaUn piccolo blocco Current Date & Time con solo il fuso orario (nessun valore dell’orologio, per la stabilità della cache)Fuso orario dell’host se userTimezone non è impostatoagents.defaults.userTimezone
Il prompt di sistema omette deliberatamente l’orologio in tempo reale per mantenere stabile la cache dei prompt tra i turni. Quando l’agente ha bisogno dell’ora corrente, 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 il rendering a 12/24 ore negli involucri e nelle superfici a valle, non nella sezione del prompt di sistema.

​
Quando eseguire l’override

  • Usa involucri UTC (envelopeTimezone: "utc") quando vuoi timestamp stabili tra host in regioni diverse, o quando vuoi log allineati a UTC che corrispondano all’output di diagnostica.
  • Usa una zona IANA fissa (ad es. "Europe/Vienna") quando l’host Gateway si trova in una zona ma l’utente in un’altra e vuoi che gli involucri siano letti nella zona dell’utente indipendentemente dalla migrazione dell’host.
  • Imposta envelopeTimestamp: "off" quando il contesto del timestamp non è utile per la conversazione. Questo rimuove i timestamp assoluti dagli involucri, dai prefissi diretti dei prompt dell’agente e dai prefissi incorporati nell’input del modello.
Per il riferimento completo del comportamento, esempi per provider e formattazione del tempo trascorso, consulta Data e ora.

​
Correlati

  • Data e ora — comportamento completo di involucri/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.