Fuseaux horaires

OpenClaw standardise les horodatages afin que le modèle voie une heure de référence unique.

Enveloppes de messages (locales par défaut)

Les messages entrants sont encapsulés dans une enveloppe comme suit :

[Provider ... 2026-01-05 16:26 PST] message text

L’horodatage de l’enveloppe est local à l’hôte par défaut, avec une précision à la minute.

Vous pouvez remplacer cela par :

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

envelopeTimezone: "utc" utilise UTC.
envelopeTimezone: "user" utilise agents.defaults.userTimezone (revient au fuseau horaire de l’hôte).
Utilisez un fuseau horaire IANA explicite (par exemple, "Europe/Vienna") pour un décalage fixe.
envelopeTimestamp: "off" supprime les horodatages absolus des en-têtes de l’enveloppe.
envelopeElapsed: "off" supprime les suffixes de temps écoulé (le style +2m).

Exemples

Local (par défaut) :

[Signal Alice +1555 2026-01-18 00:19 PST] hello

Fuseau horaire fixe :

[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello

Temps écoulé :

[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

Charges utiles d’outils (données brutes du fournisseur + champs normalisés)

Les appels d’outils (channels.discord.readMessages, channels.slack.readMessages, etc.) renvoient des horodatages bruts du fournisseur. Nous attachons également des champs normalisés pour la cohérence :

timestampMs (millisecondes depuis l’époque UTC)
timestampUtc (chaîne UTC ISO 8601)

Les champs bruts du fournisseur sont préservés.

Fuseau horaire de l’utilisateur pour l’invite système

Définissez agents.defaults.userTimezone pour indiquer au modèle le fuseau horaire local de l’utilisateur. S’il n’est pas défini, OpenClaw résout le fuseau horaire de l’hôte lors de l’exécution (sans écriture de configuration).

{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}

L’invite système comprend :

Section Current Date & Time avec l’heure locale et le fuseau horaire
Time format: 12-hour ou 24-hour

Vous pouvez contrôler le format de l’invite avec agents.defaults.timeFormat (auto | 12 | 24).

Voir Date & Heure pour le comportement complet et les exemples.

Connexes

Heartbeat — les heures actives utilisent le fuseau horaire pour la planification
Cron Jobs — les expressions cron utilisent le fuseau horaire pour la planification
Date & Time — comportement complet de la date et de l’heure et exemples