Soluciona errores de canales en OpenClaw: Guía rápida

A veces, cuando integras servicios de mensajería, las cosas simplemente no funcionan como esperas. Es frustrante cuando pasas horas configurando una conexión y, al final, los mensajes no llegan o el bot parece estar ignorando tus comandos.

Aquí tienes una guía para diagnosticar problemas comunes con OpenClaw y sus canales de comunicación. Esta página te ayudará a identificar por qué un canal se conecta pero no se comporta correctamente, permitiéndote resolver errores de API, Gateway o configuración de forma rápida.

Escalera de comandos

Ejecuta estos comandos en orden para obtener un diagnóstico inicial de tu entorno:

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

Una base saludable debería mostrar:

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

WhatsApp

Fallos comunes en WhatsApp

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 de DM/lista de permitidos.
Mensajes de grupo ignorados	Revisa requireMention + patrones de mención en config	Menciona al bot o relaja la política de mención para ese grupo.
Desconexión aleatoria/bucles de inicio	openclaw channels status --probe + logs	Vuelve a iniciar sesión y verifica que el directorio de credenciales esté sano.

Solución de problemas completa: /channels/whatsapp#troubleshooting

Telegram

Fallos comunes en Telegram

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 online pero el grupo no responde	Verifica requisito de mención y modo privacidad	Desactiva el modo privacidad para visibilidad en grupo o menciona al bot.
Errores de red al enviar	Inspecciona logs por fallos en API de Telegram	Corrige enrutamiento DNS/IPv6/proxy hacia api.telegram.org.
El polling se detiene o reconecta lento	openclaw logs --follow para diagnóstico	Actualiza, luego revisa proxy/DNS/IPv6 si getUpdates sigue agotando el tiempo.
setMyCommands rechazado al inicio	Inspecciona logs por BOT_COMMANDS_TOO_MUCH	Reduce comandos de plugin/skill o desactiva menús nativos.
Actualizado y la lista de permitidos bloquea	openclaw security audit y listas de config	Ejecuta openclaw doctor --fix o reemplaza @username con IDs numéricos.

Solución de problemas completa: /channels/telegram#troubleshooting

Discord

Fallos comunes en Discord

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

Solución de problemas completa: /channels/discord#troubleshooting

Slack

Fallos comunes en Slack

Síntoma	Verificación rápida	Solución
Socket mode conectado pero sin respuesta	openclaw channels status --probe	Verifica token de app + token de bot y alcances requeridos; vigila botTokenStatus / appTokenStatus = configured_unavailable.
DMs bloqueados	openclaw pairing list slack	Aprueba el emparejamiento o relaja la política de DM.
Mensaje de canal ignorado	Revisa groupPolicy y lista de permitidos	Permite el canal o cambia la política a open.

Solución de problemas completa: /channels/slack#troubleshooting

iMessage y BlueBubbles

Fallos comunes en iMessage y BlueBubbles

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

Solución de problemas completa:

• /channels/imessage#troubleshooting
• /channels/bluebubbles#troubleshooting

Signal

Fallos comunes en Signal

Síntoma	Verificación rápida	Solución
Daemon alcanzable 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 disparan	Revisa lista de permitidos y patrones de mención	Añade al remitente/grupo o relaja las restricciones.

Solución de problemas completa: /channels/signal#troubleshooting

QQ Bot

Fallos comunes en QQ Bot

Síntoma	Verificación rápida	Solución
Bot responde “gone to Mars”	Verifica appId y clientSecret en config	Configura credenciales o reinicia el Gateway.
Sin mensajes entrantes	openclaw channels status --probe	Verifica credenciales en la plataforma abierta de QQ.
Voz no transcrita	Revisa config del proveedor STT	Configura channels.qqbot.stt o tools.media.audio.
Mensajes proactivos no llegan	Revisa requisitos de interacción de QQ	QQ puede bloquear mensajes iniciados por bots sin interacción reciente.

Solución de problemas completa: /channels/qqbot#troubleshooting

Matrix

Fallos comunes en Matrix

Síntoma	Verificación rápida	Solución
Logueado pero ignora mensajes de sala	openclaw channels status --probe	Revisa groupPolicy, lista de permitidos y restricciones de mención.
DMs no procesan	openclaw pairing list matrix	Aprueba al remitente o ajusta la política de DM.
Salas cifradas fallan	openclaw matrix verify status	Verifica de nuevo el dispositivo, luego revisa openclaw matrix verify backup status.
Restauración de backup pendiente/rota	openclaw matrix verify backup status	Ejecuta openclaw matrix verify backup restore o reintenta con clave de recuperación.
Cross-signing/bootstrap incorrecto	openclaw matrix verify bootstrap	Repara almacenamiento secreto, cross-signing y estado de backup en una pasada.

Configuración completa: Matrix

Siguientes pasos

Si todavía tienes problemas, puedes consultar estas secciones:

• Guía de instalación
• Configuración de canales
• AI Setup Assistant