Configura políticas de reintento en OpenClaw

¿Alguna vez has visto cómo falla un envío de mensaje solo por un micro-corte de red o un rate limit inesperado? Es molesto tener que gestionar cada error manualmente para que tu bot no se detenga. La mejor solución es dejar que el sistema gestione estos fallos temporales de forma automática para que tú te centres en la lógica de tu aplicación.

OpenClaw incluye un sistema de reintentos diseñado para ser predecible. La recomendación es usar la configuración por defecto, ya que equilibra la velocidad de respuesta con el respeto a los límites de las API de cada Provider.

Requisitos previos

• Tener OpenClaw instalado y funcionando.
• Acceso al archivo de configuración ~/.openclaw/openclaw.json.

Inicio rápido

Configura tu política de reintentos en menos de 5 minutos siguiendo estos pasos:

1. Localiza o crea el archivo ~/.openclaw/openclaw.json en tu sistema.
2. Define los parámetros de retry dentro de cada canal (Telegram o Discord).
3. Ajusta los valores de intentos y retardos según tus necesidades.
4. Reinicia tu instancia de OpenClaw para aplicar los cambios.

Aquí tienes el bloque de configuración completo que puedes copiar:

{
  "channels": {
    "telegram": {
      "retry": {
        "attempts": 3,
        "minDelayMs": 400,
        "maxDelayMs": 30000,
        "jitter": 0.1,
      },
    },
    "discord": {
      "retry": {
        "attempts": 3,
        "minDelayMs": 500,
        "maxDelayMs": 30000,
        "jitter": 0.1,
      },
    },
  },
}

Solución de problemas

Si encuentras problemas con los reintentos, revisa estos comportamientos específicos:

• Errores de Markdown en Telegram: Si Telegram devuelve un error de parseo de Markdown, el sistema no reintentará la petición. En su lugar, enviará el mensaje como texto plano automáticamente.
• Discord y errores HTTP: Discord solo aplica reintentos cuando recibe un error de rate-limit (HTTP 429). Otros errores no activarán la política de reintentos.
• Uso de retry_after: Tanto Telegram como Discord usarán el valor retry_after proporcionado por la API si está disponible. Si no existe, se usará el backoff exponencial configurado.
• Operaciones no idempotentes: Los reintentos se aplican por cada HTTP request individual (como enviar un mensaje o subir un archivo). Si tienes un flujo compuesto, los pasos que ya terminaron con éxito no se repetirán.

AI Setup Assistant

Próximos pasos

• Configuración de canales
• Gestión de errores en la API