Für Tuya-Geräte gibt es zwei Wege: die integrierte Tuya-Integration über die Cloud und die Community-Integration „Tuya Local“ für unterstützte Geräte im lokalen Netz. Die folgende Anleitung orientiert sich an Home Assistant 2025.12.2 und wurde mit den aktuellen Projektanleitungen abgeglichen. Beginnen Sie mit der integrierten Lösung.
1. Vorbereitung
Installieren Sie „Tuya Smart“ oder „Smart Life“ auf Ihrem Telefon, melden Sie sich an und fügen Sie mindestens ein Gerät hinzu. Prüfen Sie, ob Sie es in der App bedienen können. Für die Kontoverknüpfung mit Home Assistant brauchen Sie die App sowie einen zweiten Bildschirm für den angezeigten QR-Code.
2. Tuya-Konto verbinden
In der Mobil-App finden Sie den Benutzercode unter „Ich“ → Zahnrad „Einstellungen“ → „Konto und Sicherheit“ → „Benutzercode“. Kopieren Sie ihn. Öffnen Sie in Home Assistant „Einstellungen“ → „Geräte & Dienste“ → „Integration hinzufügen“ und suchen Sie „Tuya“. Geben Sie den Benutzercode ein.
Auf dem Home-Assistant-Bildschirm erscheint ein QR-Code. Öffnen Sie in „Tuya Smart“ oder „Smart Life“ die Scan-Funktion über „+“ beziehungsweise „Gerät hinzufügen“, scannen Sie den Code und bestätigen Sie die Anmeldung in der App. Kehren Sie zu Home Assistant zurück und schließen Sie die Einrichtung ab. Ordnen Sie die erkannten Geräte nach Bedarf Bereichen zu. Für diesen offiziellen Anmeldeweg ist kein eigenes Tuya-Entwicklerprojekt erforderlich.
3. Geräte prüfen und nachladen
Öffnen Sie die Tuya-Integration unter „Geräte & Dienste“ und testen Sie die angezeigten Geräte und Entitäten. Nicht jede Funktion aus der Mobil-App wird von der offiziellen Integration bereitgestellt. Haben Sie später weitere Geräte in der App hinzugefügt, laden Sie die Tuya-Integration in Home Assistant neu, damit sie erscheinen.
4. Option für lokale Steuerung
„Tuya Local“ ist eine separate Community-Integration und benötigt HACS. Installieren Sie sie nur, wenn Sie lokale Steuerung oder zusätzliche Gerätefunktionen benötigen und Ihr Modell unterstützt wird. Nach Installation und Home-Assistant-Neustart fügen Sie „Tuya Local“ unter „Geräte & Dienste“ hinzu. Laut Projektdokumentation kann die Einrichtung die Gerätedaten per Anmeldung am Tuya-/Smart-Life-Konto abrufen; alternativ sind Geräte-ID, lokale IP-Adresse und lokaler Schlüssel manuell einzugeben. Bewahren Sie den lokalen Schlüssel wie ein Passwort auf.
Fehlerbehebung
Fehlt ein Gerät, prüfen Sie zuerst, ob es in der Mobil-App online ist. Laden Sie danach die Tuya-Integration neu. Wenn eine Entität oder Funktion fehlt, kann das an Einschränkungen der offiziellen Tuya-Schnittstelle oder am Gerätetyp liegen. Prüfen Sie vor einem Wechsel zu „Tuya Local“ dessen Geräteliste und die Netzwerkerreichbarkeit.
