Vai al contenuto principale

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 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

SuperficieCosa mostraPredefinitoConfigurato tramite
Envelope dei messaggiAvvolge i messaggi in ingresso dei canali: [Signal +1555 2026-01-18 00:19 PST] helloLocale dell’hostagents.defaults.envelopeTimezone
Payload degli strumentiGli strumenti in stile readMessages del canale restituiscono l’ora grezza del provider + timestampMs / timestampUtc normalizzatiCampi UTC sempre presentiNon configurabile — conserva i timestamp nativi del provider
Prompt di sistemaUn 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 è impostatoagents.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.