Configuration

Solución de problemas de canales

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

Secuencia de comandos

Ejecuta primero estos comandos en orden:

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Estado de referencia correcto:

Runtime: running
Connectivity probe: ok
Capability: read-only, write-capable o admin-capable
La comprobación del canal muestra que el transporte está conectado y, cuando se admite, works o audit ok

Después de una actualización

Usa este procedimiento cuando Telegram, iMessage, las configuraciones de la época de BlueBubbles u otro canal de Plugin desaparezcan después de actualizar.

bash

openclaw status --allopenclaw doctor --fixopenclaw gateway restartopenclaw status --all

Busca plugin load failed: dependency tree corrupted; run openclaw doctor --fix en openclaw status --all. Esto significa que el canal está configurado, pero la configuración o carga del Plugin encontró un árbol de dependencias dañado en lugar de registrar el canal. openclaw doctor --fix elimina los enlaces simbólicos obsoletos de dependencias del entorno de ejecución del Plugin y las réplicas de autenticación obsoletas; después, openclaw gateway restart vuelve a cargar un estado limpio.

Indicadores de fallos de WhatsApp

Síntoma	Comprobación más rápida	Solución
Conectado, pero sin respuestas por MD	`openclaw pairing list whatsapp`	Aprueba al remitente o cambia la política/lista de permitidos de MD.
Se ignoran los mensajes de grupo	Comprueba `requireMention` y los patrones de mención en la configuración	Menciona al bot o flexibiliza la política de menciones para ese grupo.
El inicio de sesión por QR expira con 408	Comprueba las variables de entorno `HTTPS_PROXY` / `HTTP_PROXY` del Gateway	Configura un proxy accesible; usa `NO_PROXY` solo para las exclusiones.
Desconexiones o ciclos de inicio de sesión aleatorios	`openclaw channels status --probe` y los registros	Las reconexiones recientes se señalan incluso si actualmente hay conexión; observa los registros, reinicia el Gateway y vuelve a vincular la cuenta si la inestabilidad continúa.
Ciclo `status=408 Request Time-out`	Comprobación, registros, doctor y después estado del Gateway	Corrige primero la conectividad o la temporización del host; haz una copia de seguridad de la autenticación y vuelve a vincular la cuenta si el ciclo persiste.
Las respuestas llegan segundos o minutos tarde	`openclaw doctor --fix`	Doctor detiene los clientes TUI locales obsoletos verificados cuando degradan el bucle de eventos del Gateway.

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

Indicadores de fallos de Telegram

Síntoma	Comprobación más rápida	Solución
`/start`, pero no hay un flujo de respuesta utilizable	`openclaw pairing list telegram`	Aprueba el emparejamiento o cambia la política de MD.
El bot está 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 que el bot pueda ver el grupo o menciona al bot.
Fallos de envío con errores de red	Examina los registros para detectar fallos en las llamadas a la API de Telegram	Corrige el enrutamiento de DNS/IPv6/proxy hacia `api.telegram.org`.
El inicio informa `getMe returned 401`	Comprueba la fuente configurada del token	Vuelve a copiar o genera de nuevo el token de BotFather y actualiza `botToken`, `tokenFile` o `TELEGRAM_BOT_TOKEN` de la cuenta predeterminada.
El sondeo se bloquea o se reconecta lentamente	Consulta `openclaw logs --follow` para ver los diagnósticos del sondeo	Actualiza; si los reinicios son falsos positivos, ajusta `pollingStallThresholdMs`. Los bloqueos persistentes siguen apuntando al proxy, DNS o IPv6.
`setMyCommands` se rechaza al iniciar	Examina los registros en busca de `BOT_COMMANDS_TOO_MUCH`	Reduce los comandos de Plugin, Skills o personalizados de Telegram, o desactiva los menús nativos.
Tras actualizar, la lista de permitidos te bloquea	`openclaw security audit` y las listas de permitidos de la configuración	Ejecuta `openclaw doctor --fix` o sustituye `@username` por identificadores numéricos de remitente.

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

Discord

Indicadores de fallos de Discord

Síntoma	Comprobación más rápida	Solución
El bot está en línea, pero no responde en el servidor	`openclaw channels status --probe`	Permite el servidor/canal y verifica la intención de contenido de mensajes.
Se ignoran los mensajes de grupo	Comprueba en los registros los descartes causados por el filtro de menciones	Menciona al bot o establece `requireMention: false` para el servidor/canal.
Hay actividad de escritura o uso de tokens, pero no aparece ningún mensaje en Discord	Comprueba si se trata de un evento de sala ambiental o de una sala `message_tool` habilitada en la que el modelo omitió `message(action=send)`	Examina el registro detallado del Gateway para detectar metadatos de la carga final suprimida, verifica `messages.groupChat.unmentionedInbound`, consulta Eventos de salas ambientales o mantén `messages.groupChat.visibleReplies: "automatic"` para las solicitudes normales de grupo.
Faltan respuestas por MD	`openclaw pairing list discord`	Aprueba el emparejamiento de MD o ajusta la política de MD.

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

Slack

Indicadores de fallos de Slack

Síntoma	Comprobación más rápida	Solución
El modo de socket está conectado, pero no responde	`openclaw channels status --probe`	Verifica el token de la aplicación, el token del bot y los permisos necesarios; busca `botTokenStatus` / `appTokenStatus = configured_unavailable` en configuraciones respaldadas por SecretRef.
Los MD están bloqueados	`openclaw pairing list slack`	Aprueba el emparejamiento o flexibiliza la política de MD.
Se ignora el mensaje del canal	Comprueba `groupPolicy` y la lista de canales permitidos	Permite el canal o cambia la política a `open`.

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

iMessage

Indicadores de fallos de iMessage

Síntoma	Comprobación más rápida	Solución
Falta `imsg` o falla fuera de macOS	`openclaw channels status --probe --channel imessage`	Ejecuta OpenClaw en el Mac con Mensajes o usa un contenedor SSH para `cliPath`.
Puede enviar, pero no recibir en macOS	Comprueba los permisos de privacidad de macOS para la automatización de Mensajes	Vuelve a conceder los permisos de TCC y reinicia el proceso del canal.
El remitente de MD está bloqueado	`openclaw pairing list imessage`	Aprueba el emparejamiento o actualiza la lista de permitidos.

Solución de problemas completa: Solución de problemas de iMessage

Signal

Indicadores de fallos de Signal

Síntoma	Comprobación más rápida	Solución
Se puede acceder al demonio, pero el bot no responde	`openclaw channels status --probe`	Verifica la URL/cuenta del demonio `signal-cli` y el modo de recepción.
El MD está bloqueado	`openclaw pairing list signal`	Aprueba al remitente o ajusta la política de MD.
Las respuestas de grupo no se activan	Comprueba la lista de grupos permitidos y los patrones de mención	Añade el remitente/grupo o flexibiliza el filtro.

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

Bot de QQ

Indicadores de fallos del Bot de QQ

Síntoma	Comprobación más rápida	Solución
El bot responde que «se fue a Marte»	Verifica `appId` y `clientSecret` en la configuración	Configura las credenciales o reinicia el Gateway.
No hay mensajes entrantes	`openclaw channels status --probe`	Verifica las credenciales en la plataforma abierta de QQ.
La voz no se transcribe	Comprueba la configuración del proveedor de STT	Configura `channels.qqbot.stt` o `tools.media.audio`.
Los mensajes proactivos no llegan	Comprueba los requisitos de interacción de la plataforma QQ	QQ puede bloquear los mensajes iniciados por el bot si no ha habido una interacción reciente.

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

Matrix

Firmas de fallos de Matrix

Síntoma	Comprobación más rápida	Solución
Ha iniciado sesión, pero ignora los mensajes de las salas	`openclaw channels status --probe`	Compruebe `groupPolicy`, la lista de permitidos de salas y el requisito de mención.
Los mensajes directos no se procesan	`openclaw pairing list matrix`	Apruebe al remitente o ajuste la política de mensajes directos.
Las salas cifradas fallan	`openclaw matrix verify status`	Vuelva a verificar el dispositivo y, después, compruebe `openclaw matrix verify backup status`.
La restauración de la copia de seguridad está pendiente o falla	`openclaw matrix verify backup status`	Ejecute `openclaw matrix verify backup restore` o repita la operación con una clave de recuperación.
La firma cruzada o la inicialización parecen incorrectas	`openclaw matrix verify bootstrap`	Repare de una vez el almacenamiento de secretos, la firma cruzada y el estado de la copia de seguridad.

Configuración completa: Matrix

Temas relacionados

Was this useful?