How to Connect OpenClaw to Twitch

Prerequisites

• ✓An existing OpenClaw gateway installation with access to edit its config and restart the process.
• ✓A Twitch account to act as the bot (you can create a dedicated Twitch account for the bot or use an existing account).
• ✓Access to Twitch Token Generator at https://twitchtokengenerator.com/ to create a Bot Token with `chat:read` and `chat:write` scopes.
• ✓Your Twitch user ID, which you can get from https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/.

Steps

1. 1

   Ensure the Twitch plugin is available

   First confirm that the Twitch channel plugin is present so OpenClaw can speak IRC to Twitch. Current packaged OpenClaw releases already bundle it, but older or custom builds may need a manual install from npm or a local checkout.

   bashCopy

   openclaw plugins install @openclaw/twitch

2. 2

   Install the Twitch plugin from a local checkout (optional)

   If you run OpenClaw from a git repo and keep the Twitch plugin locally, install it via the filesystem path instead of npm. This is useful when you customize the plugin or track it alongside your gateway code.

   bashCopy

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

3. 3

   Generate a Twitch bot token and client ID

   Create the credentials that OpenClaw uses to authenticate as your Twitch bot account. Use Twitch Token Generator to create a Bot Token with the correct scopes, then copy both the Client ID and the OAuth Access Token for later config.

   textCopy

   Use Twitch Token Generator (https://twitchtokengenerator.com/):
   *   Select **Bot Token**
   *   Verify scopes `chat:read` and `chat:write` are selected
   *   Copy the **Client ID** and **Access Token**

4. 4

   Configure the Twitch access token via environment variable

   For a single default Twitch account, you can inject the OAuth token through an environment variable. This keeps secrets out of your config file and is enough to get a basic bot online.

   bashCopy

   OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

5. 5

   Configure the Twitch channel in the OpenClaw config

   Define the Twitch channel settings in your OpenClaw config so the gateway knows which bot account to log in as and which channel to join. This config also wires in the access token and client ID you generated earlier.

   jsonCopy

   {
     channels: {
       twitch: {
         enabled: true,
         username: "openclaw", // Bot's Twitch account
         accessToken: "oauth:abc123...", // OAuth Access Token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)
         clientId: "xyz789...", // Client ID from Token Generator
         channel: "vevisk", // Which Twitch channel's chat to join (required)
         allowFrom: ["123456789"], // (recommended) Your Twitch user ID only - get it from https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
       },
     },
   }

6. 6

   Lock down access with allowFrom or allowedRoles

   Restrict who can trigger your Twitch bot so random viewers cannot spam your agent. The most secure option is an allowlist of Twitch user IDs, but you can also grant access by role if you prefer moderators or VIPs only.

   jsonCopy

   {
     channels: {
       twitch: {
         allowFrom: ["123456789"], // (recommended) Your Twitch user ID only
       },
     },
   }

7. 7

   Enable multi-account or multi-channel Twitch bots (optional)

   accounts`. Each account needs its own token, even if they share the same username.

   jsonCopy

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

8. 8

   Start the gateway and verify Twitch connectivity

   With the plugin installed and config in place, start or restart your OpenClaw gateway so it connects to Twitch IRC. Use the built-in diagnostics to confirm the Twitch channel is healthy and responding.

   bashCopy

   openclaw doctor
   openclaw channels status --probe

Configuration

Troubleshooting

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

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

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

openclaw doctor
openclaw channels status --probe

Frequently asked questions