Solución de problemas en OpenClaw

Pasas tiempo configurando tu entorno y, cuando por fin vas a probarlo, algo falla. No hay mensajes, la interfaz no carga o el servicio simplemente no arranca. Es ese momento de fricción donde necesitas respuestas claras para volver a programar sin perderte en logs infinitos.

Cuando las cosas no funcionan como esperas, lo mejor es mantener la calma y seguir una ruta de diagnóstico lógica. Aquí tienes cómo identificar qué está pasando con tu instancia de OpenClaw en pocos minutos.

Requisitos previos

OpenClaw instalado y acceso a la CLI.
Permisos para ejecutar comandos de diagnóstico en tu terminal.

Inicio rápido

Si solo tienes 2 minutos, usa esta secuencia de comandos como puerta de entrada para el triaje. Ejecuta esta escalera de comandos en orden:

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Sabrás que todo va bien si ves estos resultados:

openclaw status: Muestra los canales configurados sin errores de autenticación.
openclaw status --all: El reporte completo está presente y listo para compartir.
openclaw gateway probe: El objetivo del Gateway es alcanzable.
openclaw gateway status: Indica Runtime: running y RPC probe: ok.
openclaw doctor: No hay errores de configuración o servicios bloqueados.
openclaw channels status --probe: Los canales reportan connected o ready.
openclaw logs --follow: Actividad constante sin errores fatales repetitivos.

Solución de problemas

Usa este árbol de decisión para identificar el componente que falla:

flowchart TD
  A[OpenClaw is not working] --> B{What breaks first}
  B --> C[No replies]
  B --> D[Dashboard or Control UI will not connect]
  B --> E[Gateway will not start or service not running]
  B --> F[Channel connects but messages do not flow]
  B --> G[Cron or heartbeat did not fire or did not deliver]
  B --> H[Node is paired but camera canvas screen exec fails]
  B --> I[Browser tool fails]

  C --> C1[/No replies section/]
  D --> D1[/Control UI section/]
  E --> E1[/Gateway section/]
  F --> F1[/Channel flow section/]
  G --> G1[/Automation section/]
  H --> H1[/Node tools section/]
  I --> I1[/Browser section/]

No hay respuestas

Si el sistema no responde, ejecuta:

openclaw status
openclaw gateway status
openclaw channels status --probe
openclaw pairing list <channel>
openclaw logs --follow

Signos de éxito: Runtime: running, RPC probe: ok, y tu canal aparece como connected. Errores comunes en logs:

drop guild message (mention required): El bloqueo por mención detuvo el mensaje en Discord.
pairing request: El remitente no está aprobado y espera aprobación de pairing por DM.
blocked / allowlist: El remitente o el grupo están filtrados.

Dashboard o Control UI no conectan

Si no puedes ver la interfaz, prueba esto:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

Signos de éxito: Dashboard: http://... se muestra en el status y no hay bucles de autenticación. Errores comunes en logs:

device identity required: El contexto HTTP o no seguro impide la autenticación del dispositivo.
unauthorized: Token incorrecto o desajuste en el modo de autenticación.
gateway connect failed:: La UI apunta a una URL/puerto incorrecto o el Gateway es inalcanzable.

El Gateway no arranca

Si el servicio está instalado pero no corre:

openclaw status
openclaw gateway status
openclaw logs --follow

Signos de éxito: Service: ... (loaded) y Runtime: running. Errores comunes en logs:

Gateway start blocked: set gateway.mode=local: El modo del Gateway no está definido.
refusing to bind gateway ... without auth: Intento de bind no local sin token o contraseña.
EADDRINUSE: El puerto ya está ocupado por otra instancia.

El Channel conecta pero no fluyen mensajes

Si la conexión existe pero no hay actividad:

openclaw status
openclaw channels status --probe
openclaw logs --follow

Signos de éxito: El transporte del canal está conectado y los checks de allowlist pasan. Errores comunes en logs:

mention required: Falta la mención necesaria en el grupo.
pairing / pending: El remitente del DM aún no ha sido aprobado.
not_in_channel, 401/403: Problemas de permisos o scopes en el token del canal.

Cron o Heartbeat no se activan

Para problemas de automatización y tareas programadas:

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20

Signos de éxito: cron.status muestra que está habilitado y hay ejecuciones recientes con estado ok. Errores comunes en logs:

cron: scheduler disabled: Las tareas no se ejecutarán automáticamente.
heartbeat skipped (reason=quiet-hours): Estás fuera de las horas activas configuradas.
unknown accountId: El destino del heartbeat no existe.

El Node está emparejado pero la herramienta falla

Si falla la ejecución de herramientas como camera o canvas:

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw logs --follow

Signos de éxito: El Node aparece conectado con el rol node y tiene los permisos concedidos. Errores comunes en logs:

NODE_BACKGROUND_UNAVAILABLE: Debes poner la app del Node en primer plano.
SYSTEM_RUN_DENIED: approval required: La aprobación de ejecución está pendiente.

La herramienta de Browser falla

Si tienes problemas con el navegador:

openclaw browser status
openclaw logs --follow
openclaw doctor

Signos de éxito: running: true y un perfil de navegador seleccionado. Errores comunes en logs:

Failed to start Chrome CDP on port: Fallo al lanzar el navegador local.
browser.executablePath not found: La ruta al binario es incorrecta.
Chrome extension relay is running, but no tab is connected: La extensión no está vinculada a ninguna pestaña.

¿Necesitas ayuda personalizada para tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

OpenClaw Expert

Sigues atascado?

Si esta pagina no resolvio tu caso, pregunta a OpenClaw Expert para pasos concretos.