Zonas horarias¶

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

Sobres de mensajes (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.

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 (vuelve a la zona horaria del host).
• Use una zona horaria IANA explícita (p. ej., "Europe/Vienna") para un desfase 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

Cargas útiles 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 mantener la consistencia:

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

Se conservan los campos sin procesar del proveedor.

Zona horaria del usuario para el prompt del sistema¶

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

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

El prompt 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 prompt con agents.defaults.timeFormat (auto | 12 | 24).

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