Passer au contenu principal

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 standardise les horodatages afin que le modèle voie une seule heure de référence au lieu d’un mélange d’horloges locales aux fournisseurs. Les fuseaux horaires apparaissent sur trois surfaces, chacune ayant son propre objectif :

​
Trois surfaces de fuseaux horaires

SurfaceCe qu’elle afficheValeur par défautConfiguré via
Enveloppes de messagesEncapsule les messages de canal entrants : [Signal +1555 2026-01-18 00:19 PST] bonjourLocale à l’hôteagents.defaults.envelopeTimezone
Charges utiles des outilsLes outils de type readMessages du canal renvoient l’heure brute du fournisseur + les champs normalisés timestampMs / timestampUtcChamps UTC toujours présentsNon configurable — conserve les horodatages natifs du fournisseur
Invite systèmeUn petit bloc Current Date & Time avec le fuseau horaire uniquement (sans valeur d’horloge, pour la stabilité du cache)Fuseau horaire de l’hôte si userTimezone n’est pas définiagents.defaults.userTimezone
L’invite système omet délibérément l’horloge en direct afin de garder la mise en cache des invites stable entre les tours. Lorsque l’agent a besoin de l’heure actuelle, il appelle session_status.

​
Définir le fuseau horaire de l’utilisateur

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Si userTimezone n’est pas défini, OpenClaw résout le fuseau horaire de l’hôte à l’exécution (sans écriture de configuration). agents.defaults.timeFormat (auto | 12 | 24) contrôle le rendu 12 h/24 h dans les enveloppes et les surfaces en aval, pas dans la section de l’invite système.

​
Quand remplacer la valeur

  • Utilisez des enveloppes UTC (envelopeTimezone: "utc") lorsque vous voulez des horodatages stables entre des hôtes situés dans différentes régions, ou lorsque vous voulez que les journaux alignés sur UTC correspondent à la sortie de diagnostic.
  • Utilisez une zone IANA fixe (par ex. "Europe/Vienna") lorsque l’hôte du Gateway se trouve dans une zone, mais que l’utilisateur se trouve dans une autre, et que vous voulez que les enveloppes soient lues dans la zone de l’utilisateur indépendamment de la migration de l’hôte.
  • Définissez envelopeTimestamp: "off" pour des enveloppes consommant peu de jetons lorsque le contexte d’horodatage n’est pas utile à la conversation.
Pour la référence complète du comportement, des exemples par fournisseur et la mise en forme du temps écoulé, consultez Date et heure.

​
Associé

  • Date et heure — comportement complet des enveloppes, outils et invites, avec exemples.
  • Heartbeat — les heures actives utilisent le fuseau horaire pour la planification.
  • Tâches Cron — les expressions cron utilisent le fuseau horaire pour la planification.