Home Assistant Automationen: Die YAML-Grundlagen für Einsteiger

Aufbau einer Automation: Trigger, Bedingung, Aktion

Jede Automation folgt diesem Schema:

1. Trigger (Auslöser): Wann soll die Automation starten? Z.B. um 22:00 Uhr, oder wenn ein Schalter gedrückt wird, oder wenn die Temperatur über 25 °C steigt.

2. Condition (Bedingung, optional): Soll die Automation nur unter bestimmten Bedingungen laufen? Z.B. nur nachts, oder nur wenn jemand daheim ist?

3. Action (Aktion): Was soll die Automation tun? Z.B. Licht ausschalten, Heizung senken, Benachrichtigung senden.

Automationen per UI vs. per YAML erstellen

UI-Editor: Home Assistant Dashboard → Automationen & Szenen → Neue Automation. Visuelle Formulare für Trigger, Condition, Action. Gut für Anfänger, aber begrenzte Flexibilität.

YAML-Editor: Bearbeit die `automations.yaml` Datei direkt (oder neue Datei wie `automations_custom.yaml`). Volle Kontrolle, flexibler, aber Syntax-Fehler können Probleme verursachen. Home Assistant Editor hat Syntax-Highlighting und Validierung.

Hybrid: Einige Automationen per UI, andere per YAML. Beide funktionieren parallel.

Einfache Beispiel-Automation Schritt für Schritt

Ziel: „Um 22:00 Uhr jeden Abend das Wohnzimmer-Licht auf 10 % dimmen."

YAML-Code:

automation gute_nacht:
  trigger:
    platform: time
    at: "22:00:00"
  action:
    service: light.turn_on
    target:
      entity_id: light.wohnzimmer
    data:
      brightness: 25

Erklärung:

• automation gute_nacht: — Name der Automation (kann beliebig sein)
• trigger: — Beginn des Trigger-Blocks
• platform: time — Zeitbasierter Trigger
• at: "22:00:00" — Genauer Zeitpunkt
• action: — Was zu tun ist
• service: light.turn_on — Service aufrufen (Licht einschalten)
• entity_id: light.wohnzimmer — Welches Licht?
• brightness: 25 — Helligkeit (0–255, hier: 10 %)

Mit Bedingung: Nur nachts

Erweitern wir das Beispiel: „Um 22:00 Uhr Wohnzimmer-Licht dimmen, aber nur wenn jemand daheim ist."

automation gute_nacht_bedingt:
  trigger:
    platform: time
    at: "22:00:00"
  condition:
    condition: state
    entity_id: group.family
    state: "home"
  action:
    service: light.turn_on
    target:
      entity_id: light.wohnzimmer
    data:
      brightness: 25

Neu: Der `condition` Block. `state: "home"` prüft, ob der `group.family` (Familiengruppe) daheim ist. Nur dann läuft die Action.

Häufige Syntax-Fehler vermeiden

Fehler 1: Falsche Einrückung. YAML nutzt Einrückung (Spaces, nicht Tabs). 2 Spaces pro Level. Falsch:

automation test:
trigger:
  platform: time

Richtig:

automation test:
  trigger:
    platform: time

Fehler 2: Entity IDs mit Typos. `entity_id: light.wohnzimmer_lampe` — aber die echte Entity ist `light.wohnzimmer_deckenlampe`. Der Typo führt zu „Entity not found" Fehler.

Fehler 3: Strings nicht quoted. `at: 22:00:00` wird zu einer Zahl interpretiert. Besser: `at: "22:00:00"`.

Automationen testen und debuggen

Schritt 1: Schreib die Automation in YAML. Überprüf Syntax mit Home Assistant YAML-Validator (Developer Tools → YAML).

Schritt 2: Speichern. Home Assistant lädt automatisch neueAutomationen.

Schritt 3: Test manuell: Dashboard → Automationen & Szenen → Deine Automation → „Trigger" Knopf klicken.

Schritt 4: Überprüf die Logs (Developer Tools → Logs). Fehlermeldungen helfen bei der Diagnose.

Häufiges Problem: Automation läuft, aber Action funktioniert nicht. Überprüf Entity ID und Service Name mit Developer Tools → Services.