Configuration

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 primero en orden:

bash

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

Base saludable:

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

Después de una actualización

Usa esto cuando Telegram, iMessage, configuraciones de la era 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. Eso significa que el canal está configurado, pero la ruta de configuración/carga del plugin encontró un árbol de dependencias corrupto en lugar de registrar el canal. openclaw doctor --fix elimina directorios obsoletos de preparación de dependencias del plugin y sombras de autenticación obsoletas; luego openclaw gateway restart recarga el estado limpio.

Firmas de error de WhatsApp

Síntoma	Comprobación más rápida	Corrección
Conectado pero sin respuestas de DM	`openclaw pairing list whatsapp`	Aprueba el remitente o cambia la política/lista de permitidos de DM.
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 por QR agota el tiempo con 408	Revisa las variables de 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 está conectado actualmente; observa los registros, reinicia el gateway y luego vuelve a vincular si las fluctuaciones continúan.
Bucle `status=408 Request Time-out`	Prueba, registros, doctor y luego estado del gateway	Corrige primero la conectividad/temporización del host; haz una copia de seguridad de la autenticación y vuelve a vincular la cuenta si el bucle persiste.
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

Firmas de error de Telegram

Síntoma	Comprobación más rápida	Corrección
`/start` pero sin flujo de respuesta utilizable	`openclaw pairing list telegram`	Aprueba el emparejamiento o cambia la política de DM.
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.
Errores 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 la fuente del token configurada	Vuelve a copiar o regenera el token de BotFather y actualiza `botToken`, `tokenFile` o `TELEGRAM_BOT_TOKEN` de la cuenta predeterminada.
El sondeo se atasca o se reconecta lentamente	`openclaw logs --follow` para diagnósticos de sondeo	Actualiza; si los reinicios son falsos positivos, ajusta `pollingStallThresholdMs`. Los atascos persistentes aún apuntan a proxy/DNS/IPv6.
`setMyCommands` rechazado al inicio	Inspecciona los registros en busca de `BOT_COMMANDS_TOO_MUCH`	Reduce los comandos de Telegram de plugins/skills/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 reemplaza `@username` por IDs numéricos de remitente.

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

Discord

Firmas de error 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 el intent de contenido de mensajes.
Mensajes de grupo ignorados	Revisa los registros en busca de descartes por puerta de menciones	Menciona al bot o configura `requireMention: false` para el servidor/canal.
Uso de escritura/token pero sin mensaje de Discord	Revisa si esto es un evento de sala ambiental o una sala `message_tool` con participación donde el modelo omitió `message(action=send)`	Inspecciona el registro detallado del gateway en busca de metadatos de carga final suprimida, verifica `messages.groupChat.unmentionedInbound`, lee Eventos de sala ambiental o conserva `messages.groupChat.visibleReplies: "automatic"` para solicitudes normales de grupo.
Faltan respuestas de DM	`openclaw pairing list discord`	Aprueba el emparejamiento de DM o ajusta la política de DM.

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

Slack

Firmas de error de Slack

Síntoma	Comprobación más rápida	Corrección
Socket mode 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.
DM bloqueados	`openclaw pairing list slack`	Aprueba el emparejamiento o relaja la política de DM.
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

Firmas de error de iMessage

Síntoma	Comprobación más rápida	Corrección
Falta `imsg` o falla en no macOS	`openclaw channels status --probe --channel imessage`	Ejecuta OpenClaw en la Mac con Messages o usa un envoltorio SSH para `cliPath`.
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 DM 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

Firmas de error de Signal

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

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

QQ Bot

Firmas de error de QQ Bot

Síntoma	Comprobación más rápida	Corrección
El 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`.
No llegan mensajes proactivos	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 fallos de Matrix

Síntoma	Comprobación más rápida	Corrección
Sesión iniciada, pero ignora los mensajes de sala	`openclaw channels status --probe`	Revisa `groupPolicy`, la lista de salas permitidas y el control por menciones.
Los mensajes directos no se procesan	`openclaw pairing list matrix`	Aprueba al remitente o ajusta la política de mensajes directos.
Las salas cifradas fallan	`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 ejecutar con una clave de recuperación.
La firma cruzada/inicialización parece incorrecta	`openclaw matrix verify bootstrap`	Repara el almacenamiento secreto, la firma cruzada y el estado de la copia de seguridad en una sola pasada.

Configuración inicial y configuración completas: Matrix

Relacionado

Was this useful?