DEV Community

Cover image for Tuya Geräte in Home Assistant: 100% Lokal & ohne China-Cloud (Local Key auslesen)
Tim Alex
Tim Alex

Posted on

Tuya Geräte in Home Assistant: 100% Lokal & ohne China-Cloud (Local Key auslesen)

Wer günstige Smart Home Hardware auf Amazon kauft, landet fast immer bei "Smart Life" oder "Tuya" kompatiblen Geräten. Sie sind billig, funktionieren gut, haben aber einen riesigen Haken: Die Cloud.

Jedes Mal, wenn du das Licht anschaltest, reist das Signal von deinem Haus zu einem Server (oft in China oder den USA) und zurück. Das sorgt für:

  1. Verzögerung (Latenz): Das Licht geht erst 1-2 Sekunden später an.

  2. Abhängigkeit: Kein Internet = Kein Smart Home.

  3. Datenschutz-Bedenken.

Die Lösung ist die Integration LocalTuya. Damit steuerst du die Geräte direkt im lokalen Netzwerk. Doch dafür brauchst du den "Local Key". Und den rückt der Hersteller nicht freiwillig raus.

Hier ist der Weg, wie du ihn trotzdem bekommst.

Schritt 1: Die Vorbereitung (Der "Bessere Weg")

Ein ehrlicher Experten-Tipp vorab: Wenn du noch keine Geräte gekauft hast oder den Aufwand scheust, kaufe Hardware, die von Haus aus lokal funktioniert. Das spart dir Stunden an Lebenszeit.

Hast du schon Tuya-Geräte? Dann geht es jetzt ans Eingemachte.

Schritt 2: Der Tuya IoT Account

Um den Key auszulesen, müssen wir uns als "Entwickler" ausgeben.

  1. Gehe auf die Tuya IoT Platform und erstelle einen Account (nutze nicht deinen Smart Life Account, sondern erstelle einen neuen Developer-Account).

  2. Logge dich ein und gehe auf Cloud > Development.

  3. Klicke auf Create Cloud Project.

  • Name: Egal (z.B. "HomeAssistant").

  • Data Center: Wähle Central Europe Data Center (Wichtig!)

  1. Zum Schluss überspringst du die Konfiguration der Services, die Standard-Einstellungen reichen.

Schritt 3: Die App verknüpfen

Jetzt verbinden wir deinen Developer-Account mit deiner Smart Life App auf dem Handy.

  1. Gehe im Tuya IoT Dashboard auf den Reiter Devices > Link Tuya App Account.

  2. Klicke auf Add App Account – es erscheint ein QR-Code.

  3. Öffne deine Smart Life App (oder Tuya App) auf dem Handy.

  4. Gehe auf Profil > oben rechts das Scanner-Symbol und scanne den QR-Code vom Bildschirm.

  5. Bestätige die Verbindung auf dem Handy.

Schritt 4: Die Keys auslesen (Der Heilige Gral)

Jetzt passiert die Magie.

  1. Gehe im Dashboard auf Devices > All Devices.

  2. Du solltest nun eine Liste all deiner Lampen und Steckdosen sehen.

  3. Hier siehst du die Device ID. Kopiere sie.

  4. Aber wo ist der Key? Leider versteckt Tuya diesen mittlerweile gut.

  5. Gehe links im Menü auf Cloud > API Explorer.

  6. Wähle im Menü links: Smart Home Device System > Device Management > Get Device Details.

  7. Gib deine Device ID ein und klicke auf "Submit Request".

  8. Im Antwort-Fenster (rechts) suchst du nach dem Eintrag "local_key": "...".

  • *Kopiere diesen Key und speichere ihn gut ab! *(Zusammen mit der Device ID).

Schritt 5: Integration in Home Assistant

  1. Installiere LocalTuya über HACS (Home Assistant Community Store).

  2. Starte Home Assistant neu.

  3. Gehe zu Einstellungen > Geräte & Dienste > Integration hinzufügen > LocalTuya.

  4. Wähle dein Gerät aus (es sollte automatisch im Netzwerk gefunden werden).

  5. Gib nun die Local Key ein, den du eben ausgelesen hast.

  6. Konfiguriere den Typ (z.B. "Switch" für eine Steckdose). Die ID ist meistens 1 (probiere 1, 2 oder 3, falls es nicht geht).

Profi-Tipp: Internet sperren

Sobald LocalTuya läuft, kannst du im Router (z.B. FritzBox) dem Gerät den Internetzugang sperren (Kindersicherung/Sperre).

  • Ergebnis: Das Gerät funkt nicht mehr nach China, lässt sich aber über Home Assistant weiterhin perfekt steuern. Das ist maximale Privacy.

Problembehebung: "Abo abgelaufen?"

Der Zugang zur Tuya IoT Platform ist offiziell ein "Trial". Nach 1 bis 6 Monaten kann es sein, dass LocalTuya plötzlich nicht mehr geht.

  • Lösung: Logge dich in die IoT Platform ein, gehe auf Cloud > Cloud Services und verlängere das "IoT Core" Trial (Kostenlos). Das ist nervig, aber notwendig.

Fazit

Tuya-Geräte lokal zu machen ist Arbeit, aber es lohnt sich für die Reaktionsgeschwindigkeit. Wenn du diesen Prozess in Zukunft vermeiden willst, setze direkt auf Zigbee oder Shelly.

Top comments (0)