Skip to content

Channels: Twitch

Twitch is a Tier 3 channel. Wayland joins Twitch chat as a bot account. At minimum you need a bot username, an OAuth token, and the channels to join. Automatic token renewal is optional and adds a few more fields.

Before you start (prerequisites and accounts)

Section titled “Before you start (prerequisites and accounts)”
  • A Twitch account to use as the bot.
  • The Wayland desktop app running with a model provider connected.
  • Optional, only for automatic token renewal: a registered Twitch application.

Create the credentials (on the provider side)

Section titled “Create the credentials (on the provider side)”
  1. Pick the Twitch account to act as the bot and note its Bot username.
  2. Obtain an OAuth token for that account.
  3. Decide which channels the bot should join.
  4. Optional, for automatic token renewal: register a Twitch application, note its Client ID and Client secret, and obtain a Refresh token.

Connect it in Wayland (Settings -> Channels -> Twitch)

Section titled “Connect it in Wayland (Settings -> Channels -> Twitch)”
  1. Open Settings -> Channels and choose Twitch.
  2. Enter the Bot username.
  3. Paste the OAuth token.
  4. Enter the Channels to join.
  5. Optional: open Advanced: token refresh and enter the Client ID, Client secret, and Refresh token together to let the token renew on its own.
  6. Save.

Verify (status goes from idle to connected, send a test message)

Section titled “Verify (status goes from idle to connected, send a test message)”

After saving, the status moves from idle to connected. Post a message in a joined channel and confirm a reply.

Set the assistant and default model on the Twitch page. Inbound chat messages route to that assistant.

An expired OAuth token is the usual cause of failures; provide a refresh token so it renews, or reauthorize the bot. See Channel Connection Issues.