Twoje pierwsze zadanie automatyzacji Androida.

Zanim zaczniesz

• Komputer z Windows albo Linuksem (może to być 64-bitowe Raspberry Pi) z dostępną wersją Talosa zgodną z jego architekturą.
• Narzędzia platformy Android: adb musi być dostępne dla konta, na którym działa Talos — w PATH albo wskazane jako Tools:AdbPath.
• Emulator Androida albo telefon z włączonym debugowaniem USB. Telefon z blokadą PIN-em, wzorem lub hasłem trzeba odblokować przed przebiegiem.
• Klucz API jednego dostawcy modelu — Claude (Anthropic), OpenAI, Google Gemini lub OpenRouter — albo endpoint HTTP zgodny z protokołem własnego dostawcy Talosa.
• Klucz licencji lub klucz próbny, gdy zainstalowana wersja o niego poprosi. Licencjonowane instalacje potrzebują dostępu do serwera licencji.

FFmpeg jest opcjonalny i służy do podglądu ekranu na żywo (ustaw Tools:FfmpegPath, jeśli nie ma go w PATH). Appium nie jest potrzebne. Korzystanie z dostawcy AI jest rozliczane osobno od licencji Talosa.

1. Zainstaluj Talosa, ustaw hasło i aktywuj licencję

Wybierz dostępny instalator dla swojego komputera. Wersje na Windows działają jako aplikacja w zasobniku systemowym; pakiet .deb dla Linuksa instaluje usługę systemd. Postępuj według instrukcji dla opublikowanego pakietu i sprawdź jego architekturę.

Otwórz panel, zwykle pod adresem http://localhost:7700. Przy pierwszym uruchomieniu ustaw hasło panelu (co najmniej 8 znaków); chroni ono API, aktualizacje na żywo i podgląd ekranu. Następnie wklej klucz licencji, jeśli aplikacja poprosi o aktywację. Nie masz klucza? Poproś o darmową licencję próbną i zapisz klucz pokazany na ekranie.

Aktualizujesz starszą wersję? Zachowaj katalog danych. Pierwsze uruchomienie 0.4.0 jednorazowo aktualizuje lokalną bazę danych i przy długiej historii przebiegów może potrwać dłużej; zadania, ustawienia i zapisane klucze API zostają.

2. Podłącz urządzenie z Androidem

Uruchom emulator albo włącz debugowanie USB w telefonie i podłącz go do komputera. Zaakceptuj prośbę o autoryzację na telefonie. Sprawdź połączenie w terminalu:

adb devices

Urządzenie musi mieć status device, a nie unauthorized ani offline. Otwórz Urządzenia w Talosie i sprawdź podgląd ekranu. Przed każdym przebiegiem Talos wybudza ekran i zdejmuje blokadę bez zabezpieczenia; jeśli telefon ma PIN, wzór lub hasło, odblokuj go samodzielnie, inaczej przebieg zostanie pominięty bez wywołania modelu.

Emulator, który wymaga jawnego połączenia ADB, najpierw połącz pod adresem podanym w jego dokumentacji. Przeczytaj wskazówki dotyczące zgodności.

3. Wybierz dostawcę AI

W Ustawieniach wybierz dostawcę, wpisz jego klucz API, wybierz model i zapisz. Klucze zostają na twoim komputerze, a panel pokazuje tylko ich końcówkę. Agent wysyła do dostawcy cel, obserwacje interfejsu i potrzebne zrzuty ekranu; opcjonalny generator etapów korzysta z tego samego dostawcy i działa tylko na żądanie.

Claude, OpenAI i Gemini

Wybierz Anthropic Claude, OpenAI albo Google Gemini i model z listy lub wpisz nazwę innego modelu. Talos szacuje koszt każdego wywołania według cennika dostawcy; dla modelu spoza listy stosuje najwyższe stawki dostawcy, żeby budżet zadziałał raczej za wcześnie niż za późno.

OpenRouter

Wpisz klucz OpenRouter i wybierz model z aktualnego katalogu. Zadania mogą wykonywać tylko modele z wywoływaniem narzędzi, a modele bez obsługi obrazu nie dostają zrzutów ekranu. OpenRouter podaje faktyczny koszt każdego wywołania i Talos dolicza właśnie tę kwotę do budżetu.

Effort i model dla zadania

Effort (niski, średni, wysoki albo bardzo wysoki) to kompromis między kosztem wywołania a dokładnością; niższy effort może oznaczać więcej kroków, więc porównuj koszt wykonanych zadań. Każde zadanie może mieć własny model i effort, na przykład tańszy model do częstego sprawdzania, a każdy przebieg zapisuje, jakiego modelu i effortu użył.

Własny endpoint HTTP

Wybierz własnego dostawcę i podaj adres URL. Talos wysyła żądanie POST z polami system, tools, history, observation i opcjonalnym screenshot_base64, a w odpowiedzi oczekuje decyzji o narzędziu. Tekst z pola instrukcji dla modelu w Ustawieniach jest dopisywany do system. To protokół Talosa, a nie ustawienie zgodne z dowolnym API czatu.

Minimalna odpowiedź wygląda tak:

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

Numer elementu musi odnosić się do bieżącej obserwacji. Zamiast pojedynczego tool odpowiedź może zawierać listę calls z parami narzędzie–argumenty. Odpowiedzi HTTP 408, 429 i 5xx są traktowane jak chwilowa awaria. Talos nie liczy kosztów własnego dostawcy; monitoruj je po stronie endpointu.

4. Utwórz małe zadanie z widocznym wynikiem

Otwórz Zadania, wybierz Nowe zadanie, nadaj mu nazwę i wybierz podłączone urządzenie. Urządzenie może mieć kilka zadań; wykonują się po kolei. Wpisz cel i wybierz tryb jednorazowy. Dodaj etapy ręcznie albo pozwól AI je zaproponować.

Zacznij od domyślnych limitów albo zmień liczbę iteracji, czas i szacowany koszt przebiegu. Budżet jest sprawdzany po każdej odpowiedzi modelu, więc ostatnie wywołanie może przekroczyć próg. Budżet dzienny zadania i wspólny budżet dzienny w Ustawieniach ograniczają wydatki w wielu przebiegach.

Zadanie możesz zduplikować albo wyeksportować do pliku .talos-task.json i zaimportować na innym telefonie lub w innej instalacji. Plik zawiera definicję razem z etapami, limitami, modelem i godzinami pracy, ale bez urządzenia i historii przebiegów.

Panel domyślnie uruchamia się po angielsku; język zmienisz na polski (a także na Deutsch, Español, Français lub 简体中文) w nagłówku albo w Ustawieniach. Zrzuty ekranu na tej stronie pokazują polski interfejs, więc nazwy przycisków zgadzają się z tą instrukcją.

5. Uruchom zadanie i przejrzyj oś czasu

Nowe zadania są tworzone jako zatrzymane. Uruchom zadanie z jego karty. Otwórz podgląd urządzenia, żeby śledzić ekran, albo przerwij przebieg przyciskiem Stop. Gdy na urządzeniu nie trwa żaden przebieg, możesz stuknąć w podgląd, wpisać tekst i użyć przycisków Wstecz, Ekran główny, Ostatnie aplikacje lub Wybudź ekran, żeby ręcznie poprawić jego stan.

W historii przebiegów zobaczysz obserwacje, wyjaśnienia zgłoszone przez model, narzędzia i argumenty, wyniki, zużycie tokenów, koszt i dostępne zrzuty ekranu; wpisy dziennika z danego przebiegu są o jedno kliknięcie. Talos trzyma 10 ostatnich przebiegów każdego zadania, a dzienne sumy kosztów zapisuje osobno. Zanim uznasz wynik za pewny, sprawdź ekran końcowy.

Powtarzaj zadanie w trybie ciągłym

Wybierz tryb ciągły i ustaw przerwę od 10 do 86 400 sekund. Po udanym cyklu Talos zapisuje podsumowanie i planuje kolejny cykl. To podsumowanie pomaga agentowi kontynuować pracę z zachowaniem kontekstu.

Godziny pracy ograniczają cykle do wybranych dni i przedziału czasu, np. poniedziałek–piątek 9:00–17:00, według czasu lokalnego serwera. Poza tym oknem zadanie czeka bez przebiegów i kosztów; rozpoczęty cykl kończy się normalnie.

Chwilowe problemy — przeciążone lub niedostępne API, odłączony telefon, zablokowany ekran — są ponawiane do czterech razy z rosnącą przerwą, od długości przerwy cyklu do 30 minut. Stop, osiągnięty limit, błąd konfiguracji albo zadanie, które model uzna za niewykonalne, zatrzymują pracę. Po wyczerpaniu budżetu dziennego zadanie zamiast tego czeka do następnego dnia.

Limity dotyczą jednego cyklu, a koszty się sumują. Stop anuluje też zaplanowany kolejny cykl. Zanim zmienisz definicję zadania, zatrzymaj je i poczekaj, aż bieżący przebieg się zakończy. Pamięć to podsumowanie wygenerowane przez model, a nie dokładny rejestr zdarzeń. Zobacz przykład cyklicznego sprawdzania statusu.

Dostawaj powiadomienia, gdy zadanie wymaga uwagi

W Ustawieniach → Powiadomienia wybierz kanał: webhook (POST z JSON), Discord, Telegram, ntfy albo e-mail przez SMTP. Potem wybierz zdarzenia: zatrzymanie przez błąd (także po wyczerpaniu ponowień), przerwanie limitem, wyczerpany budżet dzienny, odłączony telefon z włączonym zadaniem albo wykonane zadanie jednorazowe.

Trwające ponowienia i twój własny Stop nie wysyłają powiadomień, a to samo zdarzenie tego samego zadania wychodzi najwyżej raz na 10 minut. Przycisk Wyślij test sprawdza zapisaną konfigurację. Treść powiadomień jest na razie tylko po polsku; webhook przekazuje też kod zdarzenia niezależny od języka.

Jeśli pierwszy przebieg się nie uda

Talos nie widzi urządzenia

Sprawdź adb devices na koncie, na którym działa Talos. Autoryzuj debugowanie USB i sprawdź kabel albo połączenie z emulatorem. Usługa na Linuksie może działać na innym koncie niż twój terminal. Jeśli adb nie ma w PATH, ustaw Tools:AdbPath.

Agent nie może dotrzeć do ekranu

Odblokuj telefon z PIN-em lub wzorem, sprawdź uprawnienia aplikacji i przejrzyj oś czasu. Spróbuj krótszego celu z jednym widocznym kryterium sukcesu.

Zadanie zatrzymuje się na limicie

Zanim podniesiesz limity, przejrzyj zapisany wynik. Szukaj powtarzającego się ekranu, niedostępnej opcji albo niejednoznacznych instrukcji. Zadanie, które wyczerpało budżet dzienny, wróci do pracy następnego dnia.

Podgląd nie działa na żywo

Sprawdź FFmpeg i ustawienie podglądu na żywo. Do diagnozy połączenia użyj zwykłego podglądu urządzenia.

Nie pamiętasz hasła panelu

Uruchom Talosa raz z Talos__Auth__ResetPassword=true, ustaw nowe hasło w przeglądarce i usuń tę opcję. Dokładne polecenia dla usługi systemd znajdziesz w panelu w Instrukcje → Hasło panelu.

Weryfikacja licencji się nie udaje

Sprawdź klucz, liczbę wolnych aktywacji i połączenie z serwerem licencji. Działająca instalacja pracuje do 72 godzin od ostatniej udanej weryfikacji, a zatrzymanie zadań działa zawsze.

Strona Diagnostyka w panelu pokazuje wersję, stan adb i FFmpeg, urządzenia, katalog danych, licencję i ostatnie problemy. Jeśli potrzebujesz pomocy, napisz do twórcy Talosa i dołącz tekst z przycisku Kopiuj raport oraz opis kroku, który się nie udał. Z tego, co udostępniasz, usuń prywatną treść ekranu i klucze.