# Cuando algo falla (/es/docs/gcal/troubleshooting)

Empieza por el síntoma, haz la comprobación y vuelve a ejecutar el comando. Guarda el código de error y el nombre del
perfil para una solicitud de soporte.

| Síntoma | Qué hacer |
| --- | --- |
| No sabes qué está configurado | Ejecuta `gcal doctor`. No lee ningún llavero ni usa la red. |
| No se encuentra `gcal` | Abre una terminal nueva y comprueba que la carpeta global de npm está en `PATH`. |
| "name a profile" | Pon el perfil primero, como en `gcal personal config show`, o define `GCAL_PROFILE`. |
| El archivo de ajustes no se puede leer | `doctor` muestra cada problema del archivo en `config.issues`. Ejecuta el `config unset` que indica cada uno o corrige el archivo a mano. |
| `doctor` muestra `files.problems` | Otros usuarios del ordenador pueden leer `config.json` o entrar en su carpeta. Ejecuta cada `chmod` que `doctor` imprime tras "to make it private:". `doctor` nunca cambia por sí mismo los permisos de un archivo. |
| "no Google OAuth client is set up" | Pasa `--client-file` con el JSON de tu cliente de aplicación de escritorio, o define `GCAL_GOOGLE_CLIENT_ID` y `GCAL_GOOGLE_CLIENT_SECRET`. Consulta [tu propio cliente de Google](/llms.mdx/docs/es/gcal/configuration/content.md#your-own-google-client). |
| `doctor` muestra `oauth_client.client: null` | No hay ningún cliente en el entorno. Un perfil que inició sesión con `--client-file` sigue funcionando: su sesión guarda el cliente. Solo un nuevo `session start` lo necesita. |
| "the client file can be read by other users" | Ejecuta el `chmod 600` que indica el mensaje y vuelve a iniciar sesión. |
| `sign-in.scope-missing` | La página de consentimiento de Google permite desmarcar Calendar. Ejecuta `session start` de nuevo y déjalo marcado. |
| `profile.wrong-account` o `profile.same-account` | Cada cuenta de Google tiene un solo perfil. Usa el perfil que ya tiene esa cuenta, o un nombre de perfil nuevo para una cuenta nueva. |
| `oauth.expired` una semana después de iniciar sesión | Una aplicación de Google en modo Testing da sesiones que caducan a los 7 días ([nota de Google](https://developers.google.com/identity/protocols/oauth2#expiration)). Ejecuta `session start` de nuevo o publica la aplicación en Google Cloud Console. |
| `oauth.not-saved` | `gcal` guarda la sesión en el llavero del sistema, y este proceso no pudo acceder a él: el llavero está bloqueado, no hay ningún servicio de llavero en marcha o el proceso no tiene sesión de D-Bus (la shell de un agente, `ssh`, `cron`). También falla una terminal abierta antes de que se reiniciara el bus de mensajes de la sesión de escritorio: su `DBUS_SESSION_BUS_ADDRESS` sigue apuntando al bus antiguo (`guid=…`); abre una terminal nueva. La sesión sigue guardada. Vuelve a ejecutar el comando con `--debug` para ver el motivo que da el propio llavero y luego ejecútalo desde una terminal del escritorio o desbloquea el llavero. Donde no funcione ningún llavero, inicia sesión con `session start --credential-storage file`. |
| Se rechaza una escritura | Lo impiden los permisos del perfil o `GCAL_READ_ONLY`; consulta los [ajustes](/llms.mdx/docs/es/gcal/configuration/content.md#permissions). |

Nunca pegues un token, una contraseña ni contenido privado en una solicitud de soporte.