Twitch

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

Installation

Twitch wird als offizielles Plugin bereitgestellt 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; legen Sie nur für reproduzierbare Installationen eine genaue Version fest. 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 im Besitz des Gateways.
• Deterministisches Routing: Antworten gehen immer an den Twitch-Kanal zurück, aus dem die Nachricht stammt.
• Jeder beigetretene Kanal wird einem isolierten Gruppensitzungsschlüssel agent:<agentId>:twitch:group:<channel> zugeordnet.
• username ist das Konto des Bots (das sich authentifiziert), channel ist der Chatraum, dem beigetreten wird. Jeder Kontoeintrag tritt genau einem Kanal bei.
• Tokens funktionieren mit oder ohne Präfix oauth:; OpenClaw normalisiert beide Formen (der Einrichtungsassistent erwartet die Form mit oauth:).

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 eine 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 Werte gesetzt sind, verwendet das Plugin einen aktualisierenden Authentifizierungs-Provider, der Tokens vor ihrem Ablauf erneuert und jede Aktualisierung protokolliert. Ohne refreshToken wird token refresh disabled (no refresh token) protokolliert; ohne clientSecret wird auf ein statisches (nicht aktualisierendes) Token zurückgegriffen.

Unterstützung mehrerer Konten

Verwenden Sie channels.twitch.accounts mit kontospezifischen Anmeldedaten. 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 feste Zulassungsliste von Twitch-Benutzer-IDs. Wenn sie gesetzt ist, wird allowedRoles ignoriert; lassen Sie allowFrom ungesetzt, 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

Using env token source for mybotAccess token refreshed for user 123456 (expires in 14400s)

Konfiguration

Kontokonfiguration

Provider-Optionen

• channels.twitch.enabled – Start des Kanals 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 – Kontoname, der als Standard verwendet wird
• 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: "Hello Twitch!",}

to ist optional und verwendet standardmäßig den für das Konto konfigurierten channel.

Sicherheit und Betrieb

• Behandeln Sie Tokens wie Passwörter – übertragen 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 Token-Aktualisierungsereignisse und den Verbindungsstatus.
• Beschränken Sie die Token-Berechtigungen auf das Minimum – fordern Sie nur chat:read und chat:write an.
• Wenn Sie nicht weiterkommen: Starten Sie das Gateway neu, nachdem Sie sich vergewissert haben, dass kein anderer Prozess die Sitzung besitzt.

Beschränkungen

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

Verwandte Themen

• Kanal-Routing — Sitzungs-Routing für Nachrichten
• Kanalübersicht — alle unterstützten Kanäle
• Gruppen — Gruppenchat-Verhalten und Erwähnungssperre
• Kopplung — DM-Authentifizierung und Kopplungsablauf
• Sicherheit — Zugriffsmodell und Absicherung