Saltar al contenido 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 estandariza las marcas de tiempo para que el modelo vea una única hora de referencia en lugar de una mezcla de relojes locales del proveedor. Hay tres superficies donde aparecen las zonas horarias, cada una con su propio propósito:

​
Tres superficies de zona horaria

SuperficieQué muestraPredeterminadoConfigurado mediante
Envoltorios de mensajesEnvuelven los mensajes entrantes del canal: [Signal +1555 2026-01-18 00:19 PST] helloLocal del hostagents.defaults.envelopeTimezone
Cargas útiles de herramientasLas herramientas de estilo readMessages del canal devuelven la hora sin procesar del proveedor + timestampMs / timestampUtc normalizadosLos campos UTC siempre están presentesNo configurable — conserva las marcas de tiempo nativas del proveedor
Prompt del sistemaUn pequeño bloque Current Date & Time con solo la zona horaria (sin valor de reloj, para estabilidad de caché)Zona horaria del host si userTimezone no está definidoagents.defaults.userTimezone
El prompt del sistema omite deliberadamente el reloj en vivo para mantener estable el almacenamiento en caché del prompt entre turnos. Cuando el agente necesita la hora actual, llama a session_status.

​
Configurar la zona horaria del usuario

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Si userTimezone no está definido, OpenClaw resuelve la zona horaria del host en tiempo de ejecución (sin escribir configuración). agents.defaults.timeFormat (auto | 12 | 24) controla la representación en formato de 12 h/24 h en envoltorios y superficies posteriores, no en la sección del prompt del sistema.

​
Cuándo sobrescribir

  • Usa envoltorios UTC (envelopeTimezone: "utc") cuando quieras marcas de tiempo estables entre hosts de distintas regiones, o cuando quieras que los registros alineados con UTC coincidan con la salida de diagnóstico.
  • Usa una zona IANA fija (por ejemplo, "Europe/Vienna") cuando el host del Gateway esté en una zona pero el usuario esté en otra y quieras que los envoltorios se lean en la zona del usuario independientemente de la migración del host.
  • Configura envelopeTimestamp: "off" para envoltorios de bajo consumo de tokens cuando el contexto de marca de tiempo no sea útil para la conversación.
Para ver la referencia completa del comportamiento, ejemplos por proveedor y formato de tiempo transcurrido, consulta Fecha y hora.

​
Relacionado

  • Fecha y hora — comportamiento y ejemplos completos de envoltorios/herramientas/prompts.
  • Heartbeat — las horas activas usan la zona horaria para la programación.
  • Trabajos Cron — las expresiones Cron usan la zona horaria para la programación.