Resolución de problemas de canales

Usa esta página cuando un canal se conecta pero el comportamiento no es correcto.

Secuencia de comandos

Ejecuta estos en orden primero:

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

Línea base saludable:

Síntoma	Verificación rápida	Solución
Conectado pero sin respuestas DM	`openclaw pairing list whatsapp`	Aprueba al remitente o cambia la política/lista de acceso de DM.
Mensajes de grupo ignorados	Verifica `requireMention` + patrones de mención	Menciona al bot o relaja la política de mención para ese grupo.
Desconexiones aleatorias/bucles	`openclaw channels status --probe` + logs	Vuelve a iniciar sesión y verifica que el directorio de credenciales sea correcto.

Síntoma	Verificación rápida	Solución
`/start` pero sin flujo de respuesta	`openclaw pairing list telegram`	Aprueba el emparejamiento o cambia la política de DM.
Bot en línea pero grupo silencioso	Verifica requisito de mención y modo de privacidad	Desactiva el modo de privacidad para visibilidad en grupo o menciona al bot.
Fallos de envío con errores de red	Inspecciona logs de llamadas a la API de Telegram	Corrige DNS/IPv6/proxy hacia `api.telegram.org`.
`setMyCommands` rechazado al inicio	Inspecciona logs por `BOT_COMMANDS_TOO_MUCH`	Reduce los comandos de plugin/skill/custom de Telegram o desactiva los menús nativos.
Actualizado y la lista de acceso bloquea	`openclaw security audit` y listas de acceso	Ejecuta `openclaw doctor --fix` o reemplaza `@username` con IDs numéricos.

Síntoma	Verificación rápida	Solución
Bot en línea pero sin respuestas guild	`openclaw channels status --probe`	Permite guild/canal y verifica el intent de contenido de mensajes.
Mensajes de grupo ignorados	Verifica logs por caídas de mención	Menciona al bot o configura `requireMention: false` en guild/canal.
Respuestas DM faltantes	`openclaw pairing list discord`	Aprueba el emparejamiento DM o ajusta la política de DM.

Síntoma	Verificación rápida	Solución
Socket mode conectado pero sin respuestas	`openclaw channels status --probe`	Verifica app token + bot token y los scopes requeridos.
DMs bloqueados	`openclaw pairing list slack`	Aprueba el emparejamiento o relaja la política de DM.
Mensaje de canal ignorado	Verifica `groupPolicy` y lista de canales	Permite el canal o cambia la política a `open`.

Síntoma	Verificación rápida	Solución
Sin eventos entrantes	Verifica la accesibilidad del webhook/servidor y permisos de la app	Corrige la URL del webhook o el estado del servidor BlueBubbles.
Puede enviar pero no recibir en macOS	Verifica permisos de privacidad de macOS para automatización de Messages	Vuelve a otorgar permisos TCC y reinicia el proceso del canal.
Remitente DM bloqueado	`openclaw pairing list imessage` u `openclaw pairing list bluebubbles`	Aprueba el emparejamiento o actualiza la lista de acceso.

Resolución completa:

Síntoma	Verificación rápida	Solución
Daemon accesible pero bot silencioso	`openclaw channels status --probe`	Verifica URL/cuenta del daemon `signal-cli` y modo de recepción.
DM bloqueado	`openclaw pairing list signal`	Aprueba al remitente o ajusta la política de DM.
Respuestas de grupo no se activan	Verifica lista de grupos y patrones de mención	Añade remitente/grupo o relaja las restricciones.

Síntoma	Verificación rápida	Solución
Conectado pero ignora mensajes de sala	`openclaw channels status --probe`	Verifica `groupPolicy` y la lista de acceso de salas.
DMs no se procesan	`openclaw pairing list matrix`	Aprueba al remitente o ajusta la política de DM.
Salas cifradas fallan	Verifica módulo crypto y configuración de cifrado	Habilita el soporte de cifrado y vuelve a unirte/sincroniza la sala.