Deine erste Aufgabe zur Android-Automatisierung.

Bevor du anfängst

• Ein Windows- oder Linux-Host (auch ein 64-Bit-Raspberry-Pi) mit einem verfügbaren Talos-Build für seine Architektur.
• Android-Plattformtools: adb muss für das Konto verfügbar sein, unter dem Talos läuft – im PATH oder als Tools:AdbPath eingetragen.
• Ein Android-Emulator oder ein Telefon mit aktiviertem USB-Debugging. Ein Telefon mit PIN, Muster oder Passwort muss vor einem Durchlauf entsperrt sein.
• Ein API-Schlüssel für einen Modellanbieter – Claude (Anthropic), OpenAI, Google Gemini oder OpenRouter – oder ein HTTP-Endpunkt, der das Talos-Protokoll für eigene Anbieter umsetzt.
• Ein Lizenz- oder Testschlüssel, wenn der installierte Build danach fragt. Lizenzierte Installationen brauchen Zugriff auf den Lizenzserver.

FFmpeg ist optional und wird für das Live-Streaming des Bildschirms genutzt (setze Tools:FfmpegPath, wenn es nicht im PATH liegt). Appium ist nicht erforderlich. Die Nutzung des KI-Anbieters ist von der Talos-Lizenz getrennt.

1. Talos installieren, Passwort festlegen und aktivieren

Wähle einen verfügbaren Installer für deinen Host. Windows-Builds laufen als Tray-Anwendung; das Linux-Paket (.deb) installiert einen systemd-Dienst. Folge den Hinweisen zum veröffentlichten Paket und prüfe seine Architektur.

Öffne das Dashboard, normalerweise unter http://localhost:7700. Beim ersten Start legst du ein Dashboard-Passwort mit mindestens 8 Zeichen fest; es schützt die API, Live-Aktualisierungen und Bildschirmvorschauen. Füge danach deinen Lizenzschlüssel ein, falls eine Aktivierung verlangt wird. Noch keinen Schlüssel? Fordere eine kostenlose Testlizenz an und speichere den angezeigten Schlüssel.

Aktualisierst du eine ältere Version? Behalte das Datenverzeichnis. Der erste Start von 0.4.0 aktualisiert die lokale Datenbank einmalig und kann bei langem Durchlaufverlauf länger dauern; Aufgaben, Einstellungen und gespeicherte API-Schlüssel bleiben erhalten.

2. Ein Android-Gerät verbinden

Starte deinen Emulator oder aktiviere USB-Debugging auf deinem Telefon und schließe es an den Host an. Bestätige die Autorisierungsabfrage auf dem Telefon. Prüfe die Verbindung im Terminal:

adb devices

Das Gerät muss mit dem Status device erscheinen, nicht unauthorized oder offline. Öffne in Talos die Geräte und prüfe die Bildschirmvorschau. Vor jedem Durchlauf weckt Talos den Bildschirm und schließt einen Sperrbildschirm ohne Sicherung; nutzt das Telefon PIN, Muster oder Passwort, entsperre es selbst, sonst wird der Durchlauf ohne Modellaufruf übersprungen.

Ein Emulator, der eine ausdrückliche ADB-Verbindung braucht, muss zuerst über seine dokumentierte Adresse verbunden werden. Hinweise zur Kompatibilität lesen.

3. KI-Anbieter wählen

Wähle in den Einstellungen einen Anbieter, gib seinen API-Schlüssel ein, wähle ein Modell und speichere. Schlüssel bleiben auf deinem Host und werden nur mit ihren letzten Zeichen angezeigt. Der Agent sendet Ziel, UI-Beobachtungen und relevante Screenshots an den Anbieter; der optionale Etappen-Generator nutzt denselben Anbieter und läuft nur auf Anfrage.

Claude, OpenAI und Gemini

Wähle Anthropic Claude, OpenAI oder Google Gemini und ein Modell aus der Liste oder gib einen anderen Modellnamen ein. Talos schätzt die Kosten jedes Aufrufs anhand der Anbieterpreise; für ein Modell außerhalb der Liste nutzt es die teuersten Tarife des Anbieters, damit Budgets eher zu früh als zu spät greifen.

OpenRouter

Gib einen OpenRouter-Schlüssel ein und wähle ein Modell aus dem Live-Katalog. Nur Modelle mit Tool-Aufrufen können Aufgaben ausführen, und Modelle ohne Bildeingabe erhalten keine Screenshots. OpenRouter meldet die tatsächlichen Kosten jedes Aufrufs, und Talos rechnet genau diesen Betrag auf das Budget an.

Effort und Modelle pro Aufgabe

Der Effort (niedrig, mittel, hoch oder sehr hoch) wägt die Kosten eines Aufrufs gegen Gründlichkeit ab; ein niedrigerer Effort kann mehr Schritte brauchen, vergleiche also die Kosten erledigter Aufgaben. Jede Aufgabe kann Standardmodell und Effort überschreiben, etwa mit einem günstigeren Modell für eine häufige Prüfung, und jeder Durchlauf speichert, welches Modell und welchen Effort er genutzt hat.

Eigener HTTP-Endpunkt

Wähle den eigenen Anbieter und gib seine URL ein. Talos sendet eine POST-Anfrage mit system, tools, history, observation und optional screenshot_base64 und erwartet eine Tool-Entscheidung zurück. Text aus dem Feld für Modellanweisungen in den Einstellungen wird an system angehängt. Das ist ein Talos-eigenes Protokoll, keine Einstellung, die mit jeder Chat-API funktioniert.

Eine minimale Antwort sieht so aus:

{
  "tool": "tap",
  "args": { "element": 8 },
  "reasoning": "Open the visible form",
  "input_tokens": 0,
  "output_tokens": 0
}

Die Elementnummer muss sich auf die aktuelle Beobachtung beziehen. Statt eines einzelnen tool kann eine Antwort eine calls-Liste mit Paaren aus Tool und Argumenten liefern. HTTP 408, 429 und 5xx gelten als vorübergehende Fehler. Kosten eigener Anbieter berechnet Talos nicht; überwache sie an deinem Endpunkt.

4. Eine kleine Aufgabe mit sichtbarem Ergebnis anlegen

Öffne Aufgaben, wähle Neue Aufgabe, gib ihr einen Namen und wähle ein verbundenes Gerät. Ein Gerät kann mehrere Aufgaben haben; sie laufen nacheinander. Gib ein Ziel ein und wähle den einmaligen Modus. Füge optionale Etappen von Hand hinzu oder lass die KI sie vorschlagen.

Beginne mit den Standardlimits oder passe Iterationen, Zeit und geschätzte Kosten für den Durchlauf an. Das Budget wird nach jeder Modellantwort geprüft, daher kann der letzte Aufruf deine Grenze überschreiten. Ein Tagesbudget für die Aufgabe und ein globales in den Einstellungen begrenzen die Ausgaben über mehrere Durchläufe.

Aufgaben lassen sich duplizieren oder in eine .talos-task.json-Datei exportieren und auf einem anderen Telefon oder in einer anderen Installation importieren. Die Datei enthält die Definition samt Etappen, Limits, Modell und Arbeitszeiten, aber nicht das Gerät oder den Durchlaufverlauf.

Das Dashboard startet auf Englisch und lässt sich auf Deutsch, Español, Français, 简体中文 oder Polski umstellen. Die Screenshots auf dieser Website zeigen die polnische Oberfläche: „Geräte“ heißt dort „Urządzenia“, „Aufgaben“ heißt „Zadania“, „Neue Aufgabe“ heißt „Nowe zadanie“ und „Einstellungen“ heißt „Ustawienia“.

5. Aufgabe starten und Zeitleiste prüfen

Neue Aufgaben werden gestoppt angelegt. Starte die Aufgabe auf ihrer Karte. Öffne die Gerätevorschau, um den Bildschirm zu verfolgen, oder unterbrich den Durchlauf mit Stopp. Solange auf dem Gerät kein Durchlauf läuft, kannst du in die Vorschau tippen, Text eingeben und mit Zurück, Startbildschirm, Letzte Apps oder Bildschirm aufwecken seinen Zustand von Hand korrigieren.

Im Durchlaufverlauf siehst du Beobachtungen, die vom Modell angegebenen Erklärungen, Tools und Argumente, Ergebnisse, Token-Verbrauch, Kosten und verfügbare Screenshots; die Protokolleinträge des Durchlaufs sind einen Klick entfernt. Talos behält die letzten 10 Durchläufe pro Aufgabe, die täglichen Kostensummen werden separat gespeichert. Prüfe den Endbildschirm, bevor du dich auf das Ergebnis verlässt.

Einen Ablauf im kontinuierlichen Modus wiederholen

Wähle den kontinuierlichen Modus und eine Pause von 10 bis 86.400 Sekunden. Nach einem erfolgreichen Zyklus speichert Talos eine Zusammenfassung und plant den nächsten Zyklus. Diese Zusammenfassung hilft dem Agenten, mit Kontext weiterzumachen.

Arbeitszeiten beschränken Zyklen auf ausgewählte Tage und ein Zeitfenster, etwa Montag–Freitag 9:00–17:00, in der lokalen Zeit des Servers. Außerhalb des Fensters wartet die Aufgabe ohne Durchläufe und Kosten; ein bereits gestarteter Zyklus endet normal.

Vorübergehende Probleme wie eine überlastete oder nicht erreichbare API, ein getrenntes Telefon oder ein gesperrter Bildschirm werden bis zu viermal mit wachsender Pause wiederholt, von der Zykluspause bis zu 30 Minuten. Stopp, ein erreichtes Limit, ein Konfigurationsfehler oder eine vom Modell als undurchführbar gemeldete Aufgabe beenden die Aufgabe. Ist das Tagesbudget aufgebraucht, wartet die Aufgabe stattdessen bis zum nächsten Tag.

Limits gelten pro Zyklus, und die Kosten summieren sich. Stopp bricht auch einen geplanten nächsten Zyklus ab. Stoppe eine laufende Aufgabe und lass sie enden, bevor du ihre Definition bearbeitest. Das Gedächtnis ist eine vom Modell erzeugte Zusammenfassung, kein exaktes Ereignisprotokoll. Beispiel für eine wiederkehrende Statusprüfung ansehen.

Benachrichtigt werden, wenn eine Aufgabe Aufmerksamkeit braucht

Wähle unter Einstellungen → Benachrichtigungen einen Kanal: Webhook (JSON-POST), Discord, Telegram, ntfy oder E-Mail über SMTP. Wähle dann die Ereignisse: Aufgabe durch einen Fehler gestoppt (auch nach ihren Wiederholungen), durch ein Limit gestoppt, Tagesbudget aufgebraucht, Telefon getrennt, während seine Aufgabe aktiviert war, oder einmalige Aufgabe erledigt.

Laufende Wiederholungen und dein eigener Stopp lösen keine Benachrichtigung aus, und dasselbe Ereignis derselben Aufgabe wird höchstens alle 10 Minuten gesendet. „Test senden“ prüft die gespeicherten Einstellungen. Die Benachrichtigungstexte sind derzeit auf Polnisch; Webhook-Nutzdaten enthalten zusätzlich einen sprachunabhängigen Ereigniscode.

Wenn der erste Durchlauf nicht klappt

Kein Gerät in Talos

Prüfe adb devices unter dem Konto, unter dem Talos läuft. Autorisiere USB-Debugging und prüfe die Kabel- oder Emulatorverbindung. Der Linux-Dienst kann unter einem anderen Konto laufen als dein Terminal. Liegt adb nicht im PATH, setze Tools:AdbPath.

Der Agent erreicht einen Bildschirm nicht

Entsperre ein Telefon mit PIN oder Muster, prüfe App-Berechtigungen und sieh dir die Zeitleiste an. Versuche ein kürzeres Ziel mit einem sichtbaren Erfolgskriterium.

Eine Aufgabe stoppt an einem Limit

Prüfe das gespeicherte Ergebnis, bevor du Limits erhöhst. Achte auf einen sich wiederholenden Bildschirm, eine nicht verfügbare Option oder mehrdeutige Anweisungen. Eine Aufgabe, die ihr Tagesbudget erreicht hat, macht am nächsten Tag weiter.

Die Vorschau streamt nicht

Prüfe FFmpeg und die Einstellung für die Live-Vorschau. Nutze die normale Gerätevorschau, um die Verbindung zu prüfen.

Du hast das Dashboard-Passwort vergessen

Starte Talos einmal mit Talos__Auth__ResetPassword=true, lege im Browser ein neues Passwort fest und entferne die Option wieder. Unter Anleitungen → Panel-Passwort zeigt das Dashboard die genauen Befehle für den systemd-Dienst.

Eine Lizenzprüfung schlägt fehl

Prüfe deinen Schlüssel, die Aktivierungsplätze und die Verbindung zum Lizenzserver. Eine laufende Installation arbeitet bis zu 72 Stunden nach der letzten erfolgreichen Prüfung weiter, und Aufgaben lassen sich immer stoppen.

Die Diagnoseseite im Dashboard zeigt Version, Status von adb und FFmpeg, Geräte, Datenverzeichnis, Lizenz und aktuelle Probleme. Für Hilfe schreib dem Talos-Entwickler mit dem Text aus „Bericht kopieren“ und einer Beschreibung des fehlgeschlagenen Schritts. Entferne private Bildschirminhalte und Schlüssel aus allem, was du teilst.