Preguntas Frecuentes de OPenClaw: Guía para Solucionar Errores de Vinculación de Cuenta y Llamadas a la API

Al usar OPenClaw, muchos usuarios se encuentran con problemas como fallos en la vinculación de la cuenta, tiempos de espera en las solicitudes API o errores de interfaz. Este artículo reúne los escenarios de fallo más frecuentes y sus correspondientes soluciones, para ayudarte a retomar el uso rápidamente y evitar cometer los mismos errores.

1. ¿Qué hacer si falla el registro o la vinculación de la cuenta?

Si durante el registro no recibes el correo de verificación, revisa primero la carpeta de spam. Si aún así no aparece, prueba a usar otra cuenta de Gmail o Outlook. Al vincular plataformas de terceros (como GitHub o Google), si aparece una ventana emergente que indica "Autorización fallida", normalmente se debe a la caché del navegador o a que los permisos de la cuenta de terceros no están habilitados. Se recomienda limpiar las cookies y usar el modo incógnito para volver a intentarlo.

Si después de vincular aparece el mensaje "Cuenta restringida", es posible que hayas realizado múltiples vinculaciones en un breve periodo, activando la protección de seguridad. En ese caso, espera 24 horas y envía un ticket a través del correo oficial explicando la situación. Por lo general, la cuenta se desbloquea en un día hábil.

2. Errores frecuentes al llamar a la API con la clave

Si la solicitud devuelve "401 Unauthorized", lo más probable es que la clave API se haya copiado incompleta o haya caducado. Inicia sesión en el panel de control de OPenClaw, genera una nueva clave y asegúrate de que no tenga espacios adicionales en el código. Si recibes "429 Too Many Requests", significa que la frecuencia de llamadas supera el límite del nivel gratuito. Se recomienda reducir el intervalo entre solicitudes o actualizar el plan.

Algunos usuarios reportan que la interfaz devuelve "500 Internal Server Error", lo que suele deberse a una fluctuación temporal del servidor. Espera 5 minutos y vuelve a intentarlo. Si el error persiste, prueba a cambiar al nodo de respaldo (por ejemplo, el dominio alternativo api.openclaw.net) y verifica que tu red local no esté bloqueando las IP extranjeras.

3. Respuestas anormales del modelo o contenido truncado

Cuando la respuesta de la IA se vuelve repentinamente breve o repite la misma frase, primero revisa si el parámetro max_tokens en la solicitud está configurado demasiado bajo (se recomienda no menos de 512). Si la salida contiene caracteres extraños o una mezcla de chino e inglés, es posible que haya caracteres no válidos en el prompt de entrada, como comas chinas o símbolos especiales. Reemplázalos por caracteres de ancho medio para solucionarlo.

Si la respuesta es vacía durante mucho tiempo, consulta la sección "Estadísticas de uso" en el panel de control para ver si se ha agotado la cuota gratuita del día. Las cuentas gratuitas tienen un límite de 500 llamadas al día; una vez superado, deberás esperar hasta el día siguiente para que se restablezca, o suscribirte al plan Pro para obtener solicitudes ilimitadas.

4. Sincronización entre dispositivos y pérdida de datos

Si al cambiar de dispositivo no se sincronizan los historiales de conversación, asegúrate de haber cerrado sesión correctamente en el dispositivo anterior y de haber iniciado sesión con la misma cuenta en el nuevo. Si borraste manualmente la caché del navegador, los borradores de conversaciones almacenados localmente se eliminarán. Se recomienda exportar las conversaciones importantes como archivos JSON de forma periódica para hacer una copia de seguridad.

Algunos usuarios comentan que los miembros del grupo familiar no pueden ver los proyectos entre sí. Verifica que el creador del grupo familiar haya activado el permiso "Compartir conversaciones". En "Configuración - Gestión de permisos", marca al miembro correspondiente para solucionarlo.