Aller au contenu
Guides

Les fuseaux horaires dans OpenClaw

Les trois surfaces qui affichent une heure, un seul réglage de fuseau utilisateur, et pourquoi l’horloge en direct reste hors du prompt

4 min de lecture

Chaque canal a sa propre idée de l’heure, et un modèle nourri d’un mélange d’horloges locales de fournisseurs fait des erreurs de date. OpenClaw normalise les horodatages pour que le modèle voie un seul temps de référence. La documentation décrit trois surfaces où un fuseau horaire apparaît, chacune avec sa raison d’être, et un seul réglage qui en gouverne deux. Voici les surfaces, le réglage, comment le fuseau de l’hôte est résolu quand rien n’est configuré, pourquoi la date vit sous la frontière de cache du prompt, et pourquoi l’horloge en direct est volontairement laissée de côté.

Trois surfaces

  • Les enveloppes de messages entourent les messages entrants des canaux avec le canal, l’expéditeur, le jour de la semaine, la date, l’heure et l’abréviation du fuseau, dans le fuseau de l’hôte sauf si un fuseau utilisateur est défini.
  • Les charges des outils de lecture de messages des canaux renvoient l’heure brute du fournisseur plus des champs UTC normalisés, un horodatage en millisecondes et une chaîne UTC, toujours présents et non configurables, si bien que les horodatages natifs du fournisseur sont préservés.
  • Le prompt système porte un bloc volatile de contexte temporel avec la date locale et le fuseau, là encore dans le fuseau de l’hôte sauf si un fuseau utilisateur est défini ; l’heure exacte reste adossée à un outil.
  • Le rendu de l’horloge suit le système d’exploitation de l’hôte et la préférence de locale ; il n’y a pas de réglage séparé douze heures ou vingt-quatre heures.
OpenClaw normalise les horodatages pour que le modèle voie un seul temps de référence au lieu d’un mélange d’horloges locales des fournisseurs.

Un seul réglage

Le fuseau utilisateur se fixe dans les valeurs par défaut des agents sous la forme d’un nom de zone IANA tel qu’America/Chicago. Quand il n’est pas défini, OpenClaw résout le fuseau de l’hôte à l’exécution par l’API internationale de formatage de dates de la plateforme, sans rien écrire dans la configuration, et le même fuseau résolu sert aux enveloppes de messages, aux événements système en file, à la date locale du prompt et aux heures actives du battement de cœur. Fixer le fuseau une fois change donc ce que le modèle lit dans les enveloppes, la date qu’il croit être celle du jour, les moments où les battements de cœur peuvent se déclencher, et l’interprétation des expressions cron.

Pourquoi l’horloge reste dehors

  • La date et le fuseau vivent sous la frontière de cache du prompt système, si bien qu’un changement de jour n’invalide pas le préfixe stable que le fournisseur a mis en cache.
  • Le prompt omet volontairement l’horloge en direct ; quand l’agent a besoin de l’heure exacte et que l’outil d’état de session est disponible, il appelle cet outil.
  • Parce que l’enveloppe porte son propre horodatage par message, le modèle peut encore raisonner sur le temps écoulé entre les tours sans horloge qui tourne dans le prompt.

Le battement de cœur d’OpenClaw est là où les heures actives lisent le fuseau, et Les automatisations d’OpenClaw là où les expressions cron le font.

Le côté prompt

Le prompt système d’OpenClaw explique la section de contexte temporel qui porte la date et le fuseau locaux de l’utilisateur dans le prompt, et Fenêtre de contexte et compaction dans OpenClaw la frontière de cache sous laquelle la date est placée.

Sur Diali

Sur Diali, le fuseau choisi à l’intégration est celui avec lequel l’assistant tourne, si bien que les enveloppes, la date locale du prompt et les heures actives du battement de cœur vous suivent plutôt que l’horloge du conteneur. OpenClaw hébergé sur Diali est l’assistant.

  • Trois surfaces, un seul temps de référence.
  • Un seul réglage déplace ensemble enveloppes, date du prompt, battements de cœur et cron.
  • La date est en cache sous la frontière ; l’horloge est un appel d’outil.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.