Valetudo Smart-Home-Integration, kostenlos und Open Source
Saugroboter ohne Cloud dank Valetudo: Steuerung, Räume, Live-Karte, Verschleißteile.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Überblick
Diese Integration steuert Saugroboter mit Valetudo (valetudo.cloud), der offenen Firmware, die die Cloud des Herstellers ersetzt, über ihre offizielle lokale REST-API: kein Konto, nichts verlässt dein Netzwerk. Jeder Roboter wird ein Gladys-Gerät mit den nativen Saugroboter-Funktionen (Zustand, Reinigung, Station, Akku), seinen Voreinstellungen für Saugkraft und Wasser und der Restlebensdauer seiner Verbrauchsmaterialien. Szenenaktionen reinigen Räume über ihren Namen und steuern den Roboter; Szenenauslöser melden, wann eine Reinigung beginnt oder endet, wann der Roboter einen Fehler hat oder dich braucht. Drei Dashboard-Widgets zeigen den Roboter, seine Live-Karte und seine Wartung.
Nicht mit dem Valetudo-Projekt verbunden. Noch nicht an einem echten Roboter getestet: Die Anfragen folgen der offiziellen API von Valetudo 2026.10; Rückmeldungen sind willkommen.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Ein Saugroboter mit Valetudo im selben Netzwerk wie Gladys, dessen Valetudo-Seite sich im Browser öffnen lässt.
- Am besten eine feste IP-Adresse für den Roboter im Router. Zum Reinigen von Räumen braucht es einen Roboter mit Raumaufteilung und eine gespeicherte Karte.
Konfiguration
- Installiere die Integration aus dem Store und öffne ihre Konfiguration.
- Lass Roboter automatisch finden (mDNS) eingeschaltet. Für einen Roboter in einem anderen Netzwerk gib seine Adresse (IP oder Name, bei Bedarf mit
:Port) unter Adressen der Roboter (optional) ein. - Ist in Valetudo die HTTP-Authentifizierung eingeschaltet (Settings → Connectivity → Auth settings), gib denselben Benutzernamen und dasselbe Passwort ein.
- Wähle die Sprache der Gerätetexte und klicke auf Roboter suchen und testen: Die Meldung listet jeden gefundenen Roboter mit Adresse und Akku auf.
- Öffne den Tab Entdecken und füge deine Roboter hinzu.
Verwendung
Jeder Roboter erhält diese Funktionen, je nachdem, was Valetudo für ihn anbietet:
| Funktion | Typ | Was sie tut |
|---|---|---|
| Zustand | Saugroboter, Sensor | Gestoppt, reinigt, pausiert, Fehler, kehrt zurück, lädt, in der Station |
| Reinigung | Saugroboter, Liste | Stoppen, Reinigen (startet oder setzt fort), Kartieren (Kartierungsfahrt, falls möglich) |
| Zur Station | Saugroboter, Taste | Schickt den Roboter zurück zu seiner Station |
| Akku | Akku, % | Ladestand |
| Saugkraft | Liste | Die Saugkraft-Voreinstellungen des Roboters |
| Wasser | Liste | Die Wasser-Voreinstellungen (Wischroboter) |
| Modus | Liste | Saugen, Wischen, Saugen und Wischen… (bei Robotern, die es anbieten) |
| Verbrauchsmaterial | Wartung, % | Restlebensdauer jeder Bürste, jedes Filters, Wischpads… die sie meldet |
Änderungen meldet Valetudo sofort; Verbrauchsmaterialien und Statistiken werden alle paar Minuten gelesen.
Dashboard-Widgets
- Saugroboter: Zustand, Akku, Fläche und Dauer der laufenden Reinigung, Saugkraft und Wasser, die Fehlermeldung; Tasten Starten / Pause / Fortsetzen, Zur Station, Orten und Raum reinigen (Raum und Durchgänge wählen).
- Roboterkarte: die von der Integration gezeichnete Live-Karte (Räume in Farbe, Wände, Weg, Roboter in Blau, Station in Grün, virtuelle Wände und Sperrzonen in Rot), der gerade gereinigte Raum in Bernstein.
- Roboterwartung: Gesamtfläche, -zeit und -anzahl der Reinigungen, jedes Verbrauchsmaterial, das am stärksten verschlissene zuerst (Badge Ersetzen unter 10 %, Bald unter 25 %), und Zurücksetzen, nachdem du eines ersetzt hast.
Szenen
Aktionen: Räume mit einem Saugroboter reinigen (Raumnamen wie in Valetudo festgelegt, Akzente sowie Groß- und Kleinschreibung egal, oder Raumnummern, durch Kommas getrennt; Durchgänge; optional vorher Saugkraft und Wasser setzen; gibt die gesendeten Räume zurück) und Saugroboter steuern (starten oder fortsetzen, pausieren, stoppen, zurück zur Station, orten, Behälter an der Station leeren, Mopp an der Station waschen oder trocknen).
Auslöser: Reinigung gestartet, Reinigung beendet (mit der Fläche in m² und der Dauer in Minuten), Fehler (mit der Meldung des Roboters), braucht Aufmerksamkeit (Staubbehälter voll, Verbrauchsmaterial verschlissen, Erinnerung ans Wischpad, etwas fehlt, Kartenänderung zu bestätigen; nach Grund filterbar), antwortet nicht mehr und antwortet wieder. Der Name des Roboters steht immer als Variable bereit.
Beispiele:
- Wenn alle das Haus verlassen → „Küche, Wohnzimmer“ zweimal reinigen.
- Wenn die Reinigung beendet ist → „{{triggerEvent.data.area_m2}} m² gereinigt“ an dein Handy senden.
- Wenn der Roboter Aufmerksamkeit braucht, weil der Staubbehälter voll ist → das Licht im Flur blinken lassen.
Fehlerbehebung
- Kein Roboter gefunden: Prüfe, ob sich seine Valetudo-Seite unter seiner Adresse von einem anderen Gerät aus öffnet, gib dann diese Adresse in der Konfiguration ein und nutze Roboter suchen und testen. mDNS überquert keine VLANs und keine Gastnetze.
- „lehnt Benutzername oder Passwort ab“: Die Zugangsdaten passen nicht zur HTTP-Authentifizierung von Valetudo.
- „kann das nicht“: Valetudo bietet diese Capability für diesen Roboter nicht an (eine Stationsfunktion, Räume, Kartierung); die Meldung nennt sie.
- Keine Karte im Widget: Der Roboter hat noch keine gespeicherte Karte; lass ihn eine erste vollständige Reinigung beenden.
- Für einen Fehlerbericht nenne die Versionen von Gladys, der Integration und von Valetudo, das Robotermodell, die Meldung der Testtaste und die Logs (füge im Entwicklermodus
DEBUG=gladys-integration-sdkhinzu): Issue eröffnen.
Konfigurationseinstellungen
Diese Einstellungen fragt Valetudo in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Bevor du beginnst | section | Nein | Für Saugroboter mit Valetudo (valetudo.cloud), der freien Firmware, die die Cloud des Herstellers ersetzt. Gladys spricht über die offizielle lokale REST-API mit dem Roboter: kein Konto, nichts verlässt dein Netzwerk. Installiere zuerst Valetudo auf dem Roboter und öffne dann den Tab Entdecken. |
| Roboter automatisch finden (mDNS) | boolean | Nein | Valetudo kündigt sich im lokalen Netzwerk an; Gladys hört darauf. Schalte das aus, um nur eingegebene Adressen zu nutzen. |
| Adressen der Roboter (optional) | string | Nein | Für einen Roboter, den die automatische Suche nicht erreicht (anderes Netz, mDNS in Valetudo aus). IP-Adresse oder Name, bei Bedarf mit :Port; durch Kommas trennen. Gib dem Roboter im Router eine feste Adresse. |
| Valetudo-Passwort (falls gesetzt) | section | Nein | Nur wenn die HTTP-Authentifizierung in Valetudo aktiv ist (Einstellungen → Konnektivität → Auth settings). Derselbe Benutzername und dasselbe Passwort gelten für alle Roboter. |
| Benutzername | string | Nein | |
| Passwort | secret | Nein | |
| Sprache der Gerätetexte | select | Nein | Namen der Funktionen und Optionen im Tab Entdecken, Meldungen der Auslöser und Fehler der Szenenaktionen. Gladys sendet deine Sprache nicht mit. |
| Ein Roboter wird nicht gefunden? | section | Nein | Prüfe, ob der Roboter in seiner Station und im selben Netzwerk wie Gladys ist und ob sich die Valetudo-Seite unter seiner Adresse im Browser öffnet; gib dann diese Adresse oben ein und nutze „Roboter suchen und testen“. |
So installierst du Valetudo in Gladys
- Öffne in Gladys Integrationen: Valetudo erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-valetudo:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-valetudo.
Valetudo benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Valetudo ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation