Zonas horarias

OpenClaw estandariza las marcas de tiempo para que el modelo vea una única hora de referencia.

Sobres de mensajes (locales por defecto)

Los mensajes entrantes se envuelven en un sobre de la siguiente manera:

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

La marca de tiempo en el sobre es local del host por defecto, con precisión de minutos.

Puede anular esto con:

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

envelopeTimezone: "utc" usa UTC.
envelopeTimezone: "user" usa agents.defaults.userTimezone (fallback a la zona horaria del host).
Use una zona horaria IANA explícita (ej., "Europe/Vienna") para un desplazamiento fijo.
envelopeTimestamp: "off" elimina las marcas de tiempo absolutas de los encabezados del sobre.
envelopeElapsed: "off" elimina los sufijos de tiempo transcurrido (el estilo +2m).

Ejemplos

Local (por defecto):

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

Zona horaria fija:

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

Tiempo transcurrido:

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

Payloads de herramientas (datos sin procesar del proveedor + campos normalizados)

Las llamadas a herramientas (channels.discord.readMessages, channels.slack.readMessages, etc.) devuelven marcas de tiempo sin procesar del proveedor. También adjuntamos campos normalizados para mayor coherencia:

timestampMs (milisegundos de época UTC)
timestampUtc (cadena ISO 8601 UTC)

Se conservan los campos sin procesar del proveedor.

Zona horaria del usuario para el aviso del sistema

Establezca agents.defaults.userTimezone para indicar al modelo la zona horaria local del usuario. Si no está establecido, OpenClaw resuelve la zona horaria del host en tiempo de ejecución (sin escritura de configuración).

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

El aviso del sistema incluye:

Sección Current Date & Time con la hora local y la zona horaria
Time format: 12-hour o 24-hour

Puede controlar el formato del aviso con agents.defaults.timeFormat (auto | 12 | 24).

Consulte Fecha y hora para conocer el comportamiento completo y los ejemplos.

Relacionado

Heartbeat — las horas activas usan la zona horaria para la programación
Cron Jobs — las expresiones cron usan la zona horaria para la programación
Date & Time — comportamiento completo de fecha/hora y ejemplos