Twitch

​

Installation

openclaw plugins install @openclaw/twitch

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

​

Schnelleinrichtung

openclaw gateway run

{
  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

​

Token-Aktualisierung (optional)

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

​

Unterstützung mehrerer Konten

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

​

Zugriffskontrolle

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

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

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

​

Fehlerbehebung

openclaw doctor
openclaw channels status --probe

Umgebungs-Tokenquelle für mybot wird verwendet
Zugriffstoken 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)

{
  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

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

​

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