Twitch

OpenClaw Twitch channel plugin

openclaw plugins install clawhub:@openclaw/twitch

{
  "builtWithOpenClawVersion": "2026.3.22",
  "minGatewayVersion": ">=2026.3.22",
  "pluginApiRange": ">=2026.3.22"
}

{
  "bundledSkills": [],
  "capabilityTags": [
    "executes-code",
    "channel:twitch"
  ],
  "channels": [
    "twitch"
  ],
  "commandNames": [],
  "configSchema": true,
  "configUiHints": false,
  "executesCode": true,
  "hooks": [],
  "httpRouteCount": 0,
  "materializesDependencies": false,
  "providers": [],
  "runtimeId": "twitch",
  "serviceNames": [],
  "setupEntry": false,
  "toolNames": []
}

{
  "hasProvenance": false,
  "scanStatus": "not-run",
  "scope": "artifact-only",
  "sourceCommit": "c4420c03243bd691dc809cd4298bd744cb58d286",
  "sourceRepo": "openclaw/openclaw",
  "sourceTag": "refs/heads/main",
  "summary": "Validated package structure and linked the release to source metadata.",
  "tier": "source-linked"
}

{
  "latest": "2026.3.22"
}

@openclaw/twitch

Twitch channel plugin for OpenClaw.

Install (local checkout)

openclaw plugins install ./extensions/twitch

Install (npm)

openclaw plugins install @openclaw/twitch

Onboarding: select Twitch and confirm the install prompt to fetch the plugin automatically.

Config

Minimal config (simplified single-account):

⚠️ Important: requireMention defaults to true. Add access control (allowFrom or allowedRoles) to prevent unauthorized users from triggering the bot.

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...", // OAuth Access Token (add oauth: prefix)
      clientId: "xyz789...", // Client ID from Token Generator
      channel: "vevisk", // Channel to join (required)
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only (Convert your twitch username to ID at https://www.streamweasels.com/tools/convert-twitch-username-%20to-user-id/)
    },
  },
}

Access control options:

• requireMention: false - Disable the default mention requirement to respond to all messages
• allowFrom: ["your_user_id"] - Restrict to your Twitch user ID only (find your ID at https://www.twitchangles.com/xqc or similar)
• allowedRoles: ["moderator", "vip", "subscriber"] - Restrict to specific roles

Multi-account config (advanced):

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

Setup

1. Create a dedicated Twitch account for the bot, then generate credentials: Twitch Token Generator
   • Select Bot Token
   • Verify scopes chat:read and chat:write are selected
   • Copy the Access Token to token property
   • Copy the Client ID to clientId property
2. Start the gateway

Full documentation

See https://docs.openclaw.ai/channels/twitch for:

• Token refresh setup
• Access control patterns
• Multi-account configuration
• Troubleshooting
• Capabilities & limits