Comprobaciones de estado

​

Comprobaciones rápidas

• openclaw status - resumen local: accesibilidad/modo del gateway, sugerencia de actualización, antigüedad de autenticación de canales vinculados, sesiones + actividad reciente.
• openclaw status --all - diagnóstico local completo (solo lectura, color, seguro para pegar al depurar).
• openclaw status --deep - consulta al Gateway en ejecución para una prueba en vivo (health con probe:true), incluidas pruebas de canal por cuenta cuando sean compatibles.
• openclaw status --usage - muestra instantáneas de uso/cuota del proveedor de modelos.
• openclaw health - consulta al Gateway en ejecución su instantánea de estado (solo WS; sin sockets de canal directos desde la CLI).
• openclaw health --verbose (alias --debug) - fuerza una prueba de estado en vivo e imprime detalles de conexión del gateway.
• openclaw health --json - salida de instantánea de estado legible por máquina.
• Envía /status como comando de chat independiente en cualquier canal para obtener una respuesta de estado sin invocar al agente.
• Registros: sigue /tmp/openclaw/openclaw-*.log y filtra por web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

​

Diagnósticos profundos

• Credenciales en disco: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime debería ser reciente).
• Almacén de sesiones: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (la ruta puede sobrescribirse en la configuración). El recuento y los destinatarios recientes se muestran mediante status.
• Flujo de revinculación: openclaw channels logout && openclaw channels login --verbose cuando aparezcan códigos de estado 409-515 o loggedOut en los registros. El flujo de inicio de sesión por QR se reinicia automáticamente una vez para el estado 515 después del emparejamiento.
• Los diagnósticos están habilitados de forma predeterminada (diagnostics.enabled: false los deshabilita). Los eventos de memoria registran recuentos de bytes RSS/heap y presión de umbral/crecimiento; la presión crítica de memoria se registra mediante el logger del gateway y, cuando diagnostics.memoryPressureSnapshot: true está configurado, también escribe un paquete de estabilidad previo a OOM (estadísticas del heap de V8, contadores de cgroup de Linux cuando estén disponibles, recuentos de recursos activos, archivos de sesión/transcripción más grandes por ruta relativa redactada). Las advertencias de actividad registran retraso/utilización del bucle de eventos, proporción de núcleos de CPU y recuentos de sesiones activas/en espera/en cola cuando el proceso se está ejecutando pero está saturado. Los eventos de carga útil sobredimensionada registran qué se rechazó/truncó/dividió en fragmentos, además de tamaños y límites; nunca texto de mensajes, contenido de adjuntos, cuerpos de Webhook, cuerpos sin procesar de solicitudes/respuestas, tokens, cookies ni valores secretos.
• El mismo Heartbeat impulsa el registrador de estabilidad acotado: openclaw gateway stability (o el RPC diagnostics.stability del Gateway). Las salidas fatales del Gateway, los tiempos de espera de apagado, los fallos de inicio tras reinicio y (cuando diagnostics.memoryPressureSnapshot: true) la presión crítica de memoria persisten la instantánea más reciente en ~/.openclaw/logs/stability/. Inspecciona el paquete más reciente con openclaw gateway stability --bundle latest.
• Para informes de errores, ejecuta openclaw gateway diagnostics export y adjunta el zip generado: un resumen en Markdown, el paquete de estabilidad más reciente, metadatos de registro saneados, instantáneas saneadas de estado/salud del Gateway y la forma de configuración. Se omiten o redactan texto de chat, cuerpos de Webhook, salidas de herramientas, credenciales, cookies, identificadores de cuenta/mensaje y valores secretos. Consulta Exportación de diagnósticos.

​

Configuración del monitor de salud

• gateway.channelHealthCheckMinutes: frecuencia con la que el gateway comprueba la salud de los canales. Predeterminado: 5. Establece 0 para deshabilitar globalmente los reinicios del monitor de salud.
• gateway.channelStaleEventThresholdMinutes: cuánto tiempo puede permanecer inactivo un canal conectado antes de que el monitor de salud lo considere obsoleto y lo reinicie. Predeterminado: 30. Mantén esto mayor o igual que gateway.channelHealthCheckMinutes.
• gateway.channelMaxRestartsPerHour: límite móvil de una hora para reinicios del monitor de salud por canal/cuenta. Predeterminado: 10.
• channels.<provider>.healthMonitor.enabled: deshabilita los reinicios del monitor de salud para un canal específico mientras dejas habilitada la monitorización global.
• channels.<provider>.accounts.<accountId>.healthMonitor.enabled: sobrescritura multicuenta que prevalece sobre la configuración de nivel de canal.
• Estas sobrescrituras por canal se aplican a los canales integrados que las exponen hoy: Discord, Google Chat, iMessage, IRC, Microsoft Teams, Signal, Slack, Telegram y WhatsApp.

​

Monitorización de tiempo de actividad

• USA: GET /health - respuesta instantánea, no se crea ninguna sesión, no hay llamada a LLM, devuelve {"ok":true,"status":"live"}
• NO uses: /v1/chat/completions para comprobaciones de salud - cada solicitud crea una sesión completa de agente con instantánea de Skills, ensamblaje de contexto y llamadas a LLM

​

Ejemplos de configuración de servicios de monitorización

• BetterStack: Configura la URL de comprobación de salud en https://<your-gateway-host>:<port>/health
• UptimeRobot: Añade un nuevo monitor HTTP con la URL https://<your-gateway-host>:<port>/health
• Genérico: Cualquier GET HTTP a /health devuelve 200 con {"ok":true} cuando el gateway está saludable

​

Cuando algo falla

• logged out o estado 409-515 -> revincula con openclaw channels logout y luego openclaw channels login.
• Gateway inaccesible -> inícialo: openclaw gateway --port 18789 (usa --force si el puerto está ocupado).
• Sin mensajes entrantes -> confirma que el teléfono vinculado está en línea y que el remitente está permitido (channels.whatsapp.allowFrom); para chats de grupo, asegúrate de que la lista de permitidos + las reglas de mención coincidan (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

​

Comando “health” dedicado

• --json: salida JSON legible por máquina
• --timeout <ms>: sobrescribe el tiempo de espera predeterminado de prueba de 10 s
• --verbose: fuerza una prueba en vivo e imprime detalles de conexión del gateway
• --debug: alias de --verbose

​

Relacionado

• Runbook del Gateway
• Exportación de diagnósticos
• Solución de problemas del Gateway