Google Home mit Home Assistant verbinden: Cloud, Local Fulfillment und manuelle Einrichtung
Google Home und Home Assistant sind über eine Cloud-to-Cloud-Integration verbunden. Ein Sprachbefehl wird von Google Assistant verarbeitet, über die Google-Cloud an Home Assistant weitergeleitet und dort ausgeführt. Das Google-Home-Projekt in der Google Home Developer Console dient als Verbindungsstelle beider Systeme.
Wie verbindet man Google Home mit Home Assistant?
Die Kopplung läuft über Internetdienste: Google und Home Assistant tauschen Befehle aus, ohne dass Google Home die Geräte direkt ansteuert. Google Home übernimmt die Sprachsteuerung (Spracheingabe und Sprachausgabe über Lautsprecher oder Display), während die Schaltlogik in Home Assistant liegt.
Datenfluss beim Standardweg
Bei einem Befehl wie „OK Google, schalte das Wohnzimmerlicht ein“ laufen folgende Stufen ab:
- Google Assistant erkennt den Befehl und ordnet ihn einem Gerät zu, das im Google-Home-Konto synchronisiert ist.
- Google sendet die Anfrage über die Google-Cloud an die Home-Assistant-Instanz.
- Home Assistant führt den Befehl über die zugehörige Entität aus, etwa ein Licht.
Cloud-Weg und lokale Ausführung
- Cloud-Weg (Standard): Jeder Befehl wird über die Google-Cloud weitergeleitet. Ohne weitere Konfiguration ist dies der aktive Pfad.
- Local Fulfillment (optional): Befehle gehen direkt an Home Assistant. Die Google-Cloud wird für die Befehlsübermittlung nicht mehr als Zwischenstation genutzt.
Rolle des Google-Home-Projekts
Das Projekt wird in der Google Home Developer Console mit Cloud-to-Cloud-Integration angelegt. Es verbindet Home Assistant mit dem Google-Konto, indem es die Geräte bereitstellt.
Welche Voraussetzungen gelten?
Für die manuelle Anbindung von Home Assistant an Google Home müssen drei Bedingungen erfüllt sein: eine von außen erreichbare Adresse mit SSL-Zertifikat, ein Google-Konto mit Zugriff auf die Developer Console und eine laufende, aktuelle Home-Assistant-Instanz mit funktionierender Benutzeranmeldung. Diese Anforderungen gelten nur für die manuelle Variante, nicht für Home Assistant Cloud.
Hostname mit SSL-Zertifikat
Google greift über das Internet auf die Instanz zu, deshalb reicht eine rein lokale Adresse wie eine IP im Heimnetz nicht aus. Der Hostname muss von außen auflösbar sein und über HTTPS mit einem gültigen Zertifikat antworten.
Praktische Prüfung vor dem Start:
- Den Hostnamen im Browser über ein mobiles Netz aufrufen, also außerhalb des Heimnetzes.
- Im Browser das Schloss-Symbol öffnen und prüfen, ob das Zertifikat gültig ist und zum Hostnamen passt.
- Die Home-Assistant-Oberfläche muss ohne Zertifikatswarnung laden.
Google-Konto mit Zugriff auf die Developer Console
Die manuelle Einrichtung erfolgt in der Google Home Developer Console. Dafür braucht es ein Google-Konto, das diese Konsole öffnen darf. Das Konto sollte zusätzlich dasselbe sein, mit dem später die Google-Home-App genutzt wird, damit das Projekt dort gefunden und synchronisiert werden kann.
Funktionierende Home-Assistant-Instanz mit Benutzeranmeldung
Die Instanz sollte auf einem aktuellen Versionsstand laufen und sich mit einem Benutzerkonto anmelden lassen. Vor dem Start ist zu prüfen, ob die Anmeldung auch über den externen Hostnamen funktioniert, da Account Linking später über genau diese Endpunkte läuft.
| Voraussetzung | Konkrete Prüfung |
|---|---|
| Hostname mit SSL-Zertifikat | Erreichbar von außen, HTTPS ohne Warnung |
| Google-Konto | Zugriff auf die Developer Console vorhanden |
| Home-Assistant-Instanz | Aktuelle Version, Anmeldung mit Benutzerkonto funktioniert auch extern |
Home Assistant Cloud: der einfache Weg
Die Home-Assistant-Cloud ist laut Home Assistant (Open Home Foundation, 2026) die einfachste Option, Home Assistant mit Google Home zu verbinden. Die Verbindung wird in wenigen Klicks über die Oberfläche hergestellt, ohne dynamisches DNS, SSL-Zertifikate oder Portfreigaben. Nach einer 30-tägigen Testphase ist ein kostenpflichtiges Abo erforderlich.
Was bei der Cloud-Variante entfällt
Die manuelle Anbindung setzt voraus, dass die Instanz von außen über einen Hostnamen mit SSL-Zertifikat erreichbar ist. Bei der Cloud-Variante fallen diese Voraussetzungen weg:
| Voraussetzung bei manueller Anbindung | Bei Home Assistant Cloud |
|---|---|
| Dynamisches DNS für einen erreichbaren Hostnamen | nicht erforderlich |
| SSL-Zertifikat für den Hostnamen | nicht erforderlich |
| Portfreigabe am Router | nicht erforderlich |
Damit entfällt die eigene Netzwerkkonfiguration für Port, Domain und Zertifikat. Die Einrichtung findet vollständig in der Home-Assistant-Oberfläche statt.
Abo nach der Testphase
Wer die Verbindung dauerhaft nutzen will, sollte den Abschluss vor Ablauf der Testphase prüfen, damit die Anbindung nicht unterbrochen wird.
Den aktuellen Abo-Preis bitte direkt in der Home-Assistant-Oberfläche oder auf der offiziellen Home-Assistant-Website prüfen, da er sich ändern kann.
Manuelle Einrichtung ohne Abo
Die manuelle Anbindung verbindet Home Assistant über ein eigenes Google-Cloud-Projekt mit Google Home und kommt ohne Abo aus. Der Weg besteht aus vier Schritten: externe Erreichbarkeit, Projekt mit Account Linking, Dienstkonto mit HomeGraph API und Eintrag in der configuration.yaml.
Externe Erreichbarkeit herstellen
Bei wechselnder öffentlicher IP-Adresse wird ein Dynamic DNS-Dienst eingerichtet, der einen festen Hostnamen auf die aktuelle Adresse des Anschlusses zeigen lässt. Anschließend wird im Router eine Portfreigabe für den HTTPS-Port auf die Home-Assistant-Instanz angelegt. Für den Hostnamen ist ein gültiges SSL-Zertifikat erforderlich. Die Oberfläche der Portfreigabe unterscheidet sich je nach Router und ist in dessen Herstelleranleitung beschrieben.
Projekt und Account Linking in der Developer Console
In der Google Home Developer Console wird ein Projekt mit der Integrationsart Cloud-to-Cloud angelegt. Im Bereich Account Linking werden folgende Endpunkte eingetragen, wobei IHR-HOSTNAME durch den eigenen Hostnamen ersetzt wird:
| Feld | Endpunkt | Funktion |
|---|---|---|
| Authorization-URL | https://IHR-HOSTNAME/auth/authorize |
Anmeldung und Zustimmung zur Verknüpfung |
| Token-URL | https://IHR-HOSTNAME/auth/token |
Ausstellung und Erneuerung der Zugriffstoken |
| Fulfillment-URL | https://IHR-HOSTNAME/api/google_assistant |
Empfang der Befehle und Gerätedaten |
Dienstkonto und HomeGraph API
Im Google Cloud Projekt, das zur Developer Console gehört, wird ein Dienstkonto angelegt und ein Schlüssel im JSON-Format erzeugt. Die Datei wird als SERVICE_ACCOUNT.json im Konfigurationsverzeichnis von Home Assistant abgelegt, also neben der configuration.yaml.
Zusätzlich wird die HomeGraph API im Projekt aktiviert. Ohne aktivierte HomeGraph API ist die Anbindung nicht vollständig eingerichtet.
Eintrag in der configuration.yaml
Die Integration google_assistant wird mit der Projekt-ID und dem Dienstkonto ergänzt:
google_assistant:
project_id: IHR-PROJEKT-ID
service_account: !include SERVICE_ACCOUNT.jsonAls project_id wird die Projekt-ID aus der Developer Console verwendet, nicht der frei vergebene Projektname. Da YAML über Einrückung strukturiert wird, sollte die Datei vor dem Neustart von Home Assistant auf Einrückungs- und Syntaxfehler geprüft werden.
Welche Geräte erscheinen in Google Home?
Nach der Anbindung zeigt Google Home nur die Entitäten, die Home Assistant über die Google-Assistant-Integration freigibt.
Einbindung des Projekts
| Schritt | Ort | Aktion |
|---|---|---|
| 1 | Google-Home-App | Über „Works with Google Home“ das eigene Projekt hinzufügen |
| 2 | Google-Home-App | Mit dem Konto anmelden, das für die Verknüpfung verwendet wurde |
Synchronisation per Sprachbefehl
Die Synchronisation startest du mit dem Sprachbefehl „OK Google, sync my devices“. Google fragt dabei die freigegebenen Entitäten bei Home Assistant ab und legt sie in der App an. Nach Änderungen an der Freigabe empfiehlt sich eine erneute Synchronisation mit demselben Befehl.
Auswahl sichtbarer Entitäten in Home Assistant
Welche Geräte in Google Home erscheinen, bestimmt Home Assistant. Freigegeben werden die Entitäten, die in den Einstellungen der Google-Assistant-Integration berücksichtigt sind, etwa Lampen, Steckdosen oder Thermostate. Die Menübezeichnungen unterscheiden sich je nach Home-Assistant-Version, daher lohnt ein Blick in die aktuelle Dokumentation des Herstellers.
Lokale Steuerung und Matter
Neben dem Cloud-Weg gibt es die optionale lokale Ausführung (Local Fulfillment) und, als eigenständiges Protokoll, Matter.
Local Fulfillment für direkte Befehle
Die Option ist optional und wird in der Konfiguration der Integration aktiviert (Home Assistant (Open Home Foundation), 2026).
Diese Einschränkung betrifft nur die lokale Befehlsausführung. Diese Einschränkung betrifft nur Local Fulfillment. Ob und wie der externe Zugriff für die Synchronisation mit Google ohne ein Zertifikat im HTTP-Modul eingerichtet wird (etwa über einen vorgeschalteten Dienst), hängt vom eigenen Aufbau ab und sollte vor der Umstellung geprüft werden.
Matter als herstellerübergreifender Standard
Matter ist ein herstellerübergreifendes Protokoll für Smart-Home-Geräte. Ein Matter-Gerät kann grundsätzlich in mehreren Ökosystemen genutzt werden. Dass Home Assistant dadurch alle seine Entitäten an Google Home weitergibt, ist nicht bestätigt; dafür bleibt die beschriebene Anbindung maßgeblich.
Im Vergleich zur Cloud-to-Cloud-Anbindung über die Google Home Developer Console hat Matter folgende Unterschiede:
| Merkmal | Cloud-to-Cloud (Google Home Developer Console) | Matter |
|---|---|---|
| Einrichtung | Projekt, Account Linking und Dienstkonto-Schlüssel nötig | Gerät wird über den Matter-Kopplungscode hinzugefügt |
| Erreichbarkeit der Instanz | Hostname mit SSL-Zertifikat erforderlich | – |
| Abhängigkeit | Google-Konto und Home-Assistant-Integration | Herstellerunabhängiges Protokoll |
Was tun bei Problemen?
Die meisten Fehler bei der Verbindung von Home Assistant mit Google Home treten an drei Stellen auf: bei den Geräten nach der Synchronisation, beim Account Linking und bei Befehlen, die ausbleiben. Die Fehlersuche folgt am besten dieser Reihenfolge, weil jede Stufe auf der vorherigen aufbaut.
Fehlende oder verspätete Geräte nach der Synchronisation
Wenn Geräte in der Google-Home-App fehlen, liegt das meist an der Synchronisation selbst. Ist danach ein Gerät nicht sichtbar, lohnt sich folgende Prüfung:
- Prüfen, ob die Entität in Home Assistant überhaupt existiert und einen gültigen Status liefert.
- Nach einer Änderung an der
configuration.yamlHome Assistant neu starten, damit die Konfiguration vollständig geladen wird.
Authentifizierungsfehler beim Account Linking
Beim Account Linking werden die Endpunkte /auth/authorize und /auth/token verwendet. Schlägt die Anmeldung fehl, sollten diese Einträge in der Google Home Developer Console auf exakte Übereinstimmung mit der eigenen Instanz geprüft werden.
Bei einem Fehler in dieser Stufe ist die Ursache häufig eine Abweichung zwischen der konfigurierten Adresse und der tatsächlich erreichbaren Instanz. Die Konfiguration sollte deshalb Zeichen für Zeichen mit der Adresse verglichen werden, unter der Home Assistant von außen erreichbar ist.
Befehle werden nicht ausgeführt
Wenn Geräte sichtbar sind, Befehle aber ohne Reaktion bleiben, liegt die Ursache oft in der Verbindung zwischen Google und Home Assistant. Der Dienstkonto-Schlüssel SERVICE_ACCOUNT.json muss in der Konfiguration korrekt eingebunden sein, und die HomeGraph API muss im Projekt aktiviert sein. Fehlt eine dieser Komponenten, werden Befehle nicht zuverlässig weitergeleitet.
Protokolle prüfen
Der effizienteste Weg, Befehlsfehler einzugrenzen, ist die Auswertung der Home-Assistant-Protokolle. Im Protokoll lassen sich Anfragen von Google nachvollziehen und Fehlermeldungen des Moduls google_assistant finden. Die Meldungen zeigen, ob eine Anfrage die Instanz erreicht hat oder bereits zuvor abgewiesen wurde. Liegt keine Anfrage im Protokoll vor, liegt das Problem vor der Instanz, also bei der Erreichbarkeit oder beim Account Linking.
