Cómo manejar fechas y horas en OpenClaw

Manejar zonas horarias suele ser un caos cuando trabajas con diferentes plataformas. Recibes un mensaje de un usuario en un país, tu servidor está en otro y los logs terminan siendo imposibles de leer. Si no configuras esto bien, pierdes el hilo de la conversación y el contexto temporal de los eventos.

Para evitar confusiones, es mejor que definas cómo quieres que OpenClaw trate el tiempo desde el principio.

Requisitos previos

• Acceso al archivo de configuración de OpenClaw.
• Identificar tu zona horaria IANA (ej. America/Chicago).

Inicio rápido

OpenClaw usa por defecto la hora del host para los timestamps de transporte. Para ajustar la zona horaria del usuario y el formato en el system prompt, añade esto a tu configuración:

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

Si quieres cambiar el comportamiento de los mensajes entrantes (envelopes), usa estas opciones:

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

Con envelopeTimezone: "user", el sistema usará el valor de userTimezone. Si prefieres ver el tiempo transcurrido (estilo +30s), asegúrate de que envelopeElapsed esté en on.

Solución de problemas

• El agente no conoce la hora exacta actual El system prompt solo incluye la zona horaria para que el caché de los prompts sea estable. Si el agente necesita saber la hora exacta, debe usar el tool session_status, que incluye un timestamp actualizado.

• El formato de 12h/24h no coincide con tu preferencia Aunque timeFormat: "auto" intenta detectar la configuración de tu sistema operativo, puedes forzarlo usando 12 o 24 en la configuración de los agentes.

Si tienes dudas sobre la integración con proveedores específicos como Slack o Discord, consulta al AI Setup Assistant.

Próximos pasos

• System Prompt
• Timezones
• Messages