Twitch

Twitch-Chat-Unterstützung über die Chat-Schnittstelle (IRC) von Twitch mithilfe des Twurple-Clients. OpenClaw meldet sich mit einem Twitch-Bot-Konto an, tritt pro konfiguriertem Konto einem Kanal bei und antwortet in diesem Kanal.

Installation

Twitch wird als offizielles Plugin ausgeliefert und ist nicht Teil der Kerninstallation.

openclaw plugins install @openclaw/twitch

openclaw plugins install ./path/to/local/twitch-plugin

plugins install registriert und aktiviert das Plugin. Wenn Sie Twitch während openclaw onboard oder openclaw channels add auswählen, wird es bei Bedarf installiert. Verwenden Sie den reinen Paketnamen, um der aktuellen Version zu folgen; pinnen Sie eine exakte Version nur für reproduzierbare Installationen. Erfordert OpenClaw 2026.4.10 oder neuer.

Details: Plugins

Schnelleinrichtung

openclaw gateway run

Minimale Konfiguration:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // Twitch-Konto des Bots (authentifiziert sich)      accessToken: "oauth:abc123...", // OAuth-Zugriffstoken (oder Umgebungsvariable OPENCLAW_TWITCH_ACCESS_TOKEN verwenden)      clientId: "xyz789...", // Client-ID aus dem Token Generator      channel: "yourchannel", // Chat des Twitch-Kanals, dem beigetreten werden soll (erforderlich)      allowFrom: ["123456789"], // (empfohlen) Nur Ihre Twitch-Benutzer-ID    },  },}

Funktionsweise

• Ein Twitch-Kanal, dessen Eigentümer das Gateway ist.
• Deterministisches Routing: Antworten gehen immer an den Twitch-Kanal zurück, aus dem die Nachricht stammt.
• Jeder Kanal, dem beigetreten wurde, wird einem isolierten Gruppensitzungsschlüssel agent:<agentId>:twitch:group:<channel> zugeordnet.
• username ist das Konto des Bots (das sich authentifiziert), channel gibt an, welchem Chatraum beigetreten wird. Jeder Kontoeintrag tritt genau einem Kanal bei.
• Tokens funktionieren mit oder ohne das Präfix oauth:; OpenClaw normalisiert beide Varianten (der Einrichtungsassistent erwartet die Form oauth:).

Dauerhafte Verarbeitung eingehender Nachrichten

OpenClaw stellt jede akzeptierte Twitch-Chatnachricht dauerhaft in eine Warteschlange, bevor sie regulär weitergeleitet wird. Ausstehende oder erneut zustellbare Nachrichten überstehen einen Neustart des Gateways, bleiben für den konfigurierten Kanal serialisiert und verwenden die Nachrichten-ID von Twitch, um doppelte Warteschlangeneinträge zu unterdrücken, solange der aktive oder aufbewahrte Abschlussdatensatz vorhanden ist.

Twitch Chat spielt eine PRIVMSG nicht erneut ab, nachdem der Client sie akzeptiert hat. Dies schützt das lokale Absturzfenster zwischen Annahme und Weiterleitung, kann jedoch keine Nachrichten wiederherstellen, die vor der dauerhaften Aufnahme verpasst wurden. Wenn das Anhängen an die Warteschlange selbst fehlschlägt, protokolliert OpenClaw den Fehler; eine erneute Verbindung veranlasst Twitch nicht dazu, diese Nachricht erneut zu senden.

Token-Aktualisierung (optional)

Tokens vom Twitch Token Generator können von OpenClaw nicht aktualisiert werden – generieren Sie sie nach Ablauf neu (sie sind einige Stunden gültig; keine App-Registrierung erforderlich).

Erstellen Sie für die automatische Aktualisierung Ihre eigene App in der Twitch Developer Console und fügen Sie Folgendes hinzu:

{  channels: {    twitch: {      clientSecret: "your_client_secret",      refreshToken: "your_refresh_token",    },  },}

Wenn beide festgelegt sind, verwendet das Plugin einen aktualisierenden Authentifizierungs-Provider, der Tokens vor Ablauf erneuert und jede Aktualisierung protokolliert. Ohne refreshToken protokolliert es token refresh disabled (no refresh token); ohne clientSecret greift es auf ein statisches (nicht aktualisierendes) Token zurück.

Unterstützung mehrerer Konten

Verwenden Sie channels.twitch.accounts mit Anmeldedaten pro Konto. Das gemeinsame Muster finden Sie unter Konfiguration.

Beispiel (ein Bot-Konto in zwei Kanälen):

{  channels: {    twitch: {      accounts: {        channel1: {          username: "openclaw",          accessToken: "oauth:abc123...",          clientId: "xyz789...",          channel: "yourchannel",        },        channel2: {          username: "openclaw",          accessToken: "oauth:def456...",          clientId: "uvw012...",          channel: "secondchannel",        },      },    },  },}

Zugriffskontrolle

allowFrom ist eine strikte Zulassungsliste von Twitch-Benutzer-IDs. Wenn sie festgelegt ist, wird allowedRoles ignoriert; lassen Sie allowFrom nicht festgelegt, um stattdessen rollenbasierten Zugriff zu verwenden.

Verfügbare Rollen: "moderator", "owner", "vip", "subscriber", "all".

{  channels: {    twitch: {      accounts: {        default: {          allowFrom: ["123456789", "987654321"],        },      },    },  },}

{  channels: {    twitch: {      accounts: {        default: {          allowedRoles: ["moderator", "vip"],        },      },    },  },}

{  channels: {    twitch: {      accounts: {        default: {          requireMention: false,        },      },    },  },}

Fehlerbehebung

Führen Sie zunächst Diagnosebefehle aus:

openclaw doctoropenclaw channels status --probe

Umgebungs-Tokenquelle für mybot wird verwendetZugriffstoken für Benutzer 123456 aktualisiert (läuft in 14400s ab)

Konfiguration

Kontokonfiguration

Provider-Optionen

• channels.twitch.enabled – Kanalstart aktivieren/deaktivieren
• channels.twitch.username / accessToken / clientId / channel – Vereinfachte Einzelkontokonfiguration (implizites Konto default; hat Vorrang vor accounts.default)
• channels.twitch.accounts.<accountName> – Mehrkontenkonfiguration (alle oben aufgeführten Kontofelder)
• channels.twitch.defaultAccount – Name des Standardkontos
• channels.twitch.markdown.tables – Darstellungsmodus für Markdown-Tabellen (off | bullets | code | block)

Vollständiges Beispiel:

{  channels: {    twitch: {      enabled: true,      username: "openclaw",      accessToken: "oauth:abc123...",      clientId: "xyz789...",      channel: "yourchannel",      clientSecret: "secret123...",      refreshToken: "refresh456...",      allowFrom: ["123456789"],      accounts: {        second: {          username: "mybot",          accessToken: "oauth:def456...",          clientId: "uvw012...",          channel: "your_channel",          enabled: true,          expiresIn: 14400,          obtainmentTimestamp: 1706092800000,          allowedRoles: ["moderator"],        },      },    },  },}

Tool-Aktionen

Der Agent kann Twitch-Nachrichten über die Aktion send des Nachrichten-Tools senden:

{  channel: "twitch",  action: "send",  to: "#mychannel",  message: "Hallo Twitch!",}

to ist optional und verwendet standardmäßig den konfigurierten Wert channel des Kontos.

Sicherheit und Betrieb

• Behandeln Sie Tokens wie Passwörter – committen Sie Tokens niemals in Git.
• Verwenden Sie die automatische Token-Aktualisierung für dauerhaft laufende Bots.
• Verwenden Sie Zulassungslisten mit Benutzer-IDs anstelle von Benutzernamen für die Zugriffskontrolle.
• Überwachen Sie die Protokolle auf Ereignisse zur Token-Aktualisierung und den Verbindungsstatus.
• Beschränken Sie den Token-Umfang auf das Minimum – fordern Sie nur chat:read und chat:write an.
• Falls Sie nicht weiterkommen: Starten Sie den Gateway neu, nachdem Sie sich vergewissert haben, dass kein anderer Prozess die Sitzung verwendet.

Beschränkungen

• 500 Zeichen pro Nachricht; längere Antworten werden an Wortgrenzen aufgeteilt.
• Markdown wird vor dem Senden entfernt (der Twitch-Chat verwendet reinen Text; Zeilenumbrüche werden zu Leerzeichen).
• OpenClaw fügt keine eigene Ratenbegrenzung hinzu; der Twurple-Chat-Client verarbeitet die Twitch-Ratenbegrenzungen.

Verwandte Themen

• Kanal-Routing — Sitzungs-Routing für Nachrichten
• Kanalübersicht — alle unterstützten Kanäle
• Gruppen — Verhalten von Gruppenchats und erwähnungsbasierte Zugriffssteuerung
• Kopplung — DM-Authentifizierung und Kopplungsablauf
• Sicherheit — Zugriffsmodell und Härtung