Skip to content

de AI AGENTS

github-actions[bot] edited this page Nov 17, 2026 · 6 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


KI-Agenten auf deinem Gerät

Ein ständig laufender SSH-Endpunkt macht dein Telefon zu etwas, das ein autonomer KI-Agent direkt bedienen kann. Jeder Agent, der eine Shell oder eine SSH-Verbindung steuern kann (Claude Code, aider, ein Skript mit einem LLM in der Schleife, deine eigene Automatisierung) erhält eine echte Root-Sitzung auf dem Gerät, über das Netzwerk, ohne USB-Kabel und ohne die sich selbst verratenden Debug-Flags von ADB.

Diese Seite vertieft die Idee, die in der README vorgestellt wird.

Warum SSH statt ADB für Agenten

ADB macht sich bemerkbar: adb_enabled und development_settings_enabled sind für alle lesbar, die Verbindung wird protokolliert, und es gibt keinen unterstützten Weg, zu verbergen, dass Debugging aktiv ist (oder war). Ein Agent, der über ADB arbeitet, hinterlässt diese Spur auf dem Gerät, die jede App oder jedes Anti-Betrugs-SDK auslesen kann. VD Dropbear ist die private Alternative: eine normale SSH-Anmeldung, mit Zugangsdaten, die du kontrollierst, und einem Banner, das nichts verrät.

Was ein Agent tun kann

Über eine einzige Verbindung sieht ein Agent eine normale Linux-artige Shell und kann:

  • Dateien lesen und bearbeiten, Einstellungen umschalten sowie Module, Pakete und Dienste verwalten;
  • Logs sichten, Artefakte abrufen und bei Bedarf Diagnosen oder Forensik ausführen;
  • Dateien in beide Richtungen über scp / sftp / rsync verschieben und synchronisieren: Backups, Migrationen, Provisionierung;
  • eine ganze Flotte gerooteter Geräte von einem Ort aus steuern, jedes über seinen eigenen Schlüssel erreichbar.

Weil das Projekt darauf ausgelegt ist, KI-freundlich zu sein (eine dokumentierte Konfigurationsdatei, ein expliziter Env-Vertrag zur Laufzeit, vorhersehbare Pfade und Status im Klartext), kann ein Agent ohne Raten herausfinden, wie er es benutzt.

Sicher vorgehen

Das ist Root, also behandle es wie Root:

  • gib dem Agenten eigene Zugangsdaten, nicht deine persönlichen, und verweise ihn auf ein Konto mit geringeren Rechten (shell), wenn du seine Reichweite begrenzen willst;
  • beschränke die Bindungen auf Netzwerke, denen du vertraust: Loopback oder ein VPN statt des offenen Internets (siehe Konfiguration);
  • lass die Passwort-Authentifizierung aus; ein Schlüssel ist widerrufbar und wird nie eingetippt;
  • du kannst einen Schlüssel jederzeit widerrufen oder den Daemon über die WebUI stoppen;
  • denk daran, dass eine Standardverbindung eine vollständige Root-Sitzung ist: gib dem Agenten nur die Reichweite, die er braucht.

Eine minimale Einrichtung

  1. Erzeuge ein Schlüsselpaar nur für den Agenten.
  2. Füge seinen öffentlichen Schlüssel in der WebUI hinzu (Authorized keys).
  3. Binde nur an Loopback oder dein VPN, auf einem nicht standardmäßigen Port.
  4. Richte die SSH-Konfiguration des Agenten auf das Gerät und lass ihn arbeiten.

Über USB, ohne ADB: Schalte USB-Tethering ein und binde an die USB-Adresse für eine reine Kabelverbindung, praktisch für einen Agenten auf einem per Kabel verbundenen Laptop. Siehe das Benutzerhandbuch.


Diese Dokumentation wurde mit Claude (Anthropic) erstellt und wird von VD171 gepflegt. Korrekturen und Verbesserungen sind willkommen; siehe CONTRIBUTING.md.

Clone this wiki locally