Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Usa esta página cuando un canal se conecta pero el comportamiento es incorrecto.
Secuencia de comandos
Ejecuta primero estos comandos en orden:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: read-only, write-capable, o admin-capable- La comprobación 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 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. |
Telegram
Firmas de fallo 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. |
| 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. |
Discord
Firmas de fallo de Discord
| 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. |
Slack
Firmas de fallo 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 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. |
iMessage
Firmas de fallo de iMessage
| 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. |
Signal
Firmas de fallo de Signal
| 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. |
QQ Bot
Firmas de fallo 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 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. |
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 | 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. |
Relacionado
