Twitch

Obsługa czatu Twitch przez połączenie IRC. OpenClaw łączy się jako użytkownik Twitch (konto bota), aby odbierać i wysyłać wiadomości na kanałach.

Plugin dołączony do pakietu

Twitch jest dostarczany jako plugin dołączony do pakietu w aktualnych wydaniach OpenClaw, więc zwykłe spakowane buildy nie wymagają osobnej instalacji. Jeśli używasz starszego buildu lub niestandardowej instalacji, która nie zawiera Twitch, zainstaluj go ręcznie: Instalacja przez CLI (rejestr npm):

openclaw plugins install @openclaw/twitch

Lokalny checkout (podczas uruchamiania z repozytorium git):

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

Szczegóły: Plugins

Szybka konfiguracja (dla początkujących)

Upewnij się, że plugin Twitch jest dostępny.
- Aktualne spakowane wydania OpenClaw już go zawierają.
- W starszych/niestandardowych instalacjach można dodać go ręcznie za pomocą powyższych poleceń.
Utwórz dedykowane konto Twitch dla bota (lub użyj istniejącego konta).
Wygeneruj dane uwierzytelniające: Twitch Token Generator
- Wybierz Bot Token
- Sprawdź, czy zaznaczone są zakresy chat:read i chat:write
- Skopiuj Client ID i Access Token
Znajdź swój identyfikator użytkownika Twitch: https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
Skonfiguruj token:
- Zmienna środowiskowa: OPENCLAW_TWITCH_ACCESS_TOKEN=... (tylko konto domyślne)
- Albo konfiguracja: channels.twitch.accessToken
- Jeśli ustawione są oba, konfiguracja ma pierwszeństwo (fallback do zmiennej środowiskowej działa tylko dla konta domyślnego).
Uruchom gateway.

⚠️ Ważne: Dodaj kontrolę dostępu (allowFrom lub allowedRoles), aby zapobiec wyzwalaniu bota przez nieautoryzowanych użytkowników. requireMention domyślnie ma wartość true. Minimalna konfiguracja:

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Konto Twitch bota
      accessToken: "oauth:abc123...", // OAuth Access Token (lub użyj zmiennej środowiskowej OPENCLAW_TWITCH_ACCESS_TOKEN)
      clientId: "xyz789...", // Client ID z Token Generator
      channel: "vevisk", // Do którego czatu kanału Twitch dołączyć (wymagane)
      allowFrom: ["123456789"], // (zalecane) tylko Twój identyfikator użytkownika Twitch — pobierz go z https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
    },
  },
}

Czym to jest

Kanał Twitch należący do Gateway.
Deterministyczny routing: odpowiedzi zawsze wracają do Twitch.
Każde konto mapuje się na izolowany klucz sesji agent:<agentId>:twitch:<accountName>.
username to konto bota (które się uwierzytelnia), a channel określa, do którego pokoju czatu dołączyć.

Konfiguracja (szczegółowo)

Generowanie danych uwierzytelniających

Użyj Twitch Token Generator:

Wybierz Bot Token
Sprawdź, czy zaznaczone są zakresy chat:read i chat:write
Skopiuj Client ID i Access Token

Nie jest wymagana ręczna rejestracja aplikacji. Tokeny wygasają po kilku godzinach.

Konfiguracja bota

Zmienna środowiskowa (tylko konto domyślne):

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

Albo konfiguracja:

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
    },
  },
}

Jeśli ustawione są zarówno zmienna środowiskowa, jak i konfiguracja, konfiguracja ma pierwszeństwo.

Kontrola dostępu (zalecane)

{
  channels: {
    twitch: {
      allowFrom: ["123456789"], // (zalecane) tylko Twój identyfikator użytkownika Twitch
    },
  },
}

Preferuj allowFrom dla twardej listy dozwolonych. Zamiast tego użyj allowedRoles, jeśli chcesz dostępu opartego na rolach. Dostępne role: "moderator", "owner", "vip", "subscriber", "all". Dlaczego identyfikatory użytkowników? Nazwy użytkowników mogą się zmieniać, co umożliwia podszywanie się. Identyfikatory użytkowników są stałe. Znajdź swój identyfikator użytkownika Twitch: https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/ (Convert your Twitch username to ID)

Odświeżanie tokena (opcjonalne)

Tokenów z Twitch Token Generator nie można odświeżać automatycznie — wygeneruj je ponownie po wygaśnięciu. Aby automatycznie odświeżać token, utwórz własną aplikację Twitch w Twitch Developer Console i dodaj do konfiguracji:

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

Bot automatycznie odświeża tokeny przed wygaśnięciem i zapisuje zdarzenia odświeżenia w logach.

Obsługa wielu kont

Użyj channels.twitch.accounts z tokenami per konto. Wspólny wzorzec opisano w gateway/configuration. Przykład (jedno konto bota na dwóch kanałach):

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

Uwaga: Każde konto potrzebuje własnego tokena (jeden token na kanał).

Kontrola dostępu

Ograniczenia oparte na rolach

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

Lista dozwolonych według identyfikatora użytkownika (najbezpieczniejsze)

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

Dostęp oparty na rolach (alternatywa)

allowFrom to twarda lista dozwolonych. Gdy jest ustawione, dozwolone są tylko te identyfikatory użytkowników. Jeśli chcesz dostępu opartego na rolach, pozostaw allowFrom nieustawione i zamiast tego skonfiguruj allowedRoles:

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

Wyłączenie wymagania @mention

Domyślnie requireMention ma wartość true. Aby to wyłączyć i odpowiadać na wszystkie wiadomości:

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

Rozwiązywanie problemów

Najpierw uruchom polecenia diagnostyczne:

openclaw doctor
openclaw channels status --probe

Bot nie odpowiada na wiadomości

Sprawdź kontrolę dostępu: Upewnij się, że Twój identyfikator użytkownika jest w allowFrom, albo tymczasowo usuń allowFrom i ustaw allowedRoles: ["all"], aby przetestować. Sprawdź, czy bot jest na kanale: Bot musi dołączyć do kanału określonego w channel.

Problemy z tokenem

„Failed to connect” lub błędy uwierzytelniania:

Sprawdź, czy accessToken jest wartością tokena dostępu OAuth (zwykle zaczyna się od prefiksu oauth:)
Sprawdź, czy token ma zakresy chat:read i chat:write
Jeśli używasz odświeżania tokena, sprawdź, czy ustawione są clientSecret i refreshToken

Odświeżanie tokena nie działa

Sprawdź logi pod kątem zdarzeń odświeżania:

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

Jeśli widzisz „token refresh disabled (no refresh token)”:

Upewnij się, że podano clientSecret
Upewnij się, że podano refreshToken

Konfiguracja

Konfiguracja konta:

username - nazwa użytkownika bota
accessToken - token dostępu OAuth z zakresami chat:read i chat:write
clientId - Twitch Client ID (z Token Generator lub z Twojej aplikacji)
channel - kanał, do którego należy dołączyć (wymagane)
enabled - włącza to konto (domyślnie: true)
clientSecret - opcjonalne: do automatycznego odświeżania tokena
refreshToken - opcjonalne: do automatycznego odświeżania tokena
expiresIn - czas wygaśnięcia tokena w sekundach
obtainmentTimestamp - znacznik czasu uzyskania tokena
allowFrom - lista dozwolonych identyfikatorów użytkowników
allowedRoles - kontrola dostępu oparta na rolach ("moderator" | "owner" | "vip" | "subscriber" | "all")
requireMention - wymaga @mention (domyślnie: true)

Opcje providera:

channels.twitch.enabled - włączanie/wyłączanie uruchamiania kanału
channels.twitch.username - nazwa użytkownika bota (uproszczona konfiguracja jednego konta)
channels.twitch.accessToken - token dostępu OAuth (uproszczona konfiguracja jednego konta)
channels.twitch.clientId - Twitch Client ID (uproszczona konfiguracja jednego konta)
channels.twitch.channel - kanał, do którego należy dołączyć (uproszczona konfiguracja jednego konta)
channels.twitch.accounts.<accountName> - konfiguracja wielu kont (wszystkie pola konta powyżej)

Pełny przykład:

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

Akcje narzędzia

Agent może wywołać twitch z akcją:

send - wyślij wiadomość na kanał

Przykład:

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

Bezpieczeństwo i operacje

Traktuj tokeny jak hasła - nigdy nie zapisuj tokenów w git
Używaj automatycznego odświeżania tokena dla długotrwale działających botów
Używaj list dozwolonych opartych na identyfikatorach użytkowników zamiast nazw użytkowników do kontroli dostępu
Monitoruj logi pod kątem zdarzeń odświeżania tokena i stanu połączenia
Minimalizuj zakresy tokenów - żądaj tylko chat:read i chat:write
Jeśli utkniesz: uruchom ponownie gateway po potwierdzeniu, że żaden inny proces nie jest właścicielem sesji

Limity

500 znaków na wiadomość (automatyczny podział na fragmenty na granicach słów)
Markdown jest usuwany przed podziałem na fragmenty
Brak ograniczania szybkości (wykorzystywane są wbudowane limity szybkości Twitch)

Powiązane

Channels Overview — wszystkie obsługiwane kanały
Pairing — uwierzytelnianie wiadomości prywatnych i przepływ parowania
Groups — zachowanie czatów grupowych i bramkowanie wzmianką
Channel Routing — routing sesji dla wiadomości
Security — model dostępu i utwardzanie

Overview

Messaging platforms

Configuration

Twitch

Twitch

Plugin dołączony do pakietu

Szybka konfiguracja (dla początkujących)

Czym to jest

Konfiguracja (szczegółowo)

Generowanie danych uwierzytelniających

Konfiguracja bota

Kontrola dostępu (zalecane)

Odświeżanie tokena (opcjonalne)

Obsługa wielu kont

Kontrola dostępu

Ograniczenia oparte na rolach

Lista dozwolonych według identyfikatora użytkownika (najbezpieczniejsze)

Dostęp oparty na rolach (alternatywa)

Wyłączenie wymagania @mention

Rozwiązywanie problemów

Bot nie odpowiada na wiadomości

Problemy z tokenem

Odświeżanie tokena nie działa

Konfiguracja

Akcje narzędzia

Bezpieczeństwo i operacje

Limity

Powiązane

Overview

Messaging platforms

Configuration

​Twitch

​Plugin dołączony do pakietu

​Szybka konfiguracja (dla początkujących)

​Czym to jest

​Konfiguracja (szczegółowo)

​Generowanie danych uwierzytelniających

​Konfiguracja bota

​Kontrola dostępu (zalecane)

​Odświeżanie tokena (opcjonalne)

​Obsługa wielu kont

​Kontrola dostępu

​Ograniczenia oparte na rolach

​Lista dozwolonych według identyfikatora użytkownika (najbezpieczniejsze)

​Dostęp oparty na rolach (alternatywa)

​Wyłączenie wymagania @mention

​Rozwiązywanie problemów

​Bot nie odpowiada na wiadomości

​Problemy z tokenem

​Odświeżanie tokena nie działa

​Konfiguracja

​Akcje narzędzia

​Bezpieczeństwo i operacje

​Limity

​Powiązane

Twitch

Plugin dołączony do pakietu

Szybka konfiguracja (dla początkujących)

Czym to jest

Konfiguracja (szczegółowo)

Generowanie danych uwierzytelniających

Konfiguracja bota

Kontrola dostępu (zalecane)

Odświeżanie tokena (opcjonalne)

Obsługa wielu kont

Kontrola dostępu

Ograniczenia oparte na rolach

Lista dozwolonych według identyfikatora użytkownika (najbezpieczniejsze)

Dostęp oparty na rolach (alternatywa)

Wyłączenie wymagania @mention

Rozwiązywanie problemów

Bot nie odpowiada na wiadomości

Problemy z tokenem

Odświeżanie tokena nie działa

Konfiguracja

Akcje narzędzia

Bezpieczeństwo i operacje

Limity

Powiązane