mirror of
https://github.com/openclaw/openclaw.git
synced 2026-07-13 12:36:04 +00:00
71ddc016a8
* fix(twitch): preserve newer message handler during cleanup Fixes #83888. `TwitchClientManager.onMessage` returns a cleanup closure that called `messageHandlers.delete(key)` unconditionally. When a second onMessage() for the same account replaced the handler, running the earlier cleanup deleted the newer handler, leaving the account with no handler and silently dropping all inbound messages. Guard the delete with a referential check so the cleanup only removes the handler it registered. Adds regression tests covering both the stale-cleanup case (newer handler must survive) and the normal case (current handler is still removed). * fix(twitch): distinguish handler registrations * fix(signal): avoid dangling test export name * test(meeting-notes): use public sdk imports * test(sdk): classify meeting-notes subpath * fix(discord): keep channel entrypoint imports narrow --------- Co-authored-by: Peter Steinberger <steipete@gmail.com>
@openclaw/twitch
Twitch channel plugin for OpenClaw.
Install (local checkout)
openclaw plugins install ./path/to/local/twitch-plugin
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-to-user-id/)
},
},
}
Access control options:
requireMention: false- Disable the default mention requirement to respond to all messagesallowFrom: ["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
- Create a dedicated Twitch account for the bot, then generate credentials: Twitch Token Generator
- Select Bot Token
- Verify scopes
chat:readandchat:writeare selected - Copy the Access Token to
tokenproperty - Copy the Client ID to
clientIdproperty
- 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