Configura zonas horarias en OpenClaw: Guía de integración

¿Alguna vez has intentado que un modelo de IA entienda una secuencia de eventos cuando los timestamps vienen de tres zonas horarias distintas? Es un caos que suele terminar con el modelo alucinando sobre el orden de los mensajes. OpenClaw soluciona esto estandarizando los timestamps para que el modelo vea una referencia de tiempo única y coherente.

Timezones

OpenClaw estandariza los timestamps para que el modelo vea una referencia de tiempo única.

Envoltorios de mensajes (local por defecto)

Los mensajes entrantes se envuelven en un “envelope” como este:

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

El timestamp en el envoltorio es local del host por defecto, con precisión de minutos.

Puedes sobrescribir 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 (si no está definido, usa la del host).
• Usa una zona horaria IANA explícita (por ejemplo, "Europe/Vienna") para un offset fijo.
• envelopeTimestamp: "off" elimina los timestamps absolutos de las cabeceras del envoltorio.
• 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 crudos del proveedor + campos normalizados)

Las llamadas a herramientas (channels.discord.readMessages, channels.slack.readMessages, etc.) devuelven timestamps crudos del proveedor. También adjuntamos campos normalizados para mantener la consistencia:

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

Los campos originales del proveedor se mantienen intactos.

Zona horaria del usuario para el system prompt

Configura agents.defaults.userTimezone para decirle al modelo cuál es la zona horaria local del usuario. Si no se define, OpenClaw resuelve la zona horaria del host en tiempo de ejecución (sin escribir en la configuración).

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

El system prompt incluye:

• Una sección Current Date & Time con la hora local y la zona horaria.
• El formato de hora: Time format: 12-hour o 24-hour.

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

Consulta Date & Time para ver el comportamiento completo y más 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.

Pasos siguientes

• Configura tu primer Cron Job para automatizar tareas.
• Revisa cómo funciona el Gateway para gestionar la disponibilidad de tus agentes.

AI Setup Assistant