In questa pagina
In questa pagina
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:
Il timestamp dell'involucro è locale all'host per impostazione predefinita, indipendentemente dal fuso orario del provider.
È possibile modificarlo in agents.defaults:
| 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):
Fuso orario dell'utente:
Tempo trascorso con envelopeTimezone: "utc":
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:
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).
Configurare il fuso orario dell'utente e il formato
userTimezoneimposta il fuso orario locale dell'utente per il contesto del prompt (e perenvelopeTimezone: "user").timeFormatcontrolla la visualizzazione a 12/24 ore negli orari presentati nel prompt.autosegue 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.
