Android KI-Dateimanager-Agent-Plugin: Dateien kontrolliert verwalten

Welche Dateiaufgaben der Agent strukturieren kann

Ein Android KI-Dateimanager-Agent-Plugin verbindet natürlich formulierte Aufträge mit klar abgegrenzten Dateioperationen. Statt jeden Ordner manuell zu durchsuchen, kann der Nutzer beispielsweise nach Rechnungen suchen, eine Textdatei lesen, einen neuen Projektordner erstellen oder eine Gruppe von Dateien nach einem einheitlichen Schema umbenennen lassen. Das Modell versteht den Wunsch; die Werkzeuge des installierten Plugins führen die unterstützten Dateischritte aus.

Das aktuelle File Manager Plugin kann Verzeichnisse auflisten, Dateien suchen und Text bis zu einer angegebenen Größenbegrenzung lesen. Es kann neue Dateien ohne Überschreiben anlegen, Text schreiben, Ordner erstellen und eine einzelne Datei umbenennen. Für mehrere Umbenennungen gibt es einen getrennten Vorschau- und Anwendungsschritt. Hinzu kommen endgültiges Löschen und der Download über eine HTTPS-Adresse in einen relativen Pfad des externen Speichers.

Ein realistischer erster Auftrag lautet: „Suche im Ordner Downloads nach Textdateien mit ‚Rechnung‘ im Namen und zeige nur Name, Pfad und Größe.“ Dieser Auftrag verändert nichts. Er macht aber bereits drei wichtige Grenzen sichtbar: Welcher Ordner wird durchsucht? Welche Dateitypen gehören zum Ergebnis? Wie groß darf die zurückgegebene Datenmenge werden? Erst nachdem die Trefferliste geprüft wurde, sollte ein zweiter Auftrag eine Datei lesen oder verändern.

Dateioperationen unterscheiden sich in ihrer Wirkung. Auflisten und eine begrenzte Textdatei lesen liefern Informationen. Eine Datei anlegen oder umbenennen verändert den Speicher, bleibt aber häufig nachvollziehbar. Stapelumbenennung und endgültiges Löschen können viele Dateien betreffen und benötigen stärkere Kontrollpunkte. Ein Download kombiniert Netzwerkzugriff mit einer Schreiboperation und verlangt daher sowohl eine vertrauenswürdige Quelle als auch einen eindeutig gewählten Zielpfad.

Der beobachtete Endzustand zählt ebenso wie der ausgeführte Befehl. Nach einer Erstellung muss die Datei am erwarteten Pfad vorhanden sein. Nach einer Umbenennung sollten alter und neuer Name geprüft werden. Ein Download ist erst erfolgreich, wenn die Zieldatei geschrieben und ihr Ergebnis gemeldet wurde. FoneClaw hält diese Schritte als geregelte Aktionen im jeweiligen Aufgabenkontext sichtbar.

Warum der Dateimanager ein separates Plugin ist

Der Dateimanager ist kein eingebautes FoneClaw-Werkzeug. Er wird als eigenes Android-Plugin installiert und bringt ein separates APK, eine eigene Paketkennung, eine erwartete Signatur, eigene Berechtigungen und einen eigenen Werkzeugsatz mit. Diese Paketgrenze macht sichtbar, welche Erweiterung den Dateizugriff bereitstellt und wie sie wieder entfernt werden kann.

Die aktuellen offiziellen Paketmetadaten des File Manager Plugins führen Version 0.0.4 mit der Paketkennung ai.android.claw.plugin.device.filemanager. Als Mindestanforderung ist ein aktueller kompatibler FoneClaw-Host angegeben. Für den aktuellen Paketstand sind diese Metadaten maßgeblich; eine ältere Versionsangabe in begleitendem Beschreibungstext ändert den ausgewiesenen Installationsstand nicht.

Die Trennung schützt auch vor einer begrifflichen Vermischung. Ein eingebautes Werkzeug gehört zur FoneClaw-App und ihrer ausgelieferten Werkzeugverwaltung. Ein Plugin wird zusätzlich installiert, vom Host erkannt und erst danach mit seinen Werkzeugen registriert. Ein Skill wiederum kombiniert vorhandene Werkzeuge und Anweisungen, erzeugt aber keinen neuen Android-Dateizugriff. Wer diese Laufzeitprüfung genauer einordnen möchte, findet sie unter Sicherheit von KI-Agent-Skills: Warum Phone Agents Laufzeitprüfungen brauchen.

Dasselbe Paketmodell gilt für andere Erweiterungen, ohne deren Fähigkeiten zusammenzuwerfen. Der Artikel FoneClaw kostenlos nutzen: YouTube-Downloader-Plugin lokal auf Android mit Auswahl und Freigabe zeigt einen separaten Medienablauf. Das File Manager Plugin bleibt dagegen auf seine dokumentierten Dateioperationen ausgerichtet.

Für Nutzer ergibt sich daraus ein klarer Kontrollweg: Quelle prüfen, vorgeschlagenes Paket identifizieren, Version und Signatur kontrollieren, Installation bestätigen, benötigte Android-Rechte gezielt erteilen und erst danach die registrierten Werkzeuge verwenden. Wird das Plugin nicht mehr benötigt, kann das Paket deinstalliert und sein Dateizugriff entzogen werden, ohne die eingebauten FoneClaw-Funktionen als solche zu entfernen.

Dateizugriff und Pfadgrenzen richtig einordnen

Das File Manager Plugin fordert MANAGE_EXTERNAL_STORAGE, in Android als Zugriff auf alle Dateien dargestellt, sowie INTERNET für HTTPS-Downloads an. Der umfassende Dateizugriff ist technisch erforderlich, damit das Plugin unterstützte Operationen über den externen Speicher hinweg ausführen kann. Er bedeutet jedoch weder, dass jede Datei auf jedem Android-Gerät lesbar ist, noch dass jede mögliche Dateiaktion bereits genehmigt wurde.

Android kann bestimmte App-Bereiche, geschützte Inhalte oder herstellerspezifische Speicherorte weiterhin begrenzen. Zusätzlich können Dateien verschwunden, verschoben, gesperrt oder für das gewählte Format ungeeignet sein. Ein Agent muss deshalb den tatsächlichen Pfad und das beobachtete Ergebnis verwenden, statt aus einer erteilten Berechtigung pauschale Verfügbarkeit abzuleiten.

Das Plugin arbeitet bei seinen Datei- und Downloadaufträgen mit relativen Pfaden unterhalb des externen Speicherstamms. Ein Ziel wie Download/FoneClaw/Test.txt ist nachvollziehbarer als eine unklare Formulierung wie „irgendwo bei meinen Dateien“. Relative Pfade verhindern zugleich, dass eine natürlich formulierte Anfrage unmittelbar als beliebiger Systempfad behandelt wird. Vor einer Änderung sollte der normalisierte Zielpfad sichtbar sein.

Sensible Lesevorgänge brauchen eine enge Auswahl. „Lies alle Dateien“ ist kein sinnvoller erster Auftrag. Besser ist: „Lies höchstens 20 Kilobyte aus Documents/Test/Notiz.txt und fasse den Inhalt zusammen.“ Die Größenbegrenzung schützt vor unkontrollierter Datenmenge, während der konkrete Pfad verhindert, dass ähnliche Dateinamen verwechselt werden.

Berechtigung und Freigabe erfüllen unterschiedliche Aufgaben. Androids Dateizugriff erlaubt dem Plugin, eine unterstützte Operation technisch auszuführen. Die aufgabenspezifische Freigabe entscheidet, ob beispielsweise diese fünf Dateien jetzt umbenannt oder diese eine Datei endgültig gelöscht werden soll. Für den größeren Zusammenhang erklärt Identität von KI-Agenten: Berechtigungen, Genehmigungen und Audit-Trails für Phone Agents, wie Paketidentität, Android-Recht und konkrete Aktion voneinander getrennt bleiben.

Stapelumbenennungen vor der Anwendung prüfen

Eine Stapelumbenennung ist besonders fehleranfällig, weil ein einziges Muster viele Dateien verändert. Das File Manager Plugin teilt diesen Vorgang deshalb in Vorschau und Anwendung. Zuerst wird aus der aktuellen Dateiauswahl ein Plan erzeugt. Dieser zeigt für jede betroffene Datei den bisherigen und den vorgeschlagenen neuen Namen.

Die Vorschau liefert ein previewToken. Dieses Token bindet die spätere Anwendung an genau den geprüften Plan. Der Agent darf nicht lediglich dieselbe natürlichsprachliche Anweisung erneut interpretieren und damit möglicherweise eine inzwischen veränderte Dateimenge bearbeiten. Für die Anwendung wird das Token des sichtbaren Vorschauergebnisses benötigt.

Angenommen, im Ordner Download/Scans liegen fünf Dateien mit uneinheitlichen Namen. Der Nutzer bittet: „Benenne die PDF-Dateien nach dem Muster Rechnung-2026- fortlaufend um.“ Die Vorschau sollte Quellpfade, neue Namen und mögliche Konflikte zeigen. Sind bereits Dateien mit einem vorgeschlagenen Zielnamen vorhanden, muss der Konflikt vor der Anwendung geklärt werden.

Zwischen Vorschau und Freigabe kann sich der Ordner verändern. Eine weitere Datei könnte hinzukommen, eine Quelle könnte verschoben werden oder ein Zielname könnte inzwischen belegt sein. Das gebundene Token verhindert, dass die Anwendung still auf eine neu berechnete Auswahl ausweicht. Kann der ursprüngliche Plan nicht mehr sicher angewendet werden, braucht es eine aktualisierte Vorschau und eine neue Entscheidung.

Die Freigabe sollte daher nicht nur „Umbenennen bestätigen“ anzeigen. Nützlich sind Ordner, Anzahl der betroffenen Dateien, Namensmuster, Konflikte und eine aufklappbare Liste der Änderungen. Nach der Anwendung wird erneut aufgelistet, welche Dateien erfolgreich umbenannt wurden und welche unverändert blieben. Ein teilweises Ergebnis darf nicht als vollständiger Erfolg erscheinen.

Für einzelne Umbenennungen ist der Ablauf kürzer, benötigt aber weiterhin einen eindeutigen Quell- und Zielpfad. Auch hier sollte eine vorhandene Zieldatei nicht unbemerkt ersetzt werden. Das gleiche Grundprinzip gilt für das Anlegen neuer Dateien: Die dokumentierte Erstellung erfolgt ohne Überschreiben und macht einen Namenskonflikt sichtbar.

Endgültiges Löschen und HTTPS-Downloads absichern

Die aktuelle Löschfunktion des File Manager Plugins entfernt Dateien endgültig. In dieser ersten Ausführung gibt es keinen Plugin-Papierkorb und keine integrierte Rückgängig-Funktion. Deshalb ist Löschen als destruktive Aktion eingestuft und verlangt eine ausdrückliche Freigabe, die genaue Ziele und Folgen zeigt.

Ein sicherer Löschauftrag beginnt mit einer Such- oder Auflistungsoperation. Der Nutzer kann beispielsweise veraltete Testdateien in einem bestimmten Ordner anzeigen lassen. Erst die geprüfte Auswahl wird an den Löschschritt übergeben. Die Vorschau sollte vollständige relative Pfade, Dateitypen und Anzahl nennen. Bei mehrdeutigen Treffern oder einem zu breiten Ordner wird nicht gelöscht, sondern die Auswahl weiter eingegrenzt.

Nach der Freigabe muss das Ergebnis beobachtet werden. Das Plugin prüft, welche Ziele nicht mehr vorhanden sind und ob einzelne Löschvorgänge fehlgeschlagen sind. Da keine Rücknahme angeboten wird, sollte der Nutzer vor dem Test ausschließlich entbehrliche Beispieldateien verwenden oder selbst eine Sicherung anlegen. Eine Formulierung wie „Räume Downloads auf“ ist für eine endgültige Löschaktion zu unspezifisch.

Downloads kombinieren Netzwerk- und Dateizugriff. Das Plugin akzeptiert HTTPS-Adressen und schreibt die Datei an einen relativen Pfad im externen Speicher. Vor dem Start gehören Quelle, Dateiname und Zielordner in die Freigabeansicht. Eine Adresse ohne HTTPS wird nicht als zulässiger Downloadauftrag behandelt.

Auch Namenskonflikte müssen vor dem Schreiben sichtbar werden. Existiert am Ziel bereits eine Datei, sollte der Nutzer zwischen neuem Namen, anderem Ordner oder Abbruch wählen. Ein automatisches Überschreiben darf nicht aus einem allgemeinen „Herunterladen“-Befehl abgeleitet werden. Nach Abschluss werden Zielpfad und beobachtetes Schreibergebnis angezeigt; bei einer Unterbrechung bleibt erkennbar, ob keine, eine unvollständige oder eine vollständig geschriebene Datei vorliegt.

Die Internetberechtigung erlaubt den Netzwerkzugriff des Pakets, ist aber keine Zustimmung zu jeder Adresse. Ebenso erlaubt der umfassende Dateizugriff das Schreiben im unterstützten Speicherbereich, bestätigt jedoch nicht das konkrete Ziel. Quelle, Ziel und Ausführung bleiben drei getrennte Kontrollpunkte.

Plugin installieren und risikoarm testen

Die Installation beginnt mit einer Suche in den offiziellen Plugin-Metadaten. FoneClaws Suchfunktion liefert dabei nur Informationen zu passenden Paketen; sie lädt nichts herunter und installiert nichts. Das Ergebnis sollte Name, Paketkennung, Version, erforderliche Host-Version, angeforderte Berechtigungen und Herkunft zeigen.

Wählt der Nutzer das File Manager Plugin aus, erstellt FoneClaw einen sichtbaren Installationsvorschlag. Auch dieser Schritt installiert das APK noch nicht. In Home erscheint die eigentliche Entscheidung mit Paketdetails, erwarteter Signatur und Prüfsumme. Erst nach der Nutzerbestätigung beginnt der Installationsweg. Der Host prüft, ob Paketkennung, Metadaten und Unterzeichner zur erwarteten Erweiterung passen.

Die aktuelle öffentliche FoneClaw-Dokumentation und der Quellcode beschreiben die Plugin-Architektur. Die offizielle Übersicht zur Plugin-Nutzung erklärt den allgemeinen Installationsweg. Für die aktuell ausgewiesene File-Manager-Version bleiben die Paketmetadaten ausschlaggebend.

1. In den offiziellen Metadaten nach dem File Manager Plugin suchen.
2. Paketkennung ai.android.claw.plugin.device.filemanager, Version 0.0.4 und ausgewiesene Mindestanforderung an den FoneClaw-Host prüfen.
3. Installationsvorschlag in Home öffnen und Herkunft, erwarteten Unterzeichner sowie Prüfsumme kontrollieren.
4. Installation ausdrücklich bestätigen.
5. Den Zugriff auf alle Dateien und den Netzwerkzugriff in Android prüfen und nur bei tatsächlichem Bedarf gewähren.
6. Nach der Installation kontrollieren, welche Plugin-Werkzeuge FoneClaw registriert hat.
7. Mit einer rein lesenden Aufgabe in einem selbst angelegten Testordner beginnen.

Ein geeigneter erster Testordner ist Download/FoneClaw-Test. Legen Sie dort manuell zwei unkritische Textdateien an. Bitten Sie FoneClaw anschließend, den Ordner aufzulisten, nach einer Datei zu suchen und höchstens einen kleinen Textabschnitt zu lesen. Erst wenn Pfade und Ergebnisse stimmen, folgt das Anlegen einer neuen Datei ohne Überschreiben.

Der nächste Test kann eine einzelne Umbenennung sein. Eine Stapelumbenennung, ein Download und besonders das Löschen folgen erst danach. Auf diese Weise lässt sich für jede Operationsklasse prüfen, wie Pfad, Freigabe, Konflikt und Endzustand dargestellt werden, ohne persönliche Dokumente zu gefährden.

Vertrauen, Freigaben und Ergebnisse kontrollieren

Ein Dateimanager-Agent ist dann nützlich, wenn er nicht nur Befehle ausführt, sondern die Auswahl und Wirkung einer Dateioperation verständlich macht. Die folgende Checkliste deckt Installation, Nutzung und Entfernung des Plugins ab.

• Quelle: Stammt der Paketvorschlag aus den offiziellen Metadaten?
• Paketidentität: Stimmen Name, Paketkennung, Version, erwarteter Unterzeichner und Prüfsumme?
• Host-Kompatibilität: Erfüllt die installierte FoneClaw-Version die angegebene Mindestversion?
• Berechtigungen: Sind Zugriff auf alle Dateien und Internetzugriff für die geplanten Aufgaben tatsächlich erforderlich?
• Pfadgrenze: Zeigt der Auftrag einen eindeutigen relativen Pfad im externen Speicher?
• Leseumfang: Sind Dateiauswahl und maximale Textmenge begrenzt?
• Konflikte: Werden vorhandene Zielnamen vor Erstellung, Umbenennung oder Download sichtbar?
• Vorschau: Wird eine Stapelumbenennung vollständig angezeigt und über ihr previewToken an die geprüfte Auswahl gebunden?
• Freigabe: Sind verändernde und destruktive Aktionen von rein lesenden Schritten getrennt?
• Löschen: Ist klar, dass die aktuelle Plugin-Version endgültig und ohne eingebauten Papierkorb löscht?
• Ergebnis: Wird nach Schreiben, Umbenennen, Download oder Löschen der beobachtete Endzustand gemeldet?
• Verlauf: Bleiben Plugin, Werkzeug, Zielpfad, Freigabe und Ergebnis dem richtigen Auftrag zugeordnet?
• Wiederherstellung: Gibt es vor destruktiven Tests eine eigene Sicherung wichtiger Dateien?
• Entfernung: Lassen sich Plugin, Android-Berechtigungen und nicht mehr benötigte Testdateien anschließend vollständig entfernen?

Eine regelmäßige Berechtigungsprüfung ist besonders sinnvoll, wenn das Plugin nur gelegentlich verwendet wird. Android-Handycheck mit KI: Berechtigungen, versteckte Apps und Gerätezustand prüfen zeigt, wie installierte Pakete und weitreichende Zugriffe im größeren Android-Kontext kontrolliert werden können.

Der zentrale Vertrag bleibt einfach: Das Modell strukturiert die Aufgabe, das separat installierte Plugin stellt die dokumentierten Dateiwerkzeuge bereit, Android kontrolliert den technischen Zugriff und der Nutzer genehmigt die konkrete Wirkung. Pfad, Vorschau, Konflikt und beobachtetes Ergebnis bleiben sichtbar. So wird das Android KI-Dateimanager-Agent-Plugin zu einer praktischen Erweiterung, ohne Paketvertrauen und Dateikontrolle in einer unsichtbaren Automatik zu verstecken.