OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Technical reference

Data e ora

OpenClaw usa l'ora locale dell'host per i timestamp del trasporto e inserisce solo il fuso orario nel prompt di sistema. I timestamp del provider vengono preservati affinché gli strumenti mantengano la propria semantica nativa. Quando l'agente deve conoscere la data e l'ora correnti, esegue lo strumento session_status.

Involucri dei messaggi (locali per impostazione predefinita)

I messaggi in entrata vengono racchiusi in un involucro con il giorno della settimana e un timestamp con precisione al secondo:

Code
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] testo del messaggio

Il timestamp dell'involucro è locale all'host per impostazione predefinita, indipendentemente dal fuso orario del provider. È possibile modificarlo in agents.defaults:

json5
{  agents: {    defaults: {      envelopeTimezone: "local", // "utc" | "local" | "user" | fuso orario IANA      envelopeTimestamp: "on", // "on" | "off"      envelopeElapsed: "on", // "on" | "off"    },  },}
Chiave Valori Comportamento
envelopeTimezone local (predefinito), utc, user, nome IANA esplicito user usa agents.defaults.userTimezone (il fuso orario dell'host se non impostato). Un nome IANA esplicito (ad es. "America/Chicago") fissa un determinato fuso; i nomi non riconosciuti usano UTC come ripiego.
envelopeTimestamp on (predefinito), off off rimuove i timestamp assoluti dalle intestazioni degli involucri, dai prefissi diretti dei prompt dell'agente e dai prefissi incorporati nell'input del modello.
envelopeElapsed on (predefinito), off off rimuove il suffisso del tempo trascorso (nel formato +30s / +2m) visualizzato dalla ricezione del messaggio precedente nella sessione.

Esempi

Locale (predefinito):

Code
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] ciao

Fuso orario dell'utente:

Code
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] ciao

Tempo trascorso con envelopeTimezone: "utc":

Code
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] messaggio successivo

Prompt di sistema: data e ora correnti

Il prompt di sistema include una sezione Data e ora correnti contenente solo il fuso orario (senza orologio o formato dell'ora), per mantenere stabile la cache del prompt:

Code
Fuso orario: America/Chicago

Il fuso è agents.defaults.userTimezone quando è configurato; in caso contrario, viene usato il fuso orario dell'host. Il prompt indica inoltre all'agente di eseguire lo strumento session_status ogni volta che deve conoscere la data, l'ora o il giorno della settimana correnti.

Righe degli eventi di sistema (locali per impostazione predefinita)

Gli eventi di sistema in coda inseriti nel contesto dell'agente sono preceduti da un timestamp che usa la stessa selezione envelopeTimezone degli involucri dei messaggi (impostazione predefinita: ora locale dell'host).

Code
Sistema: [2026-01-12 12:19:17 PST] Modello cambiato.

Configurare il fuso orario dell'utente e il formato

json5
{  agents: {    defaults: {      userTimezone: "America/Chicago",      timeFormat: "auto", // auto | 12 | 24    },  },}
  • userTimezone imposta il fuso orario locale dell'utente per il contesto del prompt (e per envelopeTimezone: "user").
  • timeFormat controlla la visualizzazione a 12/24 ore negli orari presentati nel prompt. auto segue le preferenze del sistema operativo.

Rilevamento del formato dell'ora (automatico)

Quando timeFormat: "auto", OpenClaw esamina la preferenza del sistema operativo (macOS e Windows) e, come ripiego, usa la formattazione delle impostazioni locali. Il valore rilevato viene memorizzato nella cache per ogni processo per evitare chiamate di sistema ripetute.

Payload degli strumenti e connettori (ora grezza del provider e campi normalizzati)

Gli strumenti dei canali restituiscono timestamp nativi del provider e aggiungono campi normalizzati per garantire coerenza:

  • timestampMs: millisecondi dall'epoca (UTC)
  • timestampUtc: stringa UTC ISO 8601

I campi grezzi del provider vengono preservati per evitare la perdita di informazioni.

  • Discord: timestamp ISO UTC
  • Slack: stringhe simili a valori epoca provenienti dall'API
  • Telegram/WhatsApp: timestamp numerici o ISO specifici del provider

Se è necessaria l'ora locale, convertirla a valle usando il fuso orario noto.

Documentazione correlata

Was this useful?
On this page

On this page