Solución de problemas

Empieza por aquí: vuelve a ejecutar el comando con la salida de depuración activada. Los detalles extra suelen mostrar qué salió mal.

OFFICECLAWS_DEBUG=1 officeclaws <command>

Cuenta y suscripción

This account has no active subscription Ejecuta officeclaws subscribe y completa el pago. Espera un minuto y vuelve a ejecutar officeclaws onboard. Si pagaste en la web con otro email, contacta con soporte para que vinculemos el pago a tu cuenta.

not logged in — run: officeclaws login Ejecuta officeclaws login.

Contabo

contabo: … después de introducir las credenciales Uno de los cuatro valores es incorrecto. El error más común es usar la contraseña de la web en lugar de la API password aparte. Consulta el Paso 4.

no VPSes found on your account El servidor aún no se ha entregado, o las credenciales pertenecen a otra cuenta de Contabo. Comprueba en my.contabo.com que el servidor aparece como en funcionamiento.

La configuración lleva mucho tiempo atascada en "Waiting for the VPS" Durante la configuración, Office Claws instala su clave SSH a través de Contabo, y después Contabo reinicia el servidor. Esto puede tardar hasta 30 minutos. No lo interrumpas. Si lo detienes a medias, Contabo puede bloquear el servidor otros 5–15 minutos.

Tailscale

Tailscale daemon is not running Abre la app de Tailscale y conéctate; después vuelve a intentarlo.

Errores de auth key (invalid key, API key does not exist) La clave ha caducado, se ha revocado o era de un solo uso y ya se usó. Crea una nueva clave reutilizable y ejecuta officeclaws onboard --tailscale-authkey tskey-auth-….

El agente aparece como offline o el chat dice que no puede conectarse

• Comprueba que Tailscale está conectado en tu ordenador: tailscale status.
• Comprueba que el servidor del agente aparece en tu tailnet. Está en la lista de login.tailscale.com/admin/machines.
• Tu ordenador y el agente deben estar en la misma tailnet.
• Comprueba en el panel de Contabo que el VPS está en funcionamiento.
• ¿Funcionó durante meses y luego dejó de hacerlo? Probablemente caducó la clave de Tailscale del servidor. Entra en el VPS por la consola VNC de Contabo como root, con la contraseña de root que pusiste al pedir el servidor (el usuario openclaw no puede usar sudo ahí), y ejecuta tailscale up. O empieza con un servidor limpio, consulta Gestiona tus agentes. Para que no vuelva a pasar, desactiva la caducidad de la clave.

Agente y chat

El agente no responde, o ves rpc final event had no text o desconexiones Lo más probable es que hayas llegado al límite de uso de Codex de tu plan de ChatGPT. Espera a que se restablezca o mejora tu plan de ChatGPT. Si dice que el agente no está conectado a un modelo, ejecuta officeclaws connect-codex.

1008 pairing required Ejecuta officeclaws pairing repair.

El inicio de sesión de Codex caduca Completa el inicio de sesión en menos de 5 minutos, en un navegador del mismo ordenador. Después vuelve a ejecutar officeclaws connect-codex.

El bot de Telegram no responde

• Ejecuta officeclaws telegram show y comprueba que dice enabled : true.
• Con el modo pairing, primero tienes que aprobar tu cuenta. Consulta Telegram.
• Asegúrate de que ningún otro programa usa el mismo token del bot.

¿Sigues atascado?

1. Reúne los logs:
   • Tu agente: officeclaws logs --lines 500
   • Configuración: el archivo más reciente de ~/.openclaw/logs en tu ordenador
2. Escríbenos por Telegram: t.me/getfrontendeddm. Incluye el comando que ejecutaste, el error y los logs. Antes, elimina cualquier clave, token o contraseña.