EcoFlow Home Assistant: 3 Integrationswege

Wer einen EcoFlow Stream Ultra oder eine der anderen Stream-Varianten in Home Assistant einbinden will, steht vor einer unübersichtlichen Lage: Drei verschiedene Community-Projekte, unterschiedliche Protokolle, und, kritisch, was für den Stream gilt, gilt nicht für den PowerOcean. Der falsche Integrationsweg kostet mehrere Stunden Debugging.

Welches EcoFlow-Gerät hast du? Die Entscheidungsmatrix

Vor dem Setup das Gerät zuordnen. Stream und PowerOcean haben vollständig getrennte Integrationswege:

Weg 1: tolwi HACS-Integration (Cloud), Monitoring für Stream und Delta/River

Die Community-Integration hassio-ecoflow-cloud von tolwi ist die meistgenutzte Option. Aktuelle Version: v1.4.1 (April 2026) . Stream-Modelle (AC, Pro, Ultra, Microinverter, Ultra X) laufen über die Public API (REST+MQTT), Delta/River-Modelle über die Private MQTT API ohne Developer-Konto.

Developer-Konto für Stream-Modelle: So geht’s

1. Auf developer-eu.ecoflow.com mit bestehendem EcoFlow-App-Account registrieren.
2. Genehmigung abwarten, ca. 24 Stunden .
3. Im Developer-Portal unter “Public API” den Access Key und Secret Key notieren.

Installation in vier Schritten

1. HACS öffnen, nach “EcoFlow Cloud” suchen, herunterladen.
2. Home Assistant neu starten.
3. Einstellungen → Geräte & Dienste → Integration hinzufügen → “EcoFlow Cloud” → Authentifizierung per Public API → Access Key und Secret Key eintragen.
4. Gerät auswählen.

EU-Host-Falle, der häufigste Setup-Fehler

Was die Integration liefert

Nach der Einrichtung stehen als Entities bereit: SOC in Prozent, Lade- und Entladeleistung, Solar-Input, Tages- und Gesamtertrag sowie Verbindungsstatus. Steuerungs-Entities für Stream-Modelle gibt es nicht, die Public API ist read-only für den Stream. Wer den Stream aktiv regeln will (Null-Einspeisung, Base-Load-Steuerung), braucht den BLE-Weg.

Weg 2: ha-ef-ble (Bluetooth/lokal), echte Steuerung des Stream

Das Projekt ha-ef-ble von rabits ist die einzige Möglichkeit, EcoFlow Stream-Geräte aktiv über Home Assistant zu steuern. Version: v0.9.0, Mai 2026 . Unterstützte Modelle: Stream Ultra, Ultra X, Pro, Max, AC, AC Pro, Microinverter, ohne Internetverbindung, lokal per Bluetooth.

Steuerungs-Entities

• Base Load Power: Netzeinspeisung in Watt, der Schlüssel zur Null-Einspeisung-Automation
• Charging Power Limit: Maximale Ladeleistung (nur wenn Ladetimer aktiv)
• Charge Limit / Discharge Limit: SOC-Grenzen in Prozent

Voraussetzung: Zeitplan im Stream konfigurieren

Base Load Power funktioniert nur, wenn im Stream ein Basislast-Zeitrahmen konfiguriert ist. Die Integration dokumentiert explizit: “Not available when there’s no base load timeframe or more than 1 timeframe configured” . Community-Berichte bestätigen, dass ein durchgehender Zeitplan (00:00–24:00) in der Stream-App gesetzt sein muss .

Reaktionszeit: ca. 5 Sekunden, damit sind schnelle Null-Einspeisung-Regelkreise möglich. Ein Blueprint im Repository implementiert Zero-Feed-in mit konfigurierbarem Deadband (Standard 25 W) und Mindeständerungsschwelle (15 W) .

BLE-Reichweite und Proxy-Setup

Bluetooth hat eine praktische Reichweite von ca. 10 m ohne Hindernisse. In Mehr-Etagen-Häusern oder bei komplexem Grundriss kann die Verbindung instabil werden. Lösung: Ein ESP32 als BLE-Proxy, den Home Assistant als Bluetooth-Adapter erkennt, das verlängert die effektive Reichweite auf mehrere Räume. Die HA-Dokumentation beschreibt die ESPHome-BLE-Proxy-Konfiguration.

Installation

HACS → Custom Repository https://github.com/rabits/ha-ef-ble → Typ Integration → Download → HA neu starten → Integration hinzufügen → Bluetooth-Gerät auswählen. Kein Developer-Konto, kein API-Key, kein Internet nötig.

Wer Sensor-Monitoring (tolwi) und Steuerung (ha-ef-ble) kombinieren will, kann beide Integrationen parallel betreiben, sie greifen auf unterschiedliche Protokolle zu und beißen sich nicht.

Weg 3: PowerOcean Plus in Home Assistant

Für den EcoFlow PowerOcean Plus ist die ecoflow-powerocean-ha-Integration von Feberdin der richtige Weg. Version: v0.4.0, April 2026 . Getestet mit dem PowerOcean Plus 15 kW (Seriennummer R37).

Protokoll: MQTT-Secure zu mqtt-e.ecoflow.com:8883 mit Protobuf-Kodierung und XOR-Verschlüsselung, identisch zum Verfahren der offiziellen EcoFlow-App .

2FA-Pflicht deaktivieren

Was die Integration liefert: Per-Batterie-Metriken, 3-Phasen-Daten, Backup-Laufzeitschätzung, Stromausfalls-Erkennung (ab v0.4.0).

Zusatz-Option Modbus (Community): Das Projekt ecoflow-poweroceanplus-modbus von MaxGrmm ermöglicht lokales Monitoring per Modbus. Kein offizielles Register, die Adressen sind Community-Reverse-Engineering. Nur PowerOcean Plus getestet; Stream-Modelle haben kein Modbus-Interface .

EcoTracker als Smart Meter in Home Assistant

Der everHome EcoTracker lässt sich per REST-Sensor in Home Assistant einbinden, ohne HACS-Click-Integration, per YAML-Konfiguration. Der EcoTracker stellt einen lokalen HTTP-Endpoint unter http://<IP-des-EcoTracker>/v1/json bereit, der Messwerte im JSON-Format liefert .

sensor:
  - platform: rest
    name: "EcoTracker"
    resource: "http://192.168.x.x/v1/json"
    scan_interval: 5
    value_template: "{{ value_json.power }}"

Scan-Intervall von 5 Sekunden ist möglich, damit eignet sich der EcoTracker als Grundlage für Null-Einspeisung-Automationen in Verbindung mit ha-ef-ble. Die Kombination EcoTracker (Hausverbrauch) + ha-ef-ble (Stream-Steuerung) ist die vollständig lokale Alternative zu Cloud-basierten Smart-Meter-Lösungen.

Kein HACS-Click-Integration: Ein nativer HA-Integrations-Antrag wurde im Februar 2026 auf GitHub (Discussions #2855) gestellt, aber noch nicht zugesagt . Bis dahin bleibt YAML der einzige Weg.

Zum Vergleich: Wer keinen EcoTracker hat, kann denselben Null-Einspeisung-Use-Case mit einem Shelly Pro 3EM umsetzen, ebenfalls lokal, aber herstellerneutral und für 3-Phasen-Setups ausgelegt.

Empfehlung: Welchen Weg nehmen?

Stream-Monitoring ohne Steuerung: tolwi HACS-Integration. Developer-Konto anlegen (24h Wartezeit), EU-Host api-e.ecoflow.com nicht vergessen. Einstieg für alle, die erstmal Daten im Energy Dashboard wollen.

Stream-Steuerung und Null-Einspeisung: ha-ef-ble. Kein Cloud-Konto, schnelle Reaktionszeit (~5s), echter Regelkreis. BLE-Reichweite im Blick behalten, ggf. ESP32-Proxy einplanen. Für TOU/Tibber-Optimierung via Home Assistant ist das die einzige belastbare Option, ohne ha-ef-ble lässt sich der Stream nicht aktiv regeln.

Beides kombinieren: Kein Konflikt. tolwi liefert die Cloud-Sensor-Daten (z. B. Tagesertrag, SOC-History), ha-ef-ble übernimmt die Echtzeit-Steuerung. Zwei Integrationen, zwei Protokolle, kein Overlap.

PowerOcean Plus: Feberdin MQTT. 2FA deaktivieren ist Pflicht. Wer Modbus-Monitoring zusätzlich will: MaxGrmm-Projekt als Ergänzung.

Wer den Stream lieber ohne Home Assistant spotpreisgesteuert betreibt: Der native Tibber-Support im Stream funktioniert direkt in der EcoFlow-App, ohne HA, ohne Developer-Konto. Einen Überblick, welche Speicher generell native Tarif-Integration mitbringen, liefert der Vergleich nativer Tibber-Support.

Wer neben dem EcoFlow auch einen Hoymiles-Wechselrichter betreibt, findet die passende HA-Anbindung unter Hoymiles HMS in Home Assistant. Für OpenDTU- und Ahoy-Nutzer gibt es den direkten Vergleich OpenDTU vs. Ahoy. Alle HA-Integrations-Artikel im Überblick: Home-Assistant-Hub.

Passende EcoFlow-Geräte