Mit der Sprachsteuerung steuerst du deine Lampen, Thermostate und Saugroboter in Home Assistant bequem auf Zuruf über smarte Lautsprecher oder dein Smartphone. Früher führte die Einrichtung häufig über die Actions-on-Google-Konsole, mittlerweile erfolgt die Konfiguration über die Google Home Developer Console. Mit dem Cloud-to-Cloud-Verfahren klappt die Verknüpfung zuverlässig.
Das brauchst du
- Eine funktionierende Home-Assistant-Installation mit externer Erreichbarkeit über Domain und SSL-Zertifikat
- Ein Google-Konto
- Zugriff auf den Dateimanager oder das Konfigurationsverzeichnis deiner Installation
1. Projekt in der Google Home Developer Console anlegen
Öffne die Google Home Developer Console und erstelle ein neues Projekt über Create a Project. Vergib einen eindeutigen Projektnamen und klicke auf Create project. Notiere dir direkt die angezeigte Project ID, da du sie gleich mehrfach benötigst.
2. Cloud-to-Cloud-Integration einrichten
Wähle im Projekt den Punkt Add a Cloud-to-Cloud integration aus und klicke unten rechts über Next: Develop weiter auf Next: Setup. Wähle die gewünschten Gerätetypen aus und lade ein App-Icon mit den Maßen 144 × 144 Pixeln hoch.
3. Account Linking konfigurieren
Trage im selben Menü unter Account Linking die Verbindungsdaten für deinen Server ein:
- OAuth Client ID:
https://oauth-redirect.googleusercontent.com/r/[YOUR_PROJECT_ID](ersetze den Platzhalter durch deine echte Projekt-ID) - Client Secret: Eine beliebige Zeichenkette ohne Sonderzeichen (wird von Home Assistant nicht ausgewertet)
- Authorization URL:
https://[deine-domain:port]/auth/authorize - Token URL:
https://[deine-domain:port]/auth/token - Cloud fulfillment URL:
https://[deine-domain:port]/api/google_assistant - Scope(s): Füge nacheinander
emailundnamehinzu
Lass das Häkchen für die Übertragung via HTTP basic auth header deaktiviert und speichere den Entwurf mit Save.
4. Service-Account anlegen und Synchronisierung aktivieren
Wechsle über das Menü links auf Analytics und öffne über das Hauptmenü APIs und Services in der Google Cloud Console. Aktiviere dort die Gerätesynchronisierung. Klicke auf Credentials > Create credentials > Service account. Vergib einen Namen und weise dem Account die Rolle Service Accounts > Service Account Token Creator zu.
Öffne das erstellte Dienstkonto, gehe auf den Reiter Keys > Add key > Create new key und wähle das JSON-Format. Lade die Datei herunter und benenne sie exakt in SERVICE_ACCOUNT.json um. Lege diese Datei anschließend in deinem Home-Assistant-Konfigurationsordner ab – im selben Verzeichnis, in dem deine configuration.yaml liegt.
5. Home Assistant konfigurieren
Füge die Konfiguration in deine configuration.yaml ein. Passe die Projekt-ID an:
google_assistant:
project_id: dein-projektname-12345
service_account: !include SERVICE_ACCOUNT.json
report_state: true
expose_by_default: false
entity_config:
light.wohnzimmer_decke:
expose: true
climate.heizung_wohnbereich:
expose: trueSpeichere die Datei und starte Home Assistant über die Benutzeroberfläche neu.
6. Dienst in der Google Home App verknüpfen
Öffne die Google Home App auf deinem Smartphone, tippe auf das Pluszeichen zum Hinzufügen von Geräten und wähle Mit Geräten von Google kompatibel. Suche nach deinem Projektnamen und melde dich mit deinen Home-Assistant-Benutzerdaten an.
Funktioniert es?
Nach dem Verknüpfen erscheinen deine freigegebenen Entitäten sofort in der Google Home App und lassen sich per Sprachbefehl oder Fingertipp ein- und ausschalten.
Wenn es nicht klappt
- Fehler bei der Anmeldung in der Google Home App: Deine Home-Assistant-Instanz muss von außen per HTTPS über einen Hostnamen und ein gültiges SSL-Zertifikat erreichbar sein.
- Geräte tauchen nicht auf: Prüfe in der
configuration.yaml, ob die Entitäten explizit aufexpose: truegesetzt sind, und starte Home Assistant neu. - Fehlende Berechtigung beim Statusabgleich: Kontrolliere die Einrichtung der Synchronisierung und prüfe, ob die JSON-Schlüsseldatei im richtigen Konfigurationsordner liegt.
Wer sich den Einrichtungsaufwand in den Google-Entwicklerkonsolen sparen möchte, kann stattdessen über Nabu Casa mit wenigen Klicks eine vorgefertigte Cloud-Anbindung nutzen.
Quellen: Forum: Home Assistant Community, home-assistant.io, simon42.com