Solución de problemas de canales

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

# Escalera de comandos

Ejecuta estos comandos en orden primero:

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

Línea base saludable:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only, write-capable, o admin-capable
• La prueba del canal muestra el transporte conectado y, donde sea compatible, works o audit ok

# WhatsApp

# Firmas de fallo de WhatsApp

Síntoma	Comprobación más rápida	Corrección
Conectado, pero sin respuestas por mensajes directos	openclaw pairing list whatsapp	Aprueba el remitente o cambia la política/lista de permitidos de mensajes directos.
Mensajes de grupo ignorados	Revisa requireMention + patrones de mención en la configuración	Menciona al bot o relaja la política de menciones para ese grupo.
El inicio de sesión con QR agota el tiempo con 408	Revisa el entorno HTTPS_PROXY / HTTP_PROXY del Gateway	Configura un proxy accesible; usa NO_PROXY solo para omisiones.
Bucles aleatorios de desconexión/reinicio de sesión	openclaw channels status --probe + registros	Las reconexiones recientes se marcan incluso cuando actualmente está conectado; observa los registros, reinicia el Gateway y vuelve a vincular si las fluctuaciones continúan.
Las respuestas llegan segundos/minutos tarde	openclaw doctor --fix	Doctor detiene clientes TUI locales obsoletos verificados cuando degradan el bucle de eventos del Gateway.

Solución de problemas completa: solución de problemas de WhatsApp

# Telegram

# Firmas de fallo de Telegram

Síntoma	Comprobación más rápida	Corrección
/start, pero sin flujo de respuesta usable	openclaw pairing list telegram	Aprueba el emparejamiento o cambia la política de mensajes directos.
Bot en línea, pero el grupo permanece en silencio	Verifica el requisito de mención y el modo de privacidad del bot	Desactiva el modo de privacidad para visibilidad en grupos o menciona al bot.
Fallos de envío con errores de red	Inspecciona los registros en busca de fallos de llamadas a la API de Telegram	Corrige el enrutamiento DNS/IPv6/proxy hacia api.telegram.org.
El inicio informa getMe returned 401	Revisa el origen del token configurado	Vuelve a copiar o regenera el token de BotFather y actualiza botToken, tokenFile o TELEGRAM_BOT_TOKEN de la cuenta predeterminada.
El sondeo se bloquea o reconecta lentamente	openclaw logs --follow para diagnósticos de sondeo	Actualiza; si los reinicios son falsos positivos, ajusta pollingStallThresholdMs. Los bloqueos persistentes siguen apuntando a proxy/DNS/IPv6.
setMyCommands rechazado al iniciar	Inspecciona los registros en busca de BOT_COMMANDS_TOO_MUCH	Reduce los comandos de Telegram de Plugin/Skill/personalizados o desactiva los menús nativos.
Actualizaste y la lista de permitidos te bloquea	openclaw security audit y listas de permitidos de configuración	Ejecuta openclaw doctor --fix o sustituye @username por IDs numéricos de remitente.

Solución de problemas completa: solución de problemas de Telegram

# Discord

# Firmas de fallo de Discord

Síntoma	Comprobación más rápida	Corrección
Bot en línea, pero sin respuestas en servidores	openclaw channels status --probe	Permite el servidor/canal y verifica la intención de contenido de mensajes.
Mensajes de grupo ignorados	Revisa los registros en busca de descartes por compuerta de mención	Menciona al bot o define requireMention: false para el servidor/canal.
Uso de escritura/token, pero sin mensaje de Discord	El registro de sesión muestra texto del asistente con didSendViaMessagingTool: false	El modelo respondió en privado en lugar de llamar a la herramienta de mensajes. Usa un modelo fiable para llamadas de herramienta o define messages.groupChat.visibleReplies: "automatic" para publicar automáticamente.
Faltan respuestas por mensajes directos	openclaw pairing list discord	Aprueba el emparejamiento de mensajes directos o ajusta la política de mensajes directos.

Solución de problemas completa: solución de problemas de Discord

# Slack

# Firmas de fallo de Slack

Síntoma	Comprobación más rápida	Corrección
Modo Socket conectado, pero sin respuestas	openclaw channels status --probe	Verifica el token de app + token de bot y los ámbitos requeridos; observa botTokenStatus / appTokenStatus = configured_unavailable en configuraciones respaldadas por SecretRef.
Mensajes directos bloqueados	openclaw pairing list slack	Aprueba el emparejamiento o relaja la política de mensajes directos.
Mensaje de canal ignorado	Revisa groupPolicy y la lista de permitidos del canal	Permite el canal o cambia la política a open.

Solución de problemas completa: solución de problemas de Slack

# iMessage y BlueBubbles

# Firmas de fallo de iMessage y BlueBubbles

Síntoma	Comprobación más rápida	Corrección
Sin eventos entrantes	Verifica la accesibilidad del Webhook/servidor y los permisos de la app	Corrige la URL del Webhook o el estado del servidor BlueBubbles.
Puede enviar, pero no recibir en macOS	Revisa los permisos de privacidad de macOS para automatización de Messages	Vuelve a conceder permisos TCC y reinicia el proceso del canal.
Remitente de mensaje directo bloqueado	openclaw pairing list imessage o openclaw pairing list bluebubbles	Aprueba el emparejamiento o actualiza la lista de permitidos.

Solución de problemas completa:

• solución de problemas de iMessage
• solución de problemas de BlueBubbles

# Signal

# Firmas de fallo de Signal

Síntoma	Comprobación más rápida	Corrección
Demonio accesible, pero bot en silencio	openclaw channels status --probe	Verifica la URL/cuenta del demonio signal-cli y el modo de recepción.
Mensaje directo bloqueado	openclaw pairing list signal	Aprueba el remitente o ajusta la política de mensajes directos.
Las respuestas de grupo no se activan	Revisa la lista de permitidos del grupo y los patrones de mención	Agrega el remitente/grupo o afloja la compuerta.

Solución de problemas completa: solución de problemas de Signal

# QQ Bot

# Firmas de fallo de QQ Bot

Síntoma	Comprobación más rápida	Corrección
Bot responde "gone to Mars"	Verifica appId y clientSecret en la configuración	Configura las credenciales o reinicia el Gateway.
Sin mensajes entrantes	openclaw channels status --probe	Verifica las credenciales en QQ Open Platform.
Voz no transcrita	Revisa la configuración del proveedor STT	Configura channels.qqbot.stt o tools.media.audio.
Mensajes proactivos no llegan	Revisa los requisitos de interacción de la plataforma QQ	QQ puede bloquear mensajes iniciados por el bot sin interacción reciente.

Solución de problemas completa: solución de problemas de QQ Bot

# Matrix

# Firmas de fallo de Matrix

Síntoma	Comprobación más rápida	Corrección
Sesión iniciada, pero ignora mensajes de sala	openclaw channels status --probe	Revisa groupPolicy, la lista de permitidos de salas y la compuerta de menciones.
Mensajes directos no se procesan	openclaw pairing list matrix	Aprueba el remitente o ajusta la política de mensajes directos.
Fallan las salas cifradas	openclaw matrix verify status	Vuelve a verificar el dispositivo y luego revisa openclaw matrix verify backup status.
La restauración de copia de seguridad está pendiente/rota	openclaw matrix verify backup status	Ejecuta openclaw matrix verify backup restore o vuelve a ejecutarlo con una clave de recuperación.
La firma cruzada/bootstrap parece incorrecta	openclaw matrix verify bootstrap	Repara el almacenamiento secreto, la firma cruzada y el estado de copia de seguridad en una sola pasada.

Configuración completa: Matrix

# Relacionado

• Emparejamiento
• Enrutamiento de canales
• Solución de problemas del Gateway