Home Assistant plant direkte Shelly-Befehle in Automationen

Wenn du Shelly-Geräte mit Home Assistant steuerst, soll eine neue Aktion zusätzliche Befehle aus Automationen ermöglichen. „Send command“ ist laut dem Bericht seit dem 21. November in der Dokumentation der kommenden Version aufgeführt; als Startversion ist dort Home Assistant 2026.12 eingetragen. Eine fertige Version mit der Funktion gibt es dem Bericht zufolge noch nicht. Die Redaktion hat die Aktion deshalb auch noch nicht ausprobiert, und bis zur Veröffentlichung kann sie sich ändern.

Was die neue Aktion ermöglichen soll

Home Assistant sieht die Aktion laut Bericht für Funktionen vor, für die die Shelly-Integration bisher weder eine eigene Entität noch eine eigene Aktion anbietet. Genannt werden Timer, die direkt auf dem Gerät laufen, einzelne Geräteeinstellungen und die Liste gespeicherter Zeitpläne. In der Oberfläche sollst du dafür ein Gerät und einen Befehl auswählen; optionale Parameter lassen sich als Schlüssel-Wert-Paare ergänzen. In YAML heißt die Aktion shelly.command.

Die Antwort des Shelly wird laut Bericht nur dann in Home Assistant verfügbar, wenn du eine Antwortvariable, „response_variable“, setzt. Als Beispiel für eine Abfrage nennt Home Assistant WiFi.Scan: Damit lässt sich ermitteln, welche WLAN-Netze das Gerät empfängt und wie stark das Signal ist. Das Auswerten der Antwort ist demnach optional.

Die Befehle unterscheiden sich nach Gerätegeneration

Für die Befehlsart ist laut Bericht entscheidend, wie alt dein Shelly ist. Geräte ab Generation 2 verwenden Methoden wie Switch.Set. Shelly-Geräte der Generation 1 erwarten dagegen einen HTTP-Endpunkt, etwa relay/0. Bei Gen1 sind nur einfache Werte wie Text, Zahlen und Wahrheitswerte möglich, weil die Angaben in der Adresse der Anfrage landen. Verschachtelte Werte, etwa ein ganzer Konfigurationsblock, funktionieren demnach erst ab Generation 2.

Einen eigenen Katalog der unterstützten Befehle liefert Home Assistant laut Bericht nicht mit. Du musst in der API-Referenz von Shelly für dein jeweiliges Modell nachsehen, ob ein Befehl verfügbar ist. Der Bericht ordnet aktuelle Geräte der Gen4-Reihe, darunter die Shelly Power Strip 4 Gen4 und den Shelly Dimmer Gen4, dem Namen nach der Gruppe ab Generation 2 zu. Da die Aktion noch in keiner fertigen Version steckt, ist diese Einordnung Teil eines bislang nicht praktisch getesteten Funktionsstands.

Beispiele: Timer und Geräteeinstellungen

Ein Beispiel von Home Assistant betrifft eine Gartenpumpe: Eine Automation schaltet sie um 06:00 Uhr ein und sendet den Befehl Switch.Set mit dem Parameter toggle_after 600. Laut Projekt läuft die Pumpe dadurch genau zehn Minuten und schaltet anschließend selbstständig wieder ab. Anders als bei einer Automation mit Wartezeit muss Home Assistant dem Beispiel zufolge für das Ausschalten nicht erreichbar bleiben; auch bei einem Ausfall des Servers oder des WLANs soll der Timer auf dem Gerät weiterlaufen.

Ein weiteres Beispiel ändert eine Geräteeinstellung: Um 23:00 Uhr soll ein Flurlicht mit Switch.SetConfig eine kürzere Auto-Aus-Zeit erhalten. Der Parameter auto_off_delay 120 steht dabei für zwei Minuten. Der Bericht beschreibt solche Befehle als bisher nur über Umwege erreichbar. Im Home-Assistant-Forum würden Nutzer dafür etwa einen selbst angelegten REST-Befehl empfehlen; für Backups nennt der Bericht das Zusatzprojekt pyscript-shelly-ops, das Gen2+-Geräte ohne Cloud sichert. Die neue Aktion soll den Befehl direkt in einer Automation verfügbar machen.

Berechtigungen, gesperrte Befehle und Fehler

Von Hand lässt sich die Aktion laut Bericht nur mit Adminrechten starten. In Automationen und Skripten gilt diese Einschränkung demnach nicht. Batteriebetriebene Shelly-Geräte, die die meiste Zeit schlafen, sind über die Aktion nicht erreichbar; Home Assistant zeigt dann eine Fehlermeldung an. Zurücksetzen ist ebenfalls eingeschränkt: Shelly.FactoryReset und Shelly.ResetWiFiConfig stehen auf einer Sperrliste. Bei Geräten der Generation 1 ist der Befehl settings mit dem Parameter reset gesperrt.

Ein Befehl kann laut Home Assistant dazu führen, dass du den Zugriff auf den Shelly verlierst, etwa wenn er WLAN-Daten oder die Anmeldung überschreibt. Das Projekt warnt deshalb davor, vor dem ersten Senden die Shelly-Referenz für das jeweilige Modell und den Befehl ungeprüft zu lassen. Außerdem kann ein mitgesendetes WLAN-Passwort im Protokoll auftauchen, wenn du das Debug-Protokoll der Integration einschaltest. Prüfe Logs daher, bevor du sie teilst.

Für die Fehlersuche nennt der Bericht unterschiedliche Meldungen: Antwortet ein Gen1-Gerät auf einen falschen Endpunkt, erscheint der HTTP-Status 404; bei einem ungültigen Parameter ist es 400. Geräte ab Generation 2 melden demnach selbst, was nicht passt, zum Beispiel einen fehlenden Parameter oder eine unbekannte Methode. Der Bericht nennt den 2. Dezember als rechnerischen Stichtag, wenn Home Assistant dem üblichen Rhythmus folgt: Neue Versionen erscheinen demnach am ersten Mittwoch des Monats, die Betaphase läuft in der Woche davor. Einen ausdrücklichen Veröffentlichungstermin hat die Redaktion allerdings nicht gefunden.

Quellen

Lina Körbe
Lina Körbe

Lina Körbe ist Innenarchitektin, zweifache Mutter und Expertin für klare Linien mit Gefühl. Auf Hauszi teilt sie durchdachte Raumideen für Familien, die mit wenig Platz viel Wirkung erzielen möchten. Mit ihrem Blick für Struktur, Licht und Ruhe bringt sie Ordnung in offene Grundrisse, Alltagsecken und Gedanken – reduziert, aber niemals kalt. Mehr über Lina →