Saltar al contenido principal

Solución de problemas de canales

Use esta página cuando un canal se conecta pero el comportamiento es incorrecto.

Escalera de comandos

Ejecute estos en orden primero:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Línea base saludable:
  • Runtime: running
  • RPC probe: ok
  • El sondeo del canal muestra conectado/listo

WhatsApp

Firmas de fallas de WhatsApp

SíntomaVerificación más rápidaSolución
Conectado pero sin respuestas en mensajes directosopenclaw pairing list whatsappAprobar remitente o cambiar la política de mensajes directos/lista de permitidos.
Mensajes de grupo ignoradosVerifique requireMention + patrones de mención en la configuraciónMencione al bot o relaje la política de menciones para ese grupo.
Desconexiones aleatorias/bucles de reingresoopenclaw channels status --probe + registrosVuelva a iniciar sesión y verifique que el directorio de credenciales esté saludable.
Solución de problemas completa: /channels/whatsapp#troubleshooting-quick

Telegram

Firmas de fallas de Telegram

SíntomaVerificación más rápidaSolución
/start pero sin flujo de respuestas utilizableopenclaw pairing list telegramAprobar emparejamiento o cambiar la política de mensajes directos.
Bot en línea pero el grupo permanece en silencioVerifique el requisito de mención y el modo de privacidad del botDesactive el modo de privacidad para visibilidad en el grupo o mencione al bot.
Fallas de envío con errores de redInspeccione los registros por fallas en llamadas a la API de TelegramCorrija el enrutamiento DNS/IPv6/proxy hacia api.telegram.org.
Actualizaste y la allowlist te bloqueaopenclaw security audit y allowlists de configuraciónEjecuta openclaw doctor --fix o reemplaza @username por IDs numéricos de remitente.
Solución de problemas completa: /channels/telegram#troubleshooting

Discord

Firmas de fallas de Discord

SíntomaVerificación más rápidaSolución
Bot en línea pero sin respuestas en servidoresopenclaw channels status --probePermita el servidor/canal y verifique el intent de contenido de mensajes.
Mensajes de grupo ignoradosRevise los registros por descartes de control de mencionesMencione al bot o configure el servidor/canal requireMention: false.
Falta respuestas DMopenclaw pairing list discordAprobar emparejamiento de DM o ajustar la política de DM.
Solución de problemas completa: /channels/discord#troubleshooting

Slack

Firmas de fallas de Slack

SíntomaVerificación más rápidaSolución
Modo socket conectado pero sin respuestasopenclaw channels status --probeVerifique el token de la app + el token del bot y los alcances requeridos.
DMs bloqueadasopenclaw pairing list slackApruebe el emparejamiento o relaje la política de mensajes directos.
Mensaje de canal ignoradoVerifique groupPolicy y la lista de permitidos del canalPermita el canal o cambie la política a open.
Solución de problemas completa: /channels/slack#troubleshooting

iMessage y BlueBubbles

Firmas de fallas de iMessage y BlueBubbles

SíntomaVerificación más rápidaSolución
Sin eventos entrantesVerifique la accesibilidad del webhook/servidor y los permisos de la appCorrija la URL del webhook o el estado del servidor de BlueBubbles.
Puede enviar pero no recibir en macOSRevise los permisos de privacidad de macOS para la automatización de MensajesVuelva a conceder los permisos TCC y reinicie el proceso del canal.
Remitente de mensajes directos bloqueadoopenclaw pairing list imessage o openclaw pairing list bluebubblesApruebe el emparejamiento o actualice la lista de permitidos.
Solución de problemas completa:

Signal

Firmas de fallas de Signal

SíntomaVerificación más rápidaSolución
Demonio accesible pero bot en silencioopenclaw channels status --probeVerifique la URL/cuenta del demonio signal-cli y el modo de recepción.
DM bloqueadaopenclaw pairing list signalApruebe al remitente o ajuste la política de mensajes directos.
Las respuestas en grupos no se activanVerifique la lista de permitidos de grupos y los patrones de menciónAgregue el remitente/grupo o relaje el control.
Solución de problemas completa: /channels/signal#troubleshooting

Matrix

Firmas de fallas de Matrix

SíntomaVerificación más rápidaSolución
Conectado pero ignora mensajes de la salaopenclaw channels status --probeVerifique groupPolicy y la lista de permitidos de salas.
Los DMs no procesanopenclaw pairing list matrixApruebe al remitente o ajuste la política de mensajes directos.
Fallas en salas cifradasVerifique el módulo de criptografía y la configuración de cifradoHabilite el soporte de cifrado y vuelva a unirse/sincronizar la sala.
Solución de problemas completa: /channels/matrix#troubleshooting