Claude AI Smart-Home-Integration, kostenlos und Open Source
Betreibe den Gladys-Assistenten mit Claude, der KI von Anthropic, und deinem API-Schlüssel.
Veröffentlicht von prohand
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.3.0
- ★ 0
Diese Integration macht Claude, die KI von Anthropic, zum Gehirn des Gladys-Assistenten. Einmal ausgewählt, beantwortet sie alle KI-Anfragen deiner Gladys: den Chat (und die Geräte, die er für dich steuert), das Einordnen deiner Nachrichten, die Szenen-Aktion KI fragen und die Wochenzusammenfassung.
Es ist eine Community-Integration: Sie wird weder von Anthropic erstellt noch unterstützt.
Bevor du beginnst
- Gladys 5.3 oder neuer.
- Ein Anthropic-API-Schlüssel. Erstelle ein Konto auf
console.anthropic.com, lade Guthaben auf
oder hinterlege eine Zahlungsmethode, und erstelle dann einen Schlüssel unter
Settings → API keys. Er beginnt mit
sk-ant-. - Die Nutzung wird von Anthropic abgerechnet, pro Token, zum Preis des gewählten Modells. Gladys Plus ist nicht nötig.
Claude läuft in der Cloud (api.anthropic.com): Gladys braucht
Internetzugang.
Konfiguration
- Installiere die Integration aus dem Katalog und öffne dann ihren Reiter Konfiguration.
- Füge deinen Anthropic-API-Schlüssel ein und speichere.
- Klicke auf Verbindung testen: Jedes Modell beantwortet eine Ein-Wort- Frage, und die benötigte Zeit wird unter der Schaltfläche angezeigt.
- Gehe zu Einstellungen → Künstliche Intelligenz und wähle Claude AI als KI-Anbieter.
Der Status oben im Konfigurationsbildschirm wird grün, wenn der Schlüssel akzeptiert wird und die gewählten Modelle für ihn freigegeben sind. Ist er rot, nennt er den Grund.
Die Einstellungen
| Einstellung | Was sie bewirkt |
|---|---|
| Anthropic-API-Schlüssel | Dein Schlüssel. Er bleibt in Gladys, wird nie wieder angezeigt und nie in die Protokolle geschrieben. |
| Chat-Modell | Beantwortet den Chat, erstellt die Szenen, schreibt die Wochenzusammenfassung. Standard: Claude Opus 5.5. Sonnet 5.5 ist schneller und günstiger, Fable 5.1 am stärksten und am teuersten. |
| Router-Modell | Ordnet jede Nachricht vor der Antwort ein. Gladys wartet höchstens 20 Sekunden darauf: Behalte ein schnelles Modell, Standard: Claude Haiku 5.5. |
| Denkaufwand | Wie viel das Chat-Modell vor der Antwort nachdenkt: niedrig, mittel (Standard), hoch, sehr hoch. Mehr Aufwand hilft bei schwierigen Anfragen (eine Szene erstellen), antwortet aber langsamer und kostet mehr. |
| Maximale Antwortlänge (Tokens) | Das Ausgabebudget einer Antwort, Nachdenken inklusive. Standard: 16.000. Erhöhe es, wenn die Protokolle melden, dass eine Antwort max_tokens erreicht hat. |
Was Claude sieht
Die Wahl eines KI-Anbieters ist eine Datenschutzentscheidung. Der Anbieter erhält:
- jede Chat-Nachricht und den Gesprächsverlauf;
- die Beschreibung der Werkzeuge, die Gladys ihm anbietet, und ihre Ergebnisse — den Zustand der Geräte, die er abfragt;
- die Bilder, die du im Chat sendest.
Seine Antworten steuern deine Geräte und erstellen deine Szenen. Lies die Datenschutzrichtlinie von Anthropic, bevor du ihn wählst.
Kosten und Geschwindigkeit
- Der Systemprompt und die Werkzeugliste kommen bei jeder Nachricht wieder: Die Integration bittet Anthropic, sie zwischenzuspeichern, was sie nach der ersten Nachricht zu einem Bruchteil des Preises abrechnet.
- Der Router läuft immer mit niedrigem Aufwand auf dem Router-Modell: Es ist die am häufigsten gesendete Anfrage.
- Um weniger auszugeben, wähle Claude Sonnet 5.5 für den Chat oder senke den Aufwand.
- Lehnt Claude eine Anfrage aus Sicherheitsgründen ab, wiederholt Anthropic sie im selben Aufruf mit seinem Standard-Ersatzmodell; lehnen alle Modelle ab, antwortet der Assistent, dass er nicht helfen kann.
Fehlerbehebung
- „Anthropic hat den API-Schlüssel abgelehnt“ — der Schlüssel ist falsch, widerrufen oder gehört zu einer Organisation ohne Guthaben. Erstelle einen neuen und füge ihn erneut ein.
- „… ist für diesen API-Schlüssel nicht verfügbar“ — deine Anthropic-Organisation hat keinen Zugang zu diesem Modell: Wähle ein anderes.
- „Anfragelimit erreicht“ — zu viele Anfragen für deine Anthropic-Nutzungsstufe: Warte einen Moment oder erhöhe deine Stufe in der Anthropic-Konsole.
- „api.anthropic.com ist nicht erreichbar“ — Gladys hat keinen Internetzugang, oder eine Firewall blockiert diese Adresse.
- Der Assistent meldet, dass der KI-Anbieter nicht verfügbar ist — öffne den Reiter Protokolle der Integration: Jede Anfrage schreibt dort eine Zeile (Modell, Zeit, Tokens) und jeder Fehler seinen Grund.
Konfigurationseinstellungen
Diese Einstellungen fragt Claude AI in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Claude antwortet über die Anthropic-API, in der Cloud: Erstelle einen API-Schlüssel auf console.anthropic.com (die Nutzung wird von Anthropic abgerechnet), füge ihn unten ein und wähle dann diese Integration unter Einstellungen, Künstliche Intelligenz. Claude sieht dann jede Chat-Nachricht, den Verlauf, den Zustand der Geräte, die es abfragt, und die Bilder des Chats. |
| Anthropic-API-Schlüssel | secret | Ja | Auf console.anthropic.com erstellt, beginnt er mit sk-ant-. Er bleibt in Gladys und wird nie wieder angezeigt oder protokolliert. |
| Chat-Modell | select | Ja | Beantwortet den Chat, erstellt die Szenen und schreibt die Wochenzusammenfassung. Opus ist für seinen Preis am leistungsfähigsten, Sonnet schneller und günstiger, Fable am stärksten und am teuersten. |
| Router-Modell | select | Ja | Ordnet jede Chat-Nachricht vor der Antwort ein und muss innerhalb von 20 Sekunden antworten: Ein schnelles Modell passt am besten. |
| Denkaufwand | select | Nein | Wie viel das Chat-Modell vor der Antwort nachdenkt. Mehr Aufwand: bessere Antworten auf schwierige Anfragen, aber langsamer und mehr abgerechnete Tokens. |
| Maximale Antwortlänge (Tokens) | number | Nein | Das Nachdenken zählt ebenfalls dazu. Erhöhe den Wert, wenn die Protokolle melden, dass eine Antwort max_tokens erreicht hat. |
So installierst du Claude AI in Gladys
- Öffne in Gladys Integrationen: Claude AI erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-ai-claude:0.1.1) 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/prohand/gladys-ai-claude.
Claude AI 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
Claude AI 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 prohand 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