Plugin de agente gestor de archivos con IA para Android: uso y seguridad

Qué tareas puede organizar el agente de archivos

Un plugin de agente gestor de archivos con IA para Android convierte una petición como “ordena estos documentos” en operaciones concretas sobre rutas conocidas. El modelo interpreta la intención, pero el plugin realiza únicamente las acciones definidas en su contrato. Esto permite revisar qué archivo se leerá, qué carpeta se creará y qué cambio se aplicará antes de modificar el almacenamiento.

File Manager Plugin puede comprobar su estado y configuración, listar carpetas, buscar archivos, leer texto con un límite máximo de bytes, crear archivos sin sobrescribir uno existente, escribir texto, crear directorios y renombrar un elemento. También incorpora renombrado por lotes con vista previa, eliminación permanente y descarga mediante HTTPS hacia una ruta relativa del almacenamiento externo.

Imaginemos una carpeta Downloads con facturas, capturas y documentos. El agente puede empezar listando su contenido, buscar nombres que incluyan “factura” y leer únicamente archivos de texto seleccionados. Después podría proponer una carpeta `Documents/Facturas-2026` y preparar nombres coherentes para los documentos encontrados.

Cada fase produce un resultado observable. La búsqueda devuelve coincidencias; la lectura indica qué ruta se abrió y hasta qué límite se obtuvo contenido; la creación confirma la nueva carpeta; y el renombrado muestra los nombres de origen y destino. Si el archivo ya existe, la operación debe detenerse y presentar el conflicto en vez de asumir que puede reemplazarlo.

Esta estructura permite que la IA organice una tarea sin ocultar los detalles del sistema de archivos. El usuario conserva el control sobre el ámbito, los cambios y el resultado final, especialmente cuando la solicitud afecta varios elementos o incluye una acción destructiva.

Por qué File Manager se instala como plugin

File Manager se distribuye como un plugin Android independiente para FoneClaw. Tiene su propio APK, el paquete `ai.android.claw.plugin.device.filemanager`, una firma esperada, permisos específicos y herramientas que el host registra después de una instalación válida. Esta separación permite evaluar la procedencia y el acceso del gestor de archivos antes de incorporarlo al agente.

El índice oficial de plugins de FoneClaw publica File Manager Plugin 0.0.4, código 4, con el requisito mínimo del host FoneClaw indicado por el índice. El índice estructurado es la referencia vigente para la versión del paquete. La documentación pública del sistema de plugins aporta contexto de instalación y uso.

FoneClaw mantiene diferenciadas las herramientas integradas y las aportadas por plugins. Tras instalar el APK verificado, el host descubre y registra el contrato del plugin. Cuando se desinstala, esas herramientas dejan de formar parte del agente. Skills y Workflows pueden utilizarlas mientras estén disponibles, pero no convierten el paquete instalado en una capacidad integrada del núcleo.

Esta arquitectura también facilita revisar permisos por paquete. File Manager solicita `MANAGE_EXTERNAL_STORAGE` e `INTERNET` porque trabaja con almacenamiento externo y admite descargas. El usuario puede identificar la aplicación responsable desde los ajustes de Android y retirar su acceso o desinstalarla cuando deje de necesitarla.

El mismo principio se aplica a otros paquetes instalables. FoneClaw gratis para Android: plugin local gratuito de descarga de YouTube con aprobación muestra otro ejemplo de plugin con instalación, herramientas y controles propios.

Acceso a archivos, rutas y datos sensibles

`MANAGE_EXTERNAL_STORAGE`, conocido en Android como acceso a todos los archivos, permite trabajar ampliamente con el almacenamiento externo compartido. Este acceso es necesario para listar y modificar rutas fuera de un directorio privado limitado. Android continúa aplicando sus protecciones sobre áreas del sistema y espacios privados de otras aplicaciones.

File Manager utiliza como referencia la raíz de almacenamiento externo permitida. Las operaciones reciben rutas relativas, como `Download/informe.txt` o `Documents/Proyectos/Notas`. Mostrar la ruta completa resuelta antes de escribir ayuda a evitar que una expresión ambigua como “la carpeta de documentos” termine en un destino inesperado.

El permiso del sistema y la aprobación de la tarea cumplen funciones diferentes. Android autoriza al paquete a acceder al almacenamiento; FoneClaw decide si una operación concreta puede avanzar según la política de su herramienta. Consultar el estado puede ejecutarse directamente, mientras las operaciones restantes requieren aprobación. Aplicar un renombrado por lotes y eliminar archivos se tratan como acciones destructivas.

Una lectura también puede ser sensible aunque no modifique nada. Antes de abrir un archivo, la vista debe identificar ruta, tipo y tamaño esperado. El parámetro `maxBytes` limita cuánto texto se recupera, lo que reduce lecturas accidentales de archivos extensos y permite solicitar una porción manejable para el modelo.

El usuario puede limitar todavía más la tarea indicando una carpeta y un patrón: “Busca archivos `.txt` solo en `Documents/Proyecto-A`”. Esta precisión reduce resultados irrelevantes y hace que la aprobación corresponda a un ámbito verificable.

Para entender cómo se relacionan Skills, acciones y permisos que cambian durante la tarea, consulta Seguridad de habilidades de agentes de IA: por qué el móvil necesita permisos en tiempo real.

Previsualizar antes de renombrar por lotes

Renombrar un archivo individual permite revisar fácilmente el origen y el destino. Un cambio por lotes necesita un contrato más estricto: primero se calcula el conjunto completo de transformaciones y después se aplica exactamente esa propuesta. File Manager separa ambas fases mediante `previewToken`.

Supongamos que Downloads contiene `IMG_101.jpg`, `IMG_102.jpg` e `IMG_103.jpg`. El usuario pide convertirlos en `viaje-01.jpg`, `viaje-02.jpg` y `viaje-03.jpg`. La operación de vista previa devuelve cada correspondencia, detecta posibles conflictos y genera un `previewToken` asociado a esa propuesta.

La pantalla de revisión debe mostrar carpeta, número de elementos, nombres originales, nombres nuevos y colisiones. Si uno de los destinos ya existe, el usuario puede cambiar la regla o excluir ese elemento. La vista previa todavía no modifica los archivos, por lo que resulta posible corregir la intención sin reparar después una mutación parcial.

Aplicar el lote requiere el `previewToken` recibido. De este modo, el agente no puede transformar una explicación general en un conjunto diferente de cambios. Si la carpeta se modifica, aparece otro archivo o la propuesta deja de representar el estado actual, la ruta segura es generar una vista previa nueva.

La aplicación conserva una aprobación destructiva propia. Haber autorizado la búsqueda o la vista previa no autoriza automáticamente el renombrado. Justo antes de aplicar, el usuario vuelve a ver el alcance y confirma el lote asociado al token.

Después, el plugin debe devolver resultados por elemento: aplicado, omitido o fallido, junto con la ruta observada. Una comprobación posterior vuelve a listar la carpeta para confirmar que los nombres reales coinciden con la propuesta aprobada.

Borrado permanente, descargas y conflictos

La versión actual de File Manager ejecuta el borrado como eliminación permanente. El archivo no pasa por una papelera gestionada por el plugin y la operación no ofrece deshacer. Por eso la aprobación debe mostrar la ruta exacta, el tipo de elemento y, si se trata de una carpeta, el alcance que resultará afectado.

Antes de eliminar, conviene realizar una lectura o listado independiente y conservar una copia cuando el contenido sea importante. Una petición como “borra los duplicados” necesita convertirse primero en una selección concreta. El agente puede buscar candidatos y mostrar coincidencias, pero el usuario decide qué rutas entran en la eliminación.

Tras aprobar, el resultado debe indicar qué elementos desaparecieron y cuáles no pudieron eliminarse. La verificación posterior comprueba la ausencia en la ruta original. Ante una respuesta incierta, el agente revisa el estado antes de repetir para evitar aplicar dos veces una operación destructiva.

Las descargas utilizan direcciones HTTPS y escriben en una ruta relativa del almacenamiento externo. La propuesta debe enseñar el origen, la carpeta de destino y el nombre final. Si ya existe un archivo con ese nombre, el flujo presenta el conflicto y permite elegir otro destino; no necesita asumir una sobrescritura.

El permiso `INTERNET` permite la conexión, mientras `MANAGE_EXTERNAL_STORAGE` habilita la escritura en el ámbito correspondiente. Ninguno de ellos sustituye la aprobación de la descarga concreta. Después de escribir, el plugin devuelve la ruta observada y la tarea puede comprobar que el archivo existe y que su tamaño resulta coherente con la respuesta.

Para operaciones de eliminación o descarga, el historial debe conservar la solicitud, el objetivo aprobado y el resultado. Identidad de agentes de IA: permisos, aprobación por herramienta y auditoría en Android explica cómo relacionar identidad, acción y evidencia sin mezclar permisos generales con decisiones puntuales.

Cómo instalar y ejecutar una primera tarea

La instalación comienza en los metadatos oficiales, no en una búsqueda abierta de APK. `plugin_search` consulta únicamente el catálogo oficial y devuelve la información disponible; esta operación no instala nada. Cuando el usuario elige File Manager, `plugin_request_install` crea una propuesta visible. Home presenta la solicitud y conserva la decisión final.

1. Buscar: localiza File Manager en los metadatos oficiales y comprueba que aparece la versión 0.0.4.
2. Revisar compatibilidad: confirma el paquete `ai.android.claw.plugin.device.filemanager` y el requisito mínimo del host FoneClaw indicado por los metadatos oficiales.
3. Verificar origen: compara la firma esperada, el hash publicado y los metadatos del APK antes de aceptar la instalación.
4. Inspeccionar permisos: revisa `MANAGE_EXTERNAL_STORAGE` e `INTERNET` y concede el acceso especial desde Android únicamente para las tareas previstas.
5. Registrar herramientas: tras instalar el APK, FoneClaw valida el paquete y registra su contrato disponible.
6. Probar: empieza listando una carpeta temporal y creando un archivo de prueba sin sobrescritura.

Una primera orden adecuada sería: “Lista `Download/Prueba-FoneClaw`; si existe, crea dentro `nota.txt` con el texto ‘prueba de File Manager’, sin reemplazar archivos”. El agente muestra las rutas, solicita aprobación para los efectos correspondientes y devuelve el resultado de cada paso.

Después, abre la carpeta con otro gestor o vuelve a listarla desde el plugin. La prueba pasa cuando el archivo aparece en la ubicación prevista, conserva el contenido correcto y cualquier conflicto se presenta sin alterar el elemento existente.

El repositorio oficial de FoneClaw para Android reúne la arquitectura pública y la documentación del sistema de plugins. Utilizar estos metadatos permite comprobar identidad, versión y contrato antes de otorgar acceso al almacenamiento.

Cómo evaluar confianza, resultados y recuperación

Un gestor de archivos con IA debe evaluarse mediante operaciones observables, no solo por la calidad de sus respuestas. Crea una carpeta temporal con archivos prescindibles y recorre lectura, creación, conflicto, vista previa, aplicación y eliminación antes de trabajar con documentos reales.

• Origen: el plugin procede del catálogo oficial y el APK coincide con el paquete, firma y hash esperados.
• Compatibilidad: la versión del host satisface el mínimo requerido por File Manager 0.0.4.
• Permisos: el acceso especial y la conexión a Internet se entienden y pueden retirarse desde Android.
• Ámbito: cada solicitud muestra una ruta relativa concreta dentro del almacenamiento externo permitido.
• Lectura: los archivos de texto se seleccionan expresamente y `maxBytes` limita el contenido recuperado.
• Creación: un conflicto de nombre detiene la operación sin reemplazar el archivo existente.
• Vista previa: el renombrado por lotes enseña todas las correspondencias y devuelve un `previewToken`.
• Aplicación: el lote aplicado coincide con la vista previa aprobada y produce resultados por elemento.
• Eliminación: la interfaz identifica el borrado permanente y solicita una aprobación destructiva.
• Descarga: el origen usa HTTPS, el destino es relativo y las colisiones se resuelven antes de escribir.
• Verificación: una lectura o listado posterior confirma el estado real del almacenamiento.
• Retirada: al desinstalar el plugin, sus herramientas dejan de registrarse y se revisa el acceso especial restante.

Incluye un fallo controlado en la prueba. Cambia un nombre después de generar la vista previa y comprueba que el sistema solicita recalcular el lote. Intenta crear un archivo ya existente y verifica que no se sobrescribe. Deniega el acceso especial para confirmar que la tarea explica el bloqueo en vez de declarar un resultado inexistente.

Android también permite revisar permisos y accesos especiales desde una perspectiva más amplia. Comprobar salud del teléfono Android con IA: permisos, accesos especiales y apps ocultas ofrece una ruta práctica para inspeccionar qué aplicaciones conservan capacidades sensibles.

En FoneClaw, el plugin amplía el agente con operaciones de archivos definidas y gobernadas. La combinación resulta útil cuando cada cambio conserva su ruta, aprobación y resultado, y cuando el usuario puede retirar tanto el paquete como su acceso al terminar.