Home Assistant: Festlegen, was KI-Agenten dürfen

Warum ein Token nicht reicht

Ein KI-Agent mit einem Home-Assistant-Token kann alles, was dieser Token kann: die Haustür aufschließen, die Alarmanlage abschalten, das Garagentor öffnen. Eine Prompt-Injection in einer E-Mail oder Webseite, die der Agent liest, genügt, damit er es versucht. Geräte für Assistenten freizugeben kennt nur an oder aus – keine Zeitfenster, keine Grenzwerte, keine Rückfrage vor einer Aktion.

Home-Mandate behält die Zugangsdaten von Home Assistant für sich. Jeder Agent bekommt eine eigene Identität und ein eigenes Mandat, und jede Anfrage wird nach festen Regeln außerhalb des Sprachmodells entschieden – kein Agent kann sich mehr Rechte herbeireden. Warum Mandate?

So funktioniert es

1. Der Agent fragt an Er verbindet sich per MCP und meldet sich mit OAuth 2.1 an. Einen Home-Assistant-Token sieht er nie.
3. Das Mandat entscheidet Home-Mandate schlägt das Gerät nach und prüft das Mandat des Agenten: erlauben, nachfragen oder ablehnen.
5. Du bestätigst Bei „nachfragen“ zeigt dein Handy in der Companion-App Erlauben und Ablehnen. Keine Antwort heißt nein.
7. Home Assistant führt aus Nur eine erlaubte oder bestätigte Aktion erreicht Home Assistant. Alles landet im Protokoll.

Die Entscheidung trifft der Referenz-Evaluator der Home-Mandate-Spezifikation, nie ein Sprachmodell. Was nicht erlaubt ist, wird verweigert. Geräte, die ein Agent nicht lesen darf, gibt es für ihn nicht: Sie werden weder aufgelistet noch in Fehlern genannt.

Beispiel: ein erstes Mandat

Ein Mandat für einen Sprachassistenten, der im Haushalt hilft, könnte so aussehen. Home-Mandate bringt drei Vorlagen zum Start mit.

Was du festlegen kannst

• Erlauben, nachfragen oder ablehnen je Gerät, Bereich, Kategorie und Aktion – mit Zeitfenstern, Wochentagen, Grenzwerten (Helligkeit, Temperatur, Position, Lautstärke) und einer Obergrenze an Aktionen pro Stunde.
• Kritische Aktionen – aufschließen, Tor oder Garage öffnen, Alarmanlage abschalten, Skripte ausführen, Kamerabilder – brauchen eine Rückfrage, auch wo eine Regel sie erlaubt, außer die Regel sagt ausdrücklich etwas anderes.
• Rückfragen gehen über die Home-Assistant-Companion-App an die Handys der Personen, die du auswählst.
• Ein Not-Aus stoppt alle Agenten auf einmal; einzelne Agenten lassen sich sperren.
• Jede Entscheidung, Rückfrage und Änderung landet in einem verketteten Protokoll mit signierten Prüfpunkten.
• Agenten bekommen kurzlebige Tokens, die an Home-Mandate gebunden sind; ohne Home-Assistant-Administrator wird kein Agent zugelassen.
• Weboberfläche auf Deutsch und Englisch in der Seitenleiste von Home Assistant; Verwaltung auch auf der Kommandozeile.

Installation

1. 1Voraussetzungen prüfenHome Assistant OS ab 2026.9 auf amd64 oder aarch64 – oder Home Assistant Container mit Docker oder Podman Compose. Die Companion-App auf dem Handy aller, die Rückfragen beantworten sollen.
2. 2Home-Mandate installierenUnter Home Assistant OS das Repository unten im App Store hinzufügen (Einstellungen → Apps → App Store → ⋮ → Repositories) und Home-Mandate installieren. Mit Home Assistant Container läuft es über die Compose-Datei neben Home Assistant.
3. 3Freigebende und ein Mandat einrichtenWähle, wer Rückfragen beantwortet, markiere kritische Geräte und starte mit einer der Vorlagen.
4. 4Den ersten Agenten verbindenClaude Desktop, Claude Code, claude.ai, ChatGPT oder ein anderer MCP-Client meldet sich an; ein Home-Assistant-Administrator lässt ihn zu und wählt sein Mandat.

Das Repository für den App Store:

https://github.com/home-mandate/ha-home-mandate

Schritt für Schritt (auf Englisch): Home Assistant OS(öffnet eine andere Website in einem neuen Tab), Container-Modus(öffnet eine andere Website in einem neuen Tab), erste Schritte(öffnet eine andere Website in einem neuen Tab) und Agenten verbinden(öffnet eine andere Website in einem neuen Tab).

Erreichbarkeit von außen

Die meisten Agenten laufen nicht in deinem Heimnetz, sie müssen Home-Mandate also über HTTPS erreichen. Home-Mandate spricht nur TLS 1.3. Unter Home Assistant OS nutzt es ein Zertifikat in /ssl, etwa von der Let’s-Encrypt- oder DuckDNS-App, und braucht ein TLS-Passthrough oder eine Portweiterleitung.

Im Container-Modus kann Home-Mandate auch hinter deinem eigenen Reverse Proxy laufen: Es gibt Anleitungen für Traefik, nginx, Nginx Proxy Manager und Caddy(öffnet eine andere Website in einem neuen Tab).

Konformität

Home-Mandate for Home Assistant enthält den Referenz-Evaluator der Spezifikation und prüft bei jeder Änderung ihre Konformitätsfälle. Welche Version und welche Klassen es besteht, steht in der Liste der Implementierungen, geprüft anhand der veröffentlichten Berichte.

Fragen

Home-Mandate for Home Assistant steht unter AGPL-3.0-or-later. Quellcode, Releases und Issues: github.com/home-mandate/ha-home-mandate(öffnet eine andere Website in einem neuen Tab).