rclone OneDrive: cómo configurarlo y arreglar sus errores más comunes

Si buscas "rclone OneDrive" lo más probable es que quieras conectar rclone a tu cuenta de OneDrive (Personal o Empresa) y que algo está fallando: rclone no autentica, da error 401 o 403, no encuentra la carpeta o se cierra al lanzar rclone config. rclone es una herramienta de línea de comandos que sincroniza, copia y monta OneDrive como una unidad más desde el Símbolo del sistema o PowerShell, y los errores se arreglan entendiendo primero qué mensaje exacto muestra. Datos comprobados en octubre de 2026.

Qué hace rclone con OneDrive y qué necesita tu PC

rclone es una herramienta de línea de comandos escrita en Go que sirve para sincronizar, copiar y montar OneDrive (Personal, Empresa o SharePoint) como si fuera una carpeta más de Windows. En Windows se descarga como un zip desde rclone.org/downloads, se descomprime en una carpeta (por ejemplo C:\Program Files\RClone) y se ejecuta desde el Símbolo del sistema o PowerShell. Necesitas una cuenta de Microsoft con OneDrive activo y, si vas a montar OneDrive como unidad, el controlador WinFSP descargado de winfsp.dev. La configuración inicial se hace con rclone config, que abre el navegador en http://127.0.0.1:53682/ para que inicies sesión con tu cuenta de Microsoft.

Por qué rclone falla con OneDrive: las causas más habituales

Comprueba el error exacto de rclone antes de tocar nada

Antes de cambiar nada, necesitas saber qué está diciendo rclone. Casi todos los problemas dejan el código HTTP o el mensaje en inglés justo en la última línea de la ejecución, así que conviene releer el error completo. La mayoría se aclaran añadiendo -v para que la salida sea detallada y, si quieres guardarla, --log-file=archivo.log. Con esa traza puedes distinguir si el fallo es de autenticación (401/403), de permisos (403 con Microsoft Graph), de ruta (404) o de cuota (507).

Ejecuta rclone con -v y guarda el log

1. Abre el Símbolo del sistema o PowerShell (clic derecho en Inicio > Terminal en Windows 11, o Símbolo del sistema en Windows 10).
2. Escribe el comando que te falla seguido de -v --log-file=rclone.log. Ejemplo:

rclone copy "C:\Users\TuUsuario\Documentos" OneDrive:/backup -v --log-file=rclone.log

1. Deja que termine (o que falle) y abre rclone.log con el Bloc de notas.
2. Busca con Ctrl+B las palabras ERROR, 401, 403 o 404. El primer resultado suele ser la causa real.

Lista el remoto a mano para ver qué responde OneDrive

Para confirmar si la autenticación funciona, lista el remoto manualmente. Sustituye OneDrive por el nombre que le pusiste en rclone config:

rclone lsd OneDrive:

Si responde con tus carpetas raíz (Documents, Pictures, etc.), la autenticación y los permisos están bien y el problema está en la ruta o en los parámetros del comando que fallaba. Si devuelve 401 Unauthorized o 403 Forbidden, el fallo es de credenciales o de permisos del tenant de Microsoft 365.

-1 2024-03-12 09:14:21 -1 Documents
-1 2024-03-12 09:14:21 -1 Pictures
-1 2024-03-12 09:14:21 -1 backup

El error 401/403 o «token»: vuelve a autenticar el remoto

Si rclone dice "Unauthorized", "token expired", "failed to get config" o muestra HTTP 401/403, la sesión OAuth ha caducado o las credenciales que pegaste en rclone config ya no sirven. Esto pasa con frecuencia tras cambiar la contraseña de la cuenta de Microsoft, tras revocar el permiso en account.microsoft.com o cuando Microsoft aplica políticas nuevas en enero de 2025 sobre las carpetas compartidas.

Borra el token y rehaz rclone config

La solución más rápida es rehacer la autenticación del remoto conservando su nombre, para no tener que cambiar los scripts.

1. Abre el Símbolo del sistema o PowerShell.
2. Ejecuta rclone config y entra en el remoto de OneDrive.
3. Elige e) Edit existing remote y, cuando lo pregunte, rehaz solo la autenticación (Yes, type in your own password o el flujo web por defecto).
4. Se abrirá el navegador en http://127.0.0.1:53682/. Inicia sesión con la cuenta correcta y acepta los permisos que pide rclone (Files.Read, Files.ReadWrite, Files.Read.All, Sites.Read.All, offline_access, User.Read).
5. Vuelve a la consola, confirma con y y sal con q.
6. Repite el comando que fallaba.

Genera tu propio Client ID si usas OneDrive Empresa

En OneDrive Empresa (Microsoft 365), las opciones "onedrive" pueden dejar de funcionar si Microsoft aplica cambios en los clientes OAuth públicos. La solución es crear tu propia aplicación en Azure y pegar su client_id y client_secret en rclone.

1. Entra en portal.azure.com con una cuenta administradora del tenant.
2. Ve a Microsoft Entra ID > Registros de aplicaciones > Nuevo registro. Nombra la app (por ejemplo "rclone personal") y elige el tipo Single tenant (solo tu organización).
3. En Autenticación, añade como Redirect URI de tipo Web la dirección http://localhost:53682/.
4. En Certificados y secretos, crea un Client Secret con expiración a 24 meses y guarda el valor.
5. En Permisos de API, añade en Microsoft Graph los permisos delegados Files.Read, Files.Read.All, offline_access, User.Read y Sites.Read.All, y concede el consentimiento de administrador.
6. Vuelve a rclone config, edita el remoto y pega el client_id y el client_secret cuando te los pida.

El error 404 o «directory not found»: la ruta no existe o usas una carpeta compartida

Cuando rclone dice "directory not found" o "object not found" y termina con HTTP 404, normalmente se debe a tres cosas: la ruta está mal escrita (falta los dos puntos o la barra, o las mayúsculas no coinciden), la carpeta realmente no existe en tu OneDrive, o estás intentando entrar en una carpeta compartida de la que no eres propietario. Desde enero de 2025, Microsoft obliga a acceder a las carpetas compartidas a través del navegador, y rclone solo puede verlas si te autenticas como el dueño original.

Verifica la ruta con lsd y ls

Lo más rápido es ver qué hay realmente en tu OneDrive. Abre el Símbolo del sistema y ejecuta, sustituyendo OneDrive por el nombre de tu remoto:

rclone lsd OneDrive:/
rclone ls OneDrive:/Documents

La primera lista las carpetas raíz; la segunda lista los archivos dentro de Documents. Corrige mayúsculas y la barra inicial en tu comando original. En OneDrive los espacios se escriben tal cual, no con %20.

-1 2024-03-12 09:14:21 -1 Documents
17115946 2024-03-12 09:14:21 Documents/2019 calendar.docx

Autentícate como el dueño de la carpeta compartida

Si la carpeta es de otra persona, OneDrive te la muestra como acceso directo, pero rclone necesita las credenciales de quien la creó.

1. Entra en OneDrive web con la cuenta del dueño de la carpeta y, si puedes, mueve o copia la carpeta a tu propio OneDrive.
2. Si no puedes (la carpeta es de otra persona), pide al dueño que la mueva a una cuenta que controles, o que te la comparta con permisos de edición.
3. Una vez la carpeta esté en una cuenta que puedas autenticar en rclone, repite rclone config con esa cuenta y vuelve a probar.

Errores al copiar: «chunk size», velocidad o archivos bloqueados

Con archivos grandes (vídeos, discos ISO, copias de seguridad), rclone puede fallar por el tamaño de bloque que envía a OneDrive en cada petición, por cortes de red en mitad de la subida o porque OneDrive tiene el archivo bloqueado por otro cliente. También puede fallar si la cuenta está llena o casi llena y OneDrive devuelve HTTP 507.

Ajusta chunk_size y limita el ancho de banda

Para OneDrive el upload_cutoff está en off por defecto y el chunk_size en 10 Mi (múltiplo de 320 Ki y máximo 250 Mi, es decir 262.144.000 bytes). En redes domésticas conviene limitar el ancho de banda para que rclone no sature la conexión y deje sin internet al resto de dispositivos.

1. Abre el Símbolo del sistema.
2. Ejecuta el comando con --bwlimit y, si quieres, un --chunk-size mayor. Ejemplo:

rclone copy "C:\origen" OneDrive:/backup --bwlimit=2M --chunk-size=20M

Quita los caracteres prohibidos en nombres de archivo

OneDrive reemplaza automáticamente algunos caracteres en los nombres de archivo al subirlos: comillas dobles, asterisco, dos puntos, menor que, mayor que, interrogación, barra invertida y barra vertical. Además, los nombres no pueden terminar en espacio ni en punto, ni empezar por la tilde de la ñ (~).

1. Abre la carpeta de origen en el Explorador de archivos.
2. Selecciona los archivos con caracteres problemáticos (clic derecho > Cambiar nombre).
3. Sustituye : * ? " < > \ / | por un guion o un guion bajo. Quita el punto o el espacio final y la tilde inicial si la hay.
4. Vuelve a ejecutar el comando de copia.

Si rclone no se instala, no abre o se cierra al lanzar el config

Cuando rclone directamente no responde o se cierra al abrir rclone config, el problema no es de OneDrive sino de la propia herramienta en Windows: el zip no se descomprimió bien, la ruta no está en el PATH o el archivo de configuración (rclone.conf) se ha corrompido.

Comprueba la versión y reinstala el binario

1. Abre el Símbolo del sistema.
2. Escribe rclone version. Si responde con un número de versión y el commit, rclone está bien instalado.
3. Si no responde o dice "no se reconoce como comando", borra la carpeta donde lo descomprimiste, vuelve a rclone.org/downloads y descarga de nuevo el zip de Windows.
4. Descomprímelo en una ruta sin espacios, por ejemplo C:\Program Files\RClone.
5. Ejecuta rclone con la ruta completa para confirmar:

"C:\Program Files\RClone\rclone.exe" version

Restablece la configuración por completo

Si rclone config se cierra al abrir o da errores raros al leer el remoto, el archivo de configuración puede estar corrupto. Antes de borrarlo, conviene proteger los tokens con contraseña.

1. Abre el Símbolo del sistema.
2. Ejecuta rclone config y elige s) Set configuration password para cifrar los tokens.
3. Si el problema continúa, sal y borra el archivo %APPDATA%\rclone\rclone.conf desde el Explorador de archivos (pega esa ruta en la barra de direcciones).
4. Vuelve a ejecutar rclone config y rehaz el remoto de OneDrive desde cero.

Lo que ya has cubierto al usar rclone con OneDrive

• Token OAuth: lo has renovado entrando en rclone config y rehaciendo la autenticación.
• Permisos de Microsoft Graph: has comprobado que el cliente usa Files.Read.All y Sites.Read.All.
• Client ID para Empresa: lo has dado de alta en portal.azure.com como app de tipo Single tenant.
• Ruta correcta: ya usas OneDrive:/ con la barra inicial y las mayúsculas bien.
• Caracteres prohibidos: has limpiado : * ? " < > \ / | y los espacios o puntos al final.
• Tamaño de bloque: has ajustado --chunk-size y limitado el ancho de banda con --bwlimit.

Si tras todo esto el log de rclone no muestra HTTP 4xx, el problema está en la red local, en el proxy corporativo o en la cuota de OneDrive llena, no en la propia herramienta.

Dudas sobre rclone con OneDrive