Skip to main content
Gateways verbinden Alter mit Discord- und Telegram-Bots, damit Sie mit Alter aus diesen Apps chatten können. Jedes Gateway läuft lokal auf Ihrem Mac — Alter muss geöffnet und aktiv sein, damit Nachrichten verarbeitet werden.
Gateways (Discord-/Telegram-Bots) unterscheiden sich vom API Gateway unter Einstellungen → Router, das einen OpenAI-kompatiblen Endpunkt für Drittanbieter-Apps bereitstellt. Siehe API Gateway Guide für diese Funktion.

Was Gateways tun

Mit Gateways nutzen Sie Alter über Chat-Plattformen, die Sie bereits geöffnet haben:
  • Discord — Senden Sie dem Bot eine DM oder erwähnen Sie ihn in einem Serverkanal (wenn konfiguriert).
  • Telegram — Schreiben Sie dem Bot in einem privaten Chat oder einer Gruppe.
Jede Gateway-Instanz hat einen eigenen Namen, Standardaktion, Zugriffskontrollen und Verbindungseinstellungen. Unterhaltungen werden in Alter auf Ihrem Mac wie Hub-Chats gespeichert — Gateways sind ein weiterer Weg, diese Unterhaltungen zu starten und fortzusetzen. Wenn jemand eine Nachricht sendet, Alter:
  1. Empfängt sie über die Plattform-Bot-Verbindung.
  2. Führt die ausgewählte Alter Action aus (zum Beispiel Ask Anything).
  3. Streamt die Antwort zurück in den Discord-Kanal oder Telegram-Chat.
  4. Kann eingehende Anhänge herunterladen und Ausgabedateien von Tool-Ausführungen hochladen.

Gateways-Einstellungen öffnen

1

Settings öffnen

Drücken Sie ⌘, (Command + Komma), klicken Sie auf das Alter-Symbol in der Menüleiste und wählen Sie Einstellungen…, oder öffnen Sie Einstellungen über das -Menü im Notch.
2

Zu Integrations → Gateways gehen

Öffnen Sie in der Einstellungs-Seitenleiste Integrationen und wählen Sie Gateways.
Sie können auch direkt verlinken: com.wearedevx.alter://settings?id=gateways Die Gateways-Seite zeigt alle konfigurierten Gateways. Verwenden Sie Gateway hinzufügen, um eine Discord- oder Telegram-Verbindung anzulegen.

Einrichtungsanleitungen

Discord gateway

Erstellen Sie einen Discord-Bot, aktivieren Sie Intents, laden Sie ihn auf Ihren Server ein und verbinden Sie ihn in Alter.

Telegram gateway

Erstellen Sie einen Bot mit BotFather und fügen Sie das Token in Alter ein.

Referenz der Gateway-Einstellungen

Alle Gateways teilen diese Felder: Plattformspezifische Verbindung-Felder sind in den Einrichtungsanleitungen dokumentiert: Nach dem Speichern eines aktivierten Gateways zeigt Alter eine Statuszeile wie Verbunden als @username oder einen behebbaren Fehler.

Gateways bei geschlossenem Deckel online halten

Auf einem MacBook legt das Schließen des Deckels den Mac normalerweise in den Ruhezustand und trennt Gateway-Bots. Alter kann aktive Gateways bei geschlossenem Deckel verfügbar halten. Oben auf Einstellungen → Integrationen → Gateways:

Batterieschutz

Alter pausiert die Verfügbarkeit bei geschlossenem Deckel automatisch, um die Akkulaufzeit zu schützen:
  • Pausieren unter — Während der Mac entladen und nicht am Netz ist, stellt Alter den normalen Ruhezustand ab diesem Niveau wieder her (Standard 20%, einstellbar von 5% bis 50% in 5%-Schritten). Verfügbarkeit bei geschlossenem Deckel kehrt nach dem Laden über dem Limit zurück.
  • Im Energiesparmodus pausieren — Wird immer beachtet, solange macOS Low Power Mode aktiv ist.
Das Ausschalten des Hauptschalters behält die installierte Administratorberechtigung, damit Sie sie ohne erneute Abfrage wieder aktivieren können. Verwenden Sie Administratorberechtigung entfernen… in Optionen…, um sie vollständig zu entziehen.
Verfügbarkeit bei geschlossenem Deckel ändert eine geschützte macOS-Ruhezustandseinstellung. Alter führt außerdem einen Sicherheitsmonitor aus, der den normalen Ruhezustand wiederherstellt, wenn die App unerwartet stoppt. Gateways erfordern weiterhin, dass Alter läuft — diese Funktion hält den Mac wach, nicht Alter geschlossen.

Welche Actions funktionieren auf Gateways?

Actions melden sich an für externe Plattformen. Im Action Editor öffnen Sie den Abschnitt Gateways und wählen Verfügbarkeit:
Die mitgelieferte Ask Anything-Aktion ist standardmäßig auf Alle — sie ist die übliche Standardaktion für neue Gateways. Setzen Sie Ask Anything auf Keine, wenn sie nur lokal sein soll. Benutzerdefinierte Aktionen starten auf Keine, bis Sie eine Plattform oder Alle aktivieren.
Unter Einstellungen → Integrations → Gateways zeigt jedes Gateway eine Liste Verfügbare Aktionen für seine Plattform. Damit prüfen Sie, welche Aktionen aktiv sind, und springen direkt zu Action Editor → Gateways für jede gelistete Aktion. Nutzer können pro Unterhaltung weiter mit /new [action] oder dem Choose action-Picker die Aktion wechseln, solange die Aktion auf der Plattform erlaubt ist.

Parameterlose vs. parametrisierte Aktionen

Wenn jemand eine Aktion über Choose action (oder /actions) wählt:
  • Parameterlose Aktionen (keine Eingabefelder im Action Editor) starten sofort — Alter führt die Aktion mit ihrem konfigurierten Prompt aus, wie ein Klick-Start im Hub.
  • Parametrisierte Aktionen (mit Eingabefeldern) starten eine neue Unterhaltung und warten auf die nächste Nachricht, damit der Nutzer die Eingaben liefert.

Chat-Befehle und Steuerung

Discord und Telegram unterstützen dieselben Textbefehle (als normale Nachrichten eingeben). Auf Telegram funktionieren Befehle auch mit Bot-Suffix wie /help@YourBotName. Auf Discord registriert Alter beim Verbinden auch native Slash-Befehle (/help, /new, /actions, /chats, /history, /stop, /status). Wenn Sie eine Server ID setzen, registrieren sich Befehle nur für diesen Server; andernfalls global für die Bot-Anwendung. Beide Plattformen bieten Buttons für häufige Aufgaben — zum Beispiel New chat, Choose action und Past chats bei /help. Telegram nutzt Inline-Tastaturen; Discord nutzt Nachrichtenkomponenten. Wenn eine Action das Ask User-Tool verwendet, stellt Alter Mehrfachauswahlfragen über dieselben interaktiven Steuerelemente bereit (und akzeptiert getippte Antworten für „Other“). Jede Nachricht, die kein Befehl ist, wird als Chat-Zug in der aktuellen Unterhaltung behandelt.

Tägliche Nutzung

  1. Halten Sie Alter auf Ihrem Mac aktiv mit aktiviertem Gateway (Aktiviert). Auf einem MacBook aktivieren Sie Gateways bei geschlossenem Deckel online halten, wenn Bots bei geschlossenem Deckel verbunden bleiben sollen.
  2. Schreiben Sie dem Bot auf Discord oder Telegram (oder @mention auf Discord-Servern, wenn Erwähnung in Servern erfordern aktiv ist).
  3. Alter zeigt Thinking… während die Action läuft und aktualisiert dann mit der gestreamten Antwort. In Telegram-DMs kann Alter über die native Entwurfsvorschau streamen, wenn unterstützt; in Gruppen bearbeitet es stattdessen eine normale Nachricht.
  4. Hängen Sie Dateien in Discord oder Telegram an — Alter lädt sie für den Zug herunter und kann Ausgabedateien von Tools hochladen. Voice messages und audio files werden mit Ihrem gewählten Sprachprozessor (Einstellungen → Voice) transkribiert und als Text an Alter gesendet; längeres Audio wird auch als Meeting-Transkript-Kontext angehängt.
  5. Verwenden Sie /stop, den Stop-Button (Telegram-Gruppen und Discord) oder warten Sie, bis der Zug endet, bevor Sie erneut im selben Kanal oder Chat schreiben.

Eine Antwort gleichzeitig

Alter verarbeitet eine laufende Antwort pro Kanal oder Chat. Kommt eine zweite Nachricht, während Alter noch antwortet, meldet der Bot, dass Alter in diesem Kanal oder Chat bereits antwortet. Warten Sie, bis der aktuelle Zug endet, und senden Sie erneut.

Unterhaltungskontinuität

Jeder Discord-Kanal oder Telegram-Chat kann eine aktive Alter-Unterhaltung haben. Verwenden Sie /new für einen Neustart oder /chats und /use, um eine bestehende Alter-Unterhaltung auf Ihrem Mac fortzusetzen. Auf Discord gibt Serverdiskussionen in Threads starten jeder neuen Top-Level-Servernachricht einen eigenen Thread und Alter-Chat. Antworten in einem bestehenden Thread setzen diesen Chat fort, statt einen neuen zu starten.

Datenschutz und Daten

  • Bot-Tokens werden im macOS Keychain gespeichert, nicht in Klartext-Einstellungsdateien.
  • Gateway-Konfiguration (Namen, Zugriffslisten, Default Actions) wird lokal in Alters Einstellungen auf Ihrem Mac gespeichert.
  • Kanalstatus (ausgewählte Unterhaltung, ausstehende Action) liegt im Application-Support-Ordner von Alter.
  • Die Nachrichtenverarbeitung nutzt denselben lokalen Alter-Stack wie der Hub — es gibt kein separates Cloud-Relay für Gateway-Traffic.
Siehe auch Lokale Daten und Datenschutz.

Fehlerbehebung

Verbindung und Tokens

Nutzung

Verfügbarkeit bei geschlossenem Deckel

Plattformhinweise

  • Alter muss laufen — beim Schließen von Alter stoppen Gateway-Bots, bis Sie die App wieder öffnen. Auf einem MacBook hält Gateways bei geschlossenem Deckel online halten den Mac wach, während Gateways laufen, aber Alter muss geöffnet bleiben.
  • Bot-Nachrichten werden ignoriert auf beiden Plattformen.
  • Discord fügt 👀 während der Verarbeitung hinzu, dann ✅ oder ❌ am Zugende. Nutzer-Reaktionen gelten nicht als Befehle oder Chat-Eingabe.
  • Telegram nutzt Long Polling für message- und callback_query-Updates (Inline-Tastatur-Taps). Nach einem Zug kann Alter mit 👍 oder 👎 auf Ihre Nachricht reagieren. Gruppenchats zeigen während aktiver Züge einen Stop-Button.
Für breitere Tool- und Berechtigungsprobleme Einstellungen → Doctor oder Tools not working verwenden.

Verwandte Seiten