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:

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

{
  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):

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

Fuso orario dell’utente:

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

Tempo trascorso con envelopeTimezone: "utc":

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

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

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

Configurare il fuso orario dell’utente e il formato

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

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Involucri dei messaggi (locali per impostazione predefinita)

Esempi

Prompt di sistema: data e ora correnti

Righe degli eventi di sistema (locali per impostazione predefinita)

Configurare il fuso orario dell’utente e il formato

Rilevamento del formato dell’ora (automatico)

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

Documentazione correlata

​Involucri dei messaggi (locali per impostazione predefinita)

​Esempi

​Prompt di sistema: data e ora correnti

​Righe degli eventi di sistema (locali per impostazione predefinita)

​Configurare il fuso orario dell’utente e il formato

​Rilevamento del formato dell’ora (automatico)

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

​Documentazione correlata

Involucri dei messaggi (locali per impostazione predefinita)

Esempi

Prompt di sistema: data e ora correnti

Righe degli eventi di sistema (locali per impostazione predefinita)

Configurare il fuso orario dell’utente e il formato

Rilevamento del formato dell’ora (automatico)

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

Documentazione correlata