Tuya lokal steuern – Home Assistant ohne China-Cloud

Ihr habt Tuya-Geräte zu Hause – smarte Steckdosen, Lampen oder Schalter – und ärgert euch, dass jeder Schaltbefehl den Umweg über Server in China nimmt? Dann ist dieser Artikel genau das Richtige. Ich zeige euch, wie ihr Tuya-Geräte vollständig lokal in Home Assistant einbindet: kein Cloud-Zwang, keine Latenz, keine Abhängigkeit von fremden Servern.

Das Prinzip heißt LocalTuya – eine HACS-Integration, die direkt im lokalen Netzwerk mit euren Geräten kommuniziert. Der einzige Moment, in dem ihr die Tuya-Cloud noch braucht, ist das einmalige Auslesen des sogenannten Local Key. Danach könnt ihr das Gerät sogar komplett vom Internet sperren.

Warum überhaupt Tuya ohne Cloud?

Tuya-Geräte sind günstig, weit verbreitet und werden unter Dutzenden Markennamen verkauft (Gosund, NOUS, Nedis, Teckin, Brizled …). Das Problem: Jeder Schaltbefehl läuft standardmäßig über Tuyas Server in China – selbst wenn Smartphone und Glühbirne im gleichen Heimnetz hängen.

Mit lokaler Steuerung fällt das alles weg: Schaltzeiten unter 50 ms, vollständige Offline-Fähigkeit und keine Datenweitergabe an Dritte.

Voraussetzungen

• Home Assistant (HAOS, Supervised oder Container) – Installationsanleitung hier
• HACS installiert (Home Assistant Community Store)
• Tuya-kompatibles Gerät – bereits mit der Tuya– oder Smart Life-App eingerichtet
• Ein kostenloses Konto auf der Tuya IoT Platform (developer.tuya.com)
• Python 3.8+ auf eurem PC (für den tinytuya-Wizard)
• Feste IP-Adresse für jedes Tuya-Gerät (DHCP-Reservierung im Router empfohlen)

Wichtig: Gebt euren Tuya-Geräten unbedingt eine statische IP. LocalTuya verbindet sich über die IP – ändert sich diese, verliert Home Assistant die Verbindung.

Schritt 1 – Local Key ermitteln (tinytuya Wizard)

Der Local Key ist ein gerätespezifischer Schlüssel, mit dem Home Assistant direkt im LAN mit dem Gerät kommunizieren kann. Ihr lest ihn einmalig über die Tuya-Cloud aus.

1.1 – Tuya IoT Platform einrichten

1. Geht auf developer.tuya.com und legt ein kostenloses Developer-Konto an.
2. Klickt oben auf Cloud → Development → Create Cloud Project.
3. Füllt den Projektnamen frei, wählt Smart Home als Industry und Smart Home PaaS als Development Method.
4. Wählt als Data Center die Region, in der eure Tuya/Smart Life App registriert ist (meist Central Europe Data Center).
5. Notiert euch Access ID und Access Secret – die braucht ihr gleich.

1.2 – Smart Life App verknüpfen

1. Im Tuya IoT Portal: Cloud → Linked Devices → Add App Account.
2. Öffnet die Smart Life App auf eurem Smartphone und scannt den QR-Code.
3. Alle eure Geräte erscheinen jetzt im Portal unter Devices.

1.3 – tinytuya Wizard ausführen

tinytuya ist ein Python-Tool, das automatisch alle eure Geräte mit Local Keys aus der Tuya-Cloud lädt.

Installiert tinytuya per pip:

pip install tinytuya

Startet dann den Setup-Wizard:

python -m tinytuya wizard

Der Wizard fragt euch nach:

• API Key = Access ID aus dem Tuya Portal
• API Secret = Access Secret aus dem Tuya Portal
• API Region = eu (für Europa)

Am Ende erstellt tinytuya eine Datei devices.json mit allen euren Geräten, inklusive:

• Device ID
• Local Key
• IP-Adresse
• Protokoll-Version (3.1, 3.3 oder 3.4)

Notiert diese Werte für jedes Gerät – ihr braucht sie in Schritt 3.

Schritt 2 – Statische IPs im Router zuweisen

Bevor ihr LocalTuya einrichtet, gebt jedem Tuya-Gerät eine feste IP. In einer FritzBox geht das unter Heimnetz → Netzwerk → Gerät bearbeiten (Bleistift-Icon) → Immer die gleiche IPv4-Adresse zuweisen.

Alternativ: Notiert euch die aktuelle IP aus der devices.json und tragt sie im Router als DHCP-Reservierung ein (anhand der MAC-Adresse des Geräts).

Schritt 3 – LocalTuya via HACS installieren

1. Öffnet Home Assistant und geht zu HACS → Integrations → Explore & Download Repositories.
2. Sucht nach LocalTuya und installiert die Integration von rospogrigio.
3. Startet Home Assistant neu.
4. Geht zu Einstellungen → Geräte & Dienste → Integration hinzufügen → LocalTuya.

3.1 – Gerät in LocalTuya einrichten

1. LocalTuya scannt euer Netzwerk und zeigt gefundene Tuya-Geräte an. Wählt euer Gerät aus.
2. Gebt den Local Key aus der devices.json ein.
3. Wählt die passende Protokoll-Version (steht ebenfalls in der JSON-Datei).
4. Wählt den Entity-Typ: switch für Steckdosen, light für Lampen, climate für Thermostate.
5. Weist den DP-Wert (Data Point) zu – bei den meisten Steckdosen ist das DP 1 (Schalten). Energiemessung nutzt DP 18–20.

Tipp: Wenn ihr nicht sicher seid, welche DPs euer Gerät hat, startet den tinytuya Scanner:

python -m tinytuya scan

Dieser zeigt alle aktiven DP-Werte eurer lokalen Tuya-Geräte in Echtzeit an.

Alternative: Tuya Local (make-all)

Neben LocalTuya gibt es eine zweite Option über HACS: Tuya Local vom GitHub-Nutzer make-all. Diese Alternative unterstützt noch mehr Gerätetypen (Klimaanlagen, Staubsauger-Roboter, Luftreiniger) und benötigt keine manuelle DP-Zuweisung – viele Geräte werden automatisch erkannt.

Empfehlung: Startet mit LocalTuya für einfache Steckdosen und Schalter. Habt ihr Klimaanlagen, Wärmepumpen oder exotische Geräte, probiert Tuya Local als Alternative.

Schritt 4 – Gerät im Router vom Internet sperren

Sobald LocalTuya läuft, könnt ihr das Tuya-Gerät komplett vom Internet abschneiden. Es braucht nur noch euren Home Assistant im lokalen Netzwerk.

FritzBox:

1. Heimnetz → Netzwerk → Gerät auswählen
2. Unter Internetzugang: gesperrt auswählen
3. Speichern

OpenWRT / pfSense: Firewall-Regel anlegen, die den ausgehenden Traffic der Geräte-IP auf Port 80/443 blockiert.

Nach der Sperre: Testet LocalTuya mit einem Schaltbefehl aus Home Assistant. Das Gerät muss weiterhin sofort reagieren – über euer lokales Netz. Nur die Tuya-App auf dem Smartphone funktioniert dann nicht mehr für das Gerät (was ihr wissentlich akzeptiert).

Für smarte Steckdosen mit Energiemessung lohnt sich die lokale Steuerung besonders – kombiniert sie mit dem HA Energie-Dashboard, um den Verbrauch lückenlos zu tracken.

Troubleshooting – häufige Fehler

Welche Geräte lohnen sich besonders?

Nicht alle Tuya-Geräte sind gleich gut geeignet. Am besten funktionieren lokale Integrationen bei:

• Smarte Steckdosen mit Energiemessung (NOUS A1T, Gosund SP111) – DP-Werte sind gut dokumentiert, sofortige Schaltreaktionen. Unsere Testsieger in der Smart Plug Übersicht
• Einfache WLAN-Schalter und Relais – geringe Komplexität, Protokoll 3.3 verbreitet
• LED-Stripes und Glühbirnen – über DP 20–24 vollständig steuerbar (Farbe, Helligkeit, Mode)

Für komplexere DIY-Projekte ist der Umstieg auf ESPHome einen Schritt weiter: Flasht ihr die Tuya-Firmware komplett mit ESPHome, habt ihr maximale Kontrolle ohne jeden Cloud-Kontakt. Mehr dazu im ESPHome Einsteiger-Guide.

Wer generell seine Smart-Home-Geräte vom Internet abschneiden möchte, findet eine umfassende Strategie im Artikel Smart Home absichern.

FAQ – Tuya lokal steuern

Funktioniert lokale Steuerung mit allen Tuya-Geräten?

Die meisten einfachen Geräte wie Steckdosen, Schalter und Lampen funktionieren sehr gut. Neuere Geräte mit Protokoll 3.4 und 3.5 (verschlüsselt) werden von LocalTuya und Tuya Local mittlerweile ebenfalls unterstützt. Ausnahmen sind Geräte, die ausschließlich über Bluetooth kommunizieren – diese funktionieren nicht lokal über WLAN.

Muss ich die Tuya-Cloud dauerhaft nutzen?

Nein. Den Local Key braucht ihr nur einmal – zum Auslesen via tinytuya. Danach könnt ihr das Gerät im Router vom Internet sperren. Home Assistant kommuniziert dann nur noch lokal über euer Heimnetz.

Ändert sich der Local Key irgendwann?

Nur wenn ihr das Gerät in der Tuya/Smart Life App zurücksetzt, löscht und neu verbindet (Re-Pairing). Solange das Gerät in der App verbleibt, bleibt der Local Key dauerhaft gleich.

Kann ich LocalTuya und die offizielle Tuya-Integration gleichzeitig nutzen?

Nicht für dasselbe Gerät. Ihr müsst euch entscheiden. Für Geräte, die ihr lokal steuern wollt, entfernt ihr sie aus der offiziellen HA-Tuya-Integration und richtet sie in LocalTuya ein.

Was ist besser – LocalTuya oder ESPHome Flashen?

ESPHome gibt euch die maximale Kontrolle und benötigt gar keine Tuya-Cloud (auch nicht einmalig). LocalTuya ist einfacher – kein Auflöten, kein Flashen. Für Standard-Steckdosen reicht LocalTuya völlig. Für Maker-Projekte und Geräte mit komplexen DPs lohnt ESPHome.

Was passiert, wenn Home Assistant offline ist?

Lokale Tuya-Geräte sind ohne Home Assistant nicht über LocalTuya steuerbar. Habt ihr das Gerät vom Internet gesperrt, funktioniert auch die Smart Life App nicht mehr. Plant daher eine Fallback-Lösung: physischer Schalter parallel zum smarten Relais, oder Home Assistant auf stabilem Hardware-Setup wie dem Raspberry Pi 5.

Fazit

Tuya-Geräte lokal zu steuern ist mit LocalTuya und tinytuya kein Hexenwerk mehr. Der einmalige Aufwand – Tuya Developer Account anlegen, Local Key auslesen, LocalTuya in HACS einrichten – zahlt sich sofort aus: Schaltzeiten unter 50 ms, vollständige Offline-Fähigkeit und keine Daten mehr auf chinesischen Servern.

Besonders stark ist die Kombination mit dem Home Assistant Energie-Dashboard: Steckdosen mit Energiemessung liefern lokal ihre Watt-Werte direkt in die Statistik – lückenlos, ohne Cloud-Abhängigkeit.

Habt ihr noch ältere Tuya-Geräte mit einfacher Hardware, lohnt sich zusätzlich ein Blick auf das Flashen mit ESPHome – damit befreit ihr sie dauerhaft aus der Tuya-Welt. Den Einstieg zeigt unser ESPHome Guide.