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 base correcto:

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

Síntoma	Comprobación más rápida	Corrección
Conectado, pero sin respuestas por DM	`openclaw pairing list whatsapp`	Aprueba al remitente o cambia la política/lista de permitidos de DM.
Mensajes de grupo ignorados	Comprueba `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	Comprueba las variables de entorno `HTTPS_PROXY` / `HTTP_PROXY` del Gateway	Configura un proxy accesible; usa `NO_PROXY` solo para exclusiones.
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 la inestabilidad continúa.
Las respuestas llegan segundos/minutos tarde	`openclaw doctor --fix`	Doctor detiene clientes TUI locales obsoletos verificados cuando están degradando el bucle de eventos del Gateway.

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.
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 visibilidad en grupos o menciona al bot.
Fallos de envío con errores de red	Inspecciona los registros en busca de fallos en 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 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 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 para `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.

Síntoma	Comprobación más rápida	Corrección
El bot está en línea, pero no responde 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 menciones	Menciona al bot o configura `requireMention: false` para el servidor/canal.
Uso de escritura/token, pero sin mensaje en 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 a herramientas o configura `messages.groupChat.visibleReplies: "automatic"` para publicar automáticamente.
Faltan respuestas por DM	`openclaw pairing list discord`	Aprueba el emparejamiento por DM o ajusta la política de DM.

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 alcances 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	Comprueba `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

Síntoma	Comprobación más rápida	Corrección
Falta `imsg` o falla en sistemas que no son macOS	`openclaw channels status --probe --channel imessage`	Ejecuta OpenClaw en el Mac de Mensajes o usa un wrapper 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 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:

Síntoma	Comprobación más rápida	Corrección
Daemon accesible, pero bot en silencio	`openclaw channels status --probe`	Verifica la URL/cuenta del daemon `signal-cli` y el modo de recepción.
DM bloqueado	`openclaw pairing list signal`	Aprueba al remitente o ajusta la política de DM.
Las respuestas de grupo no se activan	Comprueba la lista de permitidos del grupo y los patrones de mención	Añade el remitente/grupo o relaja la compuerta.

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

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 la QQ Open Platform.
Voz no transcrita	Comprueba la configuración del proveedor 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 mensajes iniciados por el bot sin interacción reciente.

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

Síntoma	Comprobación más rápida	Corrección
Sesión iniciada, pero ignora mensajes de sala	`openclaw channels status --probe`	Comprueba `groupPolicy`, la lista de permitidos de salas y la compuerta de menciones.
DM no se procesan	`openclaw pairing list matrix`	Aprueba al remitente o ajusta la política de DM.
Las salas cifradas fallan	`openclaw matrix verify status`	Vuelve a verificar el dispositivo y luego comprueba `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.
El firmado cruzado/bootstrap parece incorrecto	`openclaw matrix verify bootstrap`	Repara el almacenamiento secreto, el firmado cruzado y el estado de la copia de seguridad en una sola pasada.

Configuración completa: Matrix

Was this useful?