Zonas horarias

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

Sobres de mensaje (local por defecto)

Los mensajes entrantes se envuelven en un sobre como:

[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.

Puedes sobreescribir esto con:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | zona horaria IANA
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" usa UTC.
  • envelopeTimezone: "user" usa agents.defaults.userTimezone (recurre a la zona horaria del host).
  • Usa una zona horaria IANA explícita (por ejemplo, "Europe/Vienna") para un desplazamiento fijo.
  • envelopeTimestamp: "off" elimina marcas de tiempo absolutas de los encabezados de sobre.
  • envelopeElapsed: "off" elimina 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 crudos del proveedor + campos normalizados)

Las llamadas de herramientas (channels.discord.readMessages, channels.slack.readMessages, etc.) devuelven marcas de tiempo crudas del proveedor. También adjuntamos campos normalizados para consistencia:

  • timestampMs (milisegundos UTC desde epoch)
  • timestampUtc (cadena ISO 8601 UTC)

Los campos crudos del proveedor se preservan.

Zona horaria del usuario para el system prompt

Configura agents.defaults.userTimezone para indicarle al modelo la zona horaria local del usuario. Si no está configurado, OpenClaw resuelve la zona horaria del host en runtime (sin escritura de configuración).

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

El system prompt incluye:

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

Puedes controlar el formato del prompt con agents.defaults.timeFormat (auto | 12 | 24).

Ver Date & Time para el comportamiento completo y ejemplos.