Twitch

Obsługa czatu Twitch za pośrednictwem interfejsu czatu Twitch (IRC) przy użyciu klienta Twurple. OpenClaw loguje się jako konto bota Twitch, dołącza do jednego kanału na każde skonfigurowane konto i odpowiada na tym kanale.

Instalacja

Twitch jest dostarczany jako oficjalny plugin; nie jest częścią podstawowej instalacji.

openclaw plugins install @openclaw/twitch

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

Polecenie plugins install rejestruje i włącza plugin. Wybranie Twitch podczas wykonywania openclaw onboard lub openclaw channels add instaluje go na żądanie. Użyj samej nazwy pakietu, aby korzystać z bieżącego wydania; przypnij dokładną wersję tylko w celu zapewnienia powtarzalności instalacji. Wymaga OpenClaw 2026.4.10 lub nowszego.

Szczegóły: Pluginy

Szybka konfiguracja

openclaw gateway run

Minimalna konfiguracja:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // Konto Twitch bota (uwierzytelnia się)      accessToken: "oauth:abc123...", // Token dostępu OAuth (lub użyj zmiennej środowiskowej OPENCLAW_TWITCH_ACCESS_TOKEN)      clientId: "xyz789...", // Identyfikator klienta z Generatora tokenów      channel: "yourchannel", // Do czatu którego kanału Twitch dołączyć (wymagane)      allowFrom: ["123456789"], // (zalecane) Tylko Twój identyfikator użytkownika Twitch    },  },}

Czym jest

• Kanał Twitch zarządzany przez Gateway.
• Deterministyczne trasowanie: odpowiedzi zawsze wracają na kanał Twitch, z którego pochodzi wiadomość.
• Każdy kanał, do którego dołączono, jest mapowany na izolowany klucz sesji grupowej agent:<agentId>:twitch:group:<channel>.
• username to konto bota (które się uwierzytelnia), a channel określa pokój czatu, do którego należy dołączyć. Jeden wpis konta dołącza dokładnie do jednego kanału.
• Tokeny działają z prefiksem oauth: lub bez niego; OpenClaw normalizuje obie formy (kreator konfiguracji oczekuje formy oauth:).

Odświeżanie tokenu (opcjonalne)

Tokeny z Generatora tokenów Twitch nie mogą być odświeżane przez OpenClaw — po wygaśnięciu należy wygenerować je ponownie (są ważne przez kilka godzin; rejestracja aplikacji nie jest wymagana).

Aby włączyć automatyczne odświeżanie, utwórz własną aplikację w Konsoli deweloperskiej Twitch i dodaj:

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

Gdy ustawiono obie wartości, plugin używa dostawcy uwierzytelniania z odświeżaniem, który odnawia tokeny przed wygaśnięciem i rejestruje każde odświeżenie w dzienniku. Bez refreshToken rejestruje token refresh disabled (no refresh token); bez clientSecret przełącza się na statyczny token (bez odświeżania).

Obsługa wielu kont

Użyj channels.twitch.accounts z osobnymi danymi uwierzytelniającymi dla każdego konta. Wspólny wzorzec opisano w sekcji Konfiguracja.

Przykład (jedno konto bota na dwóch kanałach):

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

Kontrola dostępu

allowFrom jest bezwzględną listą dozwolonych identyfikatorów użytkowników Twitch. Gdy jest ustawiona, allowedRoles jest ignorowane; pozostaw allowFrom bez ustawienia, aby zamiast tego używać dostępu opartego na rolach.

Dostępne role: "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,        },      },    },  },}

Rozwiązywanie problemów

Najpierw uruchom polecenia diagnostyczne:

openclaw doctoropenclaw channels status --probe

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

Konfiguracja

Konfiguracja konta

Opcje dostawcy

• channels.twitch.enabled — Włączenie/wyłączenie uruchamiania kanału
• channels.twitch.username / accessToken / clientId / channel — Uproszczona konfiguracja pojedynczego konta (niejawne konto default; ma pierwszeństwo przed accounts.default)
• channels.twitch.accounts.<accountName> — Konfiguracja wielu kont (wszystkie pola konta wymienione powyżej)
• channels.twitch.defaultAccount — Nazwa konta domyślnego
• channels.twitch.markdown.tables — Tryb renderowania tabel Markdown (off | bullets | code | block)

Pełny przykład:

{  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"],        },      },    },  },}

Akcje narzędzia

Agent może wysyłać wiadomości Twitch za pośrednictwem narzędzia wiadomości przy użyciu akcji send:

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

to jest opcjonalne i domyślnie przyjmuje wartość channel skonfigurowaną dla konta.

Bezpieczeństwo i eksploatacja

• Traktuj tokeny jak hasła — nigdy nie zatwierdzaj tokenów w git.
• Używaj automatycznego odświeżania tokenów w przypadku długo działających botów.
• Używaj list dozwolonych identyfikatorów użytkowników zamiast nazw użytkowników do kontroli dostępu.
• Monitoruj dzienniki pod kątem zdarzeń odświeżania tokenów i stanu połączenia.
• Minimalizuj zakresy tokenów — żądaj tylko chat:read i chat:write.
• W razie problemów: uruchom ponownie Gateway po potwierdzeniu, że żaden inny proces nie jest właścicielem sesji.

Ograniczenia

• 500 znaków na wiadomość; dłuższe odpowiedzi są dzielone na granicach słów.
• Markdown jest usuwany przed wysłaniem (czat Twitch używa zwykłego tekstu; znaki nowego wiersza są zastępowane spacjami).
• OpenClaw nie dodaje własnego ograniczania częstotliwości; klient czatu Twurple obsługuje limity częstotliwości Twitch.

Powiązane

• Trasowanie kanałów — trasowanie sesji dla wiadomości
• Przegląd kanałów — wszystkie obsługiwane kanały
• Grupy — zachowanie czatu grupowego i wymóg wzmianki
• Parowanie — uwierzytelnianie w wiadomościach prywatnych i proces parowania
• Bezpieczeństwo — model dostępu i wzmacnianie zabezpieczeń