Twitch

​

Instalacja

openclaw plugins install @openclaw/twitch

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

​

Szybka konfiguracja

openclaw gateway run

{
  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)

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

​

Obsługa wielu kont

{
  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

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

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

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

​

Rozwiązywanie problemów

openclaw doctor
openclaw channels status --probe

Using env token source for mybot
Access 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)

{
  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

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

​

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ń