Screenshots Aus der README von notDIRK/shelly-cloud-diy-ha.
Überblick
Shelly Cloud DIY verbindet Home Assistant über die Shelly Cloud Control API mit Shelly-Geräten. Die Integration erreicht Geräte, die eine rein lokale Einrichtung nicht sieht, etwa geteilte Geräte, Geräte an entfernten Standorten und Bluetooth-Geräte hinter einem Gateway. Geräte erscheinen als Binärsensoren, Tasten, Klima, Abdeckungen, Lichter, Zahlen, Auswahlen, Sensoren, Schalter und Texte, und nur die in der Auswahl angekreuzten Geräte erhalten Entitäten. Das Schalten bleibt für Geräte im LAN lokal, wobei die Cloud als Zusatzebene für die Sichtbarkeit dient. Die Optionen umfassen das Abfrageintervall, die Zeit, nach der ein Gerät als offline gilt, und Warnungen bei schlechtem Gerätezustand oder bei einem Relais, das nicht mehr öffnet. Zusätzliche Aktionen importieren historische Energiedaten, ersetzen ein defektes Gerät durch ein neues und finden Geräte, die nicht mehr im Konto sind. Die Einrichtung erfolgt in der Oberfläche mit einem Cloud-Schlüssel aus der Shelly-App, und die Integration benötigt die Cloud des Herstellers.
Zusammenfassung der README und des Codes von notDIRK/shelly-cloud-diy-ha, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Lichter
- Klima
- Abdeckungen
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Shelly Cloud DIY
- Cloud-Schlüssel zur AutorisierungDer lange String, den die Shelly-Smart-Control-App unter „Access and permissions“ anzeigt.
- Server-URIDer Hostname unterhalb des Keys, z. B. shelly-42-eu.shelly.cloud.
- Abfrageintervall (Sekunden)Wie oft Home Assistant die Shelly Cloud nach dem Gerätestatus abfragt. Standard 5 s; Bereich 3–60 s. Shelly erzwingt ein Limit von 1 Anfrage pro Sekunde.
- Lokale Gateway-URL (optional, für historische EM-Daten)Nur nötig, wenn ein lokales Shelly-Gateway für historische Energiedaten genutzt wird.
Geräte auswählen
- Schnell-Aktion"Alle anhaken" oder "Alle abwählen" überschreibt beim Speichern die manuelle Liste unten. Mit "Manuelle Auswahl" zählt die Liste.
- Geräte (einzeln an-/abwählbar)Nur angehakte Geräte werden als Home-Assistant-Entities angelegt.
Wird auch bei „Auswahl aktualisiert — noch nicht gespeichert“ abgefragt.
Shelly Cloud DIY erneut anmelden
- Cloud-Schlüssel zur AutorisierungDer lange String, den die Shelly-Smart-Control-App unter „Access and permissions“ anzeigt.
- Server-URINur ändern, wenn Shelly dein Konto verschoben hat; der gespeicherte Wert ist vorbelegt.
Bei Shelly erneut anmelden (Cloud-Steuerung)
- E-Mail des Shelly-KontosDie E-Mail-Adresse, mit der du dich in der Shelly-App anmeldest.
- Passwort des Shelly-KontosWird einmal zur Anmeldung verwendet und danach verworfen. Gespeichert wird nur das daraus entstehende Token.
Nach der Einrichtung
- Abfrageintervall (Sekunden)3–60 s. Kleinere Werte fühlen sich flotter an, verbrauchen aber mehr von Shellys 1-req/s-Budget.
- Gerät als offline melden nach (Minuten)2–1440 min, Standard 30. Der Sensor „Reporting“ eines Geräts fällt ab, sobald das Gerät so lange nichts mehr gemeldet hat. Das ist nur ein Basiswert: ein von Natur aus stilleres Gerät bekommt automatisch ein weiteres Fenster, Batterie- und BLE-Geräte werden getrennt behandelt. Ein kleinerer Wert beschleunigt die Erkennung deshalb vor allem bei Geräten, die durchgehend melden — etwa Zwischenstecker mit Leistungsmessung.
- Vor einem Relais warnen, das nicht mehr öffnetStandardmäßig an. Beobachtet jeden Schaltkanal, der seinen eigenen Ausgang misst, und warnt, wenn das Relais sich als offen meldet, während weiterhin eine echte Last durch es fließt — ein verschweißter Kontakt. Abschalten, wenn ein Shelly in einer Wechselschaltung sitzt, wo der andere Schalter Strom durch die Messung schicken kann, obwohl das Relais wirklich offen ist.
- Lokale Gateway-URL (optional, für historische EM-Daten)Nur nötig, wenn ein lokales Shelly-Gateway für historische Energiedaten genutzt wird.
- Vor Geräten in schlechtem Zustand warnenStandardmäßig an. Wertet aus, was jeder Abruf ohnehin liefert: WLAN-Signal (Warnung ab -70 dBm, Fehler ab -85 dBm), Komponententemperatur (70 °C / 85 °C), freier Speicher und freier Dateisystem-Platz (unter 20 % / 10 %), ein noch ausstehender Neustart sowie jede Komponente, die selbst einen Fehler meldet. Das kostet keine zusätzlichen Anfragen. Bluetooth-Geräte (BLU) werden nur nach dem Signal beurteilt, das ihr Gateway für sie meldet, Gen1-Geräte gar nicht. Gewertet wird nur die Eigenwärme einer Komponente, nie ein externer Fühler am Add-on.
- Ausstehendes Firmware-Update als Befund wertenStandardmäßig aus. Ergänzt „Firmware-Update verfügbar“ als Befund. Auf einem typischen Konto hat die Mehrheit der Geräte eines offen — eingeschaltet leuchtet die Karte deshalb dauerhaft, und genau das sorgt dafür, dass die wichtigen Befunde untergehen.
- Virtuelle Komponenten über die Cloud steuern (nicht unterstützt)Standardmäßig aus — und vor dem Einschalten lesenswert. Virtuelle Komponenten (die Zonen eines Bewässerungscomputers, der Schalter eines Skripts) lassen sich über die dokumentierte Shelly-Cloud-API lesen, aber nicht schreiben: jede dokumentierte Route antwortet „diese Route gibt es nicht“. Schalten geht nur über einen undokumentierten Kanal, den der Shelly-Support am 27.07.2026 ausdrücklich als nicht unterstützt bezeichnet hat und der jederzeit ohne Ankündigung geändert oder abgeschaltet werden kann. Was es kostet: die Anmeldung an deinem Shelly-Konto (wird im nächsten Schritt abgefragt; das Passwort wird einmal verwendet und nie gespeichert) und eine zweite Verbindung zur Shelly Cloud. Was es bringt: je virtuellem Boolean einen Schalter — aber nur auf Geräten, die deinem Konto gehören. Ein geteiltes Gerät weist Shelly selbst ab, dafür entsteht kein Schalter. Der Schalter entsteht zusätzlich zum bestehenden schreibgeschützten Sensor derselben Komponente, nie an dessen Stelle, damit nichts kaputtgeht, was du darauf schon aufgebaut hast. Das Abschalten der Option löscht die gespeicherte Anmeldung wieder.
- Schnell-Aktion"Alle anhaken" oder "Alle abwählen" überschreibt beim Speichern die manuelle Liste unten. Mit "Manuelle Auswahl" zählt die Liste.
- Geräte (einzeln an-/abwählbar)Nur angehakte Geräte werden als Home-Assistant-Entities angelegt.
- Schnell-Aktion"Alle anhaken" oder "Alle abwählen" überschreibt beim Speichern die manuelle Liste unten. Mit "Manuelle Auswahl" zählt die Liste.
- Geräte (einzeln an-/abwählbar)Nur angehakte Geräte werden als Home-Assistant-Entities angelegt.
- E-Mail des Shelly-KontosDie E-Mail-Adresse, mit der du dich in der Shelly-App anmeldest.
- Passwort des Shelly-KontosWird einmal zur Anmeldung verwendet und danach verworfen. Gespeichert wird nur das daraus entstehende Token.
Texte aus dem Code von notDIRK/shelly-cloud-diy-ha. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Aktionen
- Historische Energiedaten herunterladen und konvertierenHolt CSV-Exporte vom lokalen Shelly-Gateway und importiert sie in die Langzeitstatistik von Home Assistant.Felder: Gateway-URL, Geräte-ID
- Gerät ersetzenÜberträgt die Home-Assistant-Identität eines defekten Shelly (Entity-IDs, das HA-Gerät, Name, Bereich, Verlauf sowie alle Automations-/Dashboard-Bezüge) auf einen neuen Shelly desselben Modells — so muss Home Assistant nach einem Hardware-Tausch nicht neu konfiguriert werden. Aktiviere zuerst das neue Gerät.Felder: Altes (ersetztes) Gerät, Neues Gerät, Trockenlauf, Erzwingen (Modell-Abweichung ignorieren)
- FlottenübersichtSchreibgeschütztes Overlay: ordnet jedes Cloud-Gerät per MAC seinem lokalen (nativen Shelly) Zwilling zu, schlägt Namen vor und markiert jedes Gerät, dessen Steuerung über die Cloud läuft. Schreibt einen Bericht in deine Benachrichtigungen. Jederzeit sicher ausführbar — es ändert nichts, sofern du es nicht ausdrücklich aktivierst.Felder: Trockenlauf, Native Namensvorschläge anwenden
- Shelly-Geräte finden, die nicht mehr in deinem Konto sindGleicht die von dieser Integration angelegten Shelly-Geräte mit dem aktuellen Bestand deines Shelly-Kontos ab und meldet jene, deren Hardware nicht mehr im Konto ist (verkauft, auf Werkseinstellungen zurückgesetzt oder in der Shelly-App gelöscht). Standardmäßig nur zur Information — es schreibt einen Bericht in deine Benachrichtigungen und ändert nichts. Das Entfernen ist ausdrücklich optional: Trockenlauf aus und Entfernen ein schalten, um die aufgeführten Geräte zu lösen; es wird vorher angezeigt und ist nicht automatisch umkehrbar.Felder: Trockenlauf, Aufgeführte Geräte entfernen, Auf diese Geräte beschränken
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Shelly Cloud drosselt diese Integration, Ausgewählte Geräte fehlen in deinem Shelly-Konto, Historische Energiedaten konnten nicht importiert werden, Ein Shelly-Relais schaltet nicht mehr ab, Einige Shelly-Geräte melden Probleme
Aus der README
🇩🇪 Deutsch · 🇬🇧 English (you are here) — README.de.md is the German mirror of this page.
Shelly Cloud DIY connects Home Assistant to your Shelly fleet through the self-service Cloud Control API — reaching the devices a local-only integration can never see (shared devices, remote sites, the Shelly BLU family behind a gateway), while keeping your switching local-first: the cloud is an overlay, never in the control path.
- cloud.connected still read connected thirteen minutes after a device was physically unplugged, and read connected for every device on the account — including ones silent for hours. It is a transport…
- Devices do eventually vanish from the cloud's fleet listing, but that took up to ten minutes, and the listing also omits healthy devices at random.
Erscheint in Vulpo
Lichtkarte, Schnellumschalterkarte, Rollladenkarte, Klimasteuerungs-Karte, Apple Watch, Kontrollzentrum, Klima-Live-Aktivität.Informationen
- Installationen
- 242 teilen Analysedaten
- GitHub-Sterne
- 17
- Verbindung
- Nutzt die Cloud des Herstellers
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v0.16.4,
- Kategorie
- Steckdosen und Schalter
- Art
- Marketplace-Integration
- Marke
- Shelly
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
shelly_cloud_diy- Probleme
- Problem melden












