Ehrlicher Hinweis: NICHT offizieller Ablauf, von uns nicht getestet
Weder Anthropic noch Google unterstützen es, einen Agenten mit Termux auf einer TV-Box laufen zu lassen. Wir haben es nicht von Anfang bis Ende auf einer bestimmten Box getestet: Der Guide kombiniert Bausteine, die es gibt und die einzeln funktionieren (Termux, Termux:Boot, Wake Lock, die Claude-API und Telegram-Bots). Jede China-Box ist eine Welt für sich, und bei deiner kann sich ein Schritt unterscheiden. Geh es in Ruhe an, mit einer Box, an der du ruhig herumbasteln darfst.
Eine Android-TV-Box für 30 € (oder ein altes Handy aus der Schublade) kann als „Rechner, der 24/7 läuft“ für einen KI-Agenten dienen. Die Box führt nur aus; Claude denkt in der Cloud. Du sprichst über einen privaten Telegram-Bot mit ihm, der nur dir antwortet, auch wenn dein Laptop aus ist.
So funktioniert es
Du schreibst dem Bot
Über Telegram, auf deinem Handy, wo immer du bist.
Die Box holt die Nachricht ab
Termux fragt alle paar Sekunden bei Telegram nach (Long Polling, ohne Ports zu öffnen).
Claude denkt in der Cloud
Die Box schickt die Aufgabe an die Claude-API und bekommt die Antwort.
Die Antwort kommt bei dir an
Der Bot schickt sie dir per Telegram zurück. Nur an deine chat_id.
Wofür es taugt (und wofür nicht)
| Ja | Nein |
|---|---|
| Texte zusammenfassen, formulieren, Fragen beantworten | Nichts Schweres: Sie hat 2 GB RAM |
| Geplante Benachrichtigungen jeden Morgen | Nichts, was einen echten Browser braucht |
| Kleine, wiederkehrende Skripte | Einen Mac Mini ersetzen: Sie ist viel, viel langsamer |
Was du brauchst
- Eine eigene Android-TV-Box: etwa X96Q, H96 oder ähnlich, ARM-Chip mit 4 Kernen, 2 GB RAM und Android 7 oder höher (besser 9+). Etwa 25–35 €. Nicht den Receiver deines Anbieters: Der ist meist gesperrt, gehört ihnen, und daran herumzubasteln kann gegen deinen Vertrag verstoßen.
- WLAN oder Kabel sowie eine USB-Tastatur/-Maus (oder die Fernbedienungs-App auf dem Handy) für die ersten Schritte.
- Ein Konto in der Claude-Konsole (platform.claude.com) mit Guthaben. Die API wird nach Nutzung abgerechnet; das ist nicht das Pro-Abo.
- Telegram auf dem Handy.
Schritt 0: der Prompt (Foto + Claude)
Mach ein Foto von der Box (und vom Etikett auf der Unterseite, falls dort ein Modell steht) und füg es mit diesem Prompt in claude.ai ein. Claude führt dich dann passend zu deiner Box durch:
Das ist meine Android-TV-Box (Foto im Anhang). Ich will daraus einen Server machen, der rund um die Uhr einen KI-Agenten ausführt, auch wenn mein Laptop aus ist. Plan:
1) Bestimme das Modell, den Chip (ARM-Architektur, 32 oder 64 Bit) und die wahrscheinliche Android-Version. Wenn du es nicht sicher weißt, sag mir, wie ich es in den Einstellungen oder mit "uname -m" und "getprop ro.build.version.release" prüfe.
2) Führ mich Schritt für Schritt durch die Installation von Termux und Termux:Boot aus F-Droid (nicht Google Play) auf GENAU diesem Gerät, mit den nötigen Android-Einstellungen (unbekannte Quellen, Akku-Optimierung für Termux abschalten).
3) Sorg dafür, dass Android den Prozess nicht beendet: termux-wake-lock und Autostart mit Termux:Boot.
4) Schreib mir einen Telegram-Bot in Python OHNE externe Abhängigkeiten (nur Standardbibliothek), der:
- Long Polling nutzt (ohne Ports zu öffnen),
- NUR auf meine chat_id antwortet (liest sie aus einer Umgebungsvariable) und alle anderen ignoriert,
- meine Nachrichten an die Claude-API schickt und mir die Antwort zurückgibt,
- die Schlüssel aus Umgebungsvariablen liest. Bitte mich NIE, dir meine Schlüssel in diesen Chat zu kopieren.
5) Sag mir, wie ich es teste und wie ich die Logs ansehe, wenn es scheitert.
Geh Schritt für Schritt vor: Gib mir einen Schritt, warte, bis ich „erledigt“ oder die Fehlermeldung schreibe, und mach dann weiter.Unten findest du denselben Weg ausgeschrieben, falls du es lieber von Hand machst.
Schritt 1: Termux und Termux:Boot aus F-Droid
- Öffne auf der Box den Browser und lade F-Droid von f-droid.org herunter. Erlaube die Installation von Apps aus „unbekannten Quellen“, wenn du gefragt wirst.
- Installiere über F-Droid Termux und Termux:Boot. Beide aus derselben Quelle: Termux:Boot führt Skripte nur aus, wenn es mit demselben Schlüssel signiert ist wie Termux, und jeder Store signiert mit einem anderen Schlüssel.
- Öffne Termux:Boot einmal (nur öffnen). So erlaubt Android den Start beim Einschalten.
- Android-Einstellungen → Apps → Termux → Akku → Nicht eingeschränkt / nicht optimieren.
Schritt 2: Linux in Termux vorbereiten
Öffne Termux und gib ein:
pkg update && pkg upgrade -y
pkg install -y python
uname -m # aarch64 = 64-Bit-ARM (der Normalfall)
Schritt 3: der Telegram-Bot
- Sprich in Telegram mit @BotFather →
/newbot→ gib ihm einen Namen. Du bekommst einen Token: Teile ihn mit niemandem. - Deine chat_id: Schreib deinem neuen Bot irgendetwas und öffne im Browser
https://api.telegram.org/bot<DEIN_TOKEN>/getUpdates. Such nach"chat":{"id":123456789: Diese Zahl ist deine chat_id.
Schritt 4: die Schlüssel, raus aus dem Code und raus aus dem Chat
Erstelle in der Claude-Konsole unter API keys einen Schlüssel. Dann in Termux:
nano ~/.agente.env
Füg das mit deinen Werten ein:
export ANTHROPIC_API_KEY="sk-ant-..."
export TELEGRAM_TOKEN="123456:ABC..."
export CHAT_ID="123456789"
export MODELO="hier-die-modell-id-eintragen"
Die Modell-ID kopierst du aus der offiziellen Modellliste (ein Haiku ist für kleine Aufgaben am günstigsten). Speichere (Strg+O, Enter, Strg+X) und schütze die Datei:
chmod 600 ~/.agente.env
Setz ein Ausgabenlimit
Leg in der Claude-Konsole unter Limits eine monatliche Ausgabengrenze fest. So gibt es keinen Schreck, selbst wenn etwas schiefläuft.
Schritt 5: der Agent (Python ohne Abhängigkeiten)
nano ~/agente.py
import json, os, time, urllib.request
TG = f"https://api.telegram.org/bot{os.environ['TELEGRAM_TOKEN']}"
YO = int(os.environ["CHAT_ID"])
KEY, MODELO = os.environ["ANTHROPIC_API_KEY"], os.environ["MODELO"]
def post(url, data, headers=None):
req = urllib.request.Request(url, json.dumps(data).encode(), {"Content-Type": "application/json", **(headers or {})})
with urllib.request.urlopen(req, timeout=120) as r:
return json.load(r)
def claude(texto):
r = post("https://api.anthropic.com/v1/messages",
{"model": MODELO, "max_tokens": 1500,
"system": "Du bist mein Assistent. Klare und kurze Antworten, auf Deutsch.",
"messages": [{"role": "user", "content": texto}]},
{"x-api-key": KEY, "anthropic-version": "2023-06-01"})
return "".join(b.get("text", "") for b in r.get("content", [])) or "(keine Antwort)"
offset = 0
while True:
try:
upd = post(f"{TG}/getUpdates", {"offset": offset, "timeout": 50})
for u in upd.get("result", []):
offset = u["update_id"] + 1
msg = u.get("message") or {}
if msg.get("chat", {}).get("id") != YO or "text" not in msg:
continue # antwortet nur dir
post(f"{TG}/sendMessage", {"chat_id": YO, "text": "Erhalten. Ich kümmere mich darum."})
post(f"{TG}/sendMessage", {"chat_id": YO, "text": claude(msg["text"])[:4000]})
except Exception as e:
print("Fehler:", e)
time.sleep(10)
Test es:
source ~/.agente.env && python ~/agente.py
Schreib deinem Bot über Telegram. Wenn er antwortet, funktioniert es. Mit Strg+C stoppst du ihn.
Schritt 6: Damit sie nicht einschläft und von selbst startet
mkdir -p ~/.termux/boot
nano ~/.termux/boot/agente.sh
#!/data/data/com.termux/files/usr/bin/sh
termux-wake-lock
. ~/.agente.env
nohup python ~/agente.py >> ~/agente.log 2>&1 &
chmod +x ~/.termux/boot/agente.sh
Starte die Box neu. Ohne etwas zu öffnen, schreib dem Bot: Er sollte antworten. Wenn nicht, schau mit cat ~/agente.log ins Log. termux-wake-lock hinterlässt eine dauerhafte Termux-Benachrichtigung: Das ist normal, genau das verhindert, dass Android es beendet.
Ideen für erste Aufgaben
- „Fass mir diesen Text zusammen, den ich dir einfüge.“
- „Schreib mir 3 Versionen dieser Nachricht an einen Kunden.“
- „Schreib mir das Skript für ein Reel über X.“
- Benachrichtigungen: Installiere
cronie(pkg install cronie) und plane ein Skript, das jeden Morgen läuft und dir das Ergebnis an den Bot schickt.
Grenzen und Sicherheit (lies das)
- Nicht offiziell und von uns nicht von Anfang bis Ende getestet. Wenn ein Schritt auf deiner Box scheitert, gib Claude die Fehlermeldung.
- Claude Code (das Terminal-Tool) wird unter Termux ebenfalls nicht offiziell unterstützt; deshalb nutzt dieser Guide die API direkt.
- Kosten: Jede Nachricht verbraucht API-Token. Ausgabenlimit gesetzt = Ruhe.
- Schlüssel: nur in
~/.agente.env, auf der Box. Nie im Chat mit Claude, nie in Screenshots, nie auf GitHub. - Datenschutz: Was du dem Bot schickst, läuft über Telegram und die Anthropic-API. Gib ihm keine sensiblen Daten.
- Wenn du die Box verkaufst oder verschenkst: Lösch Termux (oder setz sie auf Werkseinstellungen zurück) und widerrufe den API-Schlüssel und den Bot-Token.
Checkliste
- Eigene TV-Box (oder altes Handy) mit Android 7 oder höher.
- Termux und Termux:Boot aus F-Droid installiert, Termux:Boot einmal geöffnet.
- Termux ohne Akku-Optimierung.
- Bot mit @BotFather erstellt und deine chat_id notiert.
- Schlüssel in
~/.agente.envmitchmod 600und Ausgabenlimit gesetzt. - Der Bot antwortet dir nach einem Neustart der Box.