Fecha y hora

OpenClaw usa la hora local del host para las marcas de tiempo del transporte e incluye solo la zona horaria en el prompt del sistema. Las marcas de tiempo del proveedor se conservan para que las herramientas mantengan su semántica nativa. Cuando el agente necesita la hora actual, ejecuta la herramienta session_status.

Envoltorios de mensajes (locales de forma predeterminada)

Los mensajes entrantes se envuelven con un día de la semana y una marca de tiempo con precisión de segundos:

[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] texto del mensaje

La marca de tiempo del envoltorio usa la hora local del host de forma predeterminada, independientemente de la zona horaria del proveedor. Se puede anular en agents.defaults:

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

Clave	Valores	Comportamiento
`envelopeTimezone`	`local` (predeterminado), `utc`, `user`, nombre IANA explícito	`user` usa `agents.defaults.userTimezone` (la zona horaria del host cuando no está configurada). Un nombre IANA explícito (p. ej., `"America/Chicago"`) fija una zona determinada; los nombres no reconocidos recurren a UTC.
`envelopeTimestamp`	`on` (predeterminado), `off`	`off` elimina las marcas de tiempo absolutas de los encabezados de los envoltorios, los prefijos directos del prompt del agente y los prefijos incrustados de la entrada del modelo.
`envelopeElapsed`	`on` (predeterminado), `off`	`off` elimina el sufijo de tiempo transcurrido (con el estilo `+30s` / `+2m`) que se muestra desde el mensaje anterior de la sesión.

Ejemplos

Local (predeterminado):

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

Zona horaria del usuario:

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

Tiempo transcurrido con envelopeTimezone: "utc":

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] seguimiento

Prompt del sistema: fecha y hora actuales

El prompt del sistema incluye una sección Fecha y hora actuales con solo la zona horaria (sin reloj ni formato de hora) para que el almacenamiento en caché del prompt se mantenga estable:

Zona horaria: America/Chicago

La zona es agents.defaults.userTimezone cuando está configurada; de lo contrario, se usa la zona horaria del host. El prompt también indica al agente que ejecute la herramienta session_status siempre que necesite la fecha, la hora o el día de la semana actuales.

Líneas de eventos del sistema (locales de forma predeterminada)

Los eventos del sistema en cola insertados en el contexto del agente llevan como prefijo una marca de tiempo que utiliza la misma selección envelopeTimezone que los sobres de mensajes (valor predeterminado: hora local del host).

System: [2026-01-12 12:19:17 PST] Se cambió el modelo.

Configurar la zona horaria y el formato del usuario

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

userTimezone establece la zona horaria local del usuario para el contexto del prompt (y para envelopeTimezone: "user").
timeFormat controla la visualización en formato de 12 h/24 h en las horas mostradas en el prompt. auto sigue las preferencias del sistema operativo.

Detección del formato de hora (automática)

Cuando timeFormat: "auto", OpenClaw consulta la preferencia del sistema operativo (macOS y Windows) y, como alternativa, utiliza el formato de la configuración regional. El valor detectado se almacena en caché por proceso para evitar llamadas repetidas al sistema.

Cargas útiles de herramientas + conectores (hora sin procesar del proveedor + campos normalizados)

Las herramientas de los canales devuelven marcas de tiempo nativas del proveedor y añaden campos normalizados para mantener la coherencia:

timestampMs: milisegundos desde la época (UTC)
timestampUtc: cadena UTC en formato ISO 8601

Los campos sin procesar del proveedor se conservan para que no se pierda nada.

Discord: marcas de tiempo ISO en UTC
Slack: cadenas similares a valores de época procedentes de la API
Telegram/WhatsApp: marcas de tiempo numéricas o ISO específicas del proveedor

Si se necesita la hora local, debe convertirse posteriormente utilizando la zona horaria conocida.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Envoltorios de mensajes (locales de forma predeterminada)

Ejemplos

Prompt del sistema: fecha y hora actuales

Líneas de eventos del sistema (locales de forma predeterminada)

Configurar la zona horaria y el formato del usuario

Detección del formato de hora (automática)

Cargas útiles de herramientas + conectores (hora sin procesar del proveedor + campos normalizados)

Documentación relacionada

​Envoltorios de mensajes (locales de forma predeterminada)

​Ejemplos

​Prompt del sistema: fecha y hora actuales

​Líneas de eventos del sistema (locales de forma predeterminada)

​Configurar la zona horaria y el formato del usuario

​Detección del formato de hora (automática)

​Cargas útiles de herramientas + conectores (hora sin procesar del proveedor + campos normalizados)

​Documentación relacionada

Envoltorios de mensajes (locales de forma predeterminada)

Ejemplos

Prompt del sistema: fecha y hora actuales

Líneas de eventos del sistema (locales de forma predeterminada)

Configurar la zona horaria y el formato del usuario

Detección del formato de hora (automática)

Cargas útiles de herramientas + conectores (hora sin procesar del proveedor + campos normalizados)

Documentación relacionada