Twitch是全球最大的游戏直播平台之一,其聊天室基于IRC(Internet Relay Chat)协议运行。OpenClaw通过插件系统支持Twitch IRC频道,让你可以在Twitch直播间中部署AI聊天机器人,实现自动回复观众问题、互动娱乐、内容审核辅助等功能。
前置准备
在开始之前,你需要准备以下内容:
- OpenClaw实例已部署并正常运行
- 一个Twitch账户用作Bot身份(建议创建专门的Bot账户,而非使用主播个人账户)
- Twitch OAuth Token(用于Bot认证)
- 要加入的频道名称列表
获取Twitch OAuth Token
Bot连接Twitch IRC需要一个OAuth令牌进行认证。你可以通过Twitch开发者门户注册一个应用来获取。
首先访问 dev.twitch.tv,使用Bot账户登录并创建一个新应用。记下Client ID。然后通过OAuth授权流程获取访问令牌,需要的权限范围(scope)包括 chat:read 和 chat:edit。
获取到的token格式类似 oauth:xxxxxxxxxxxxxx,用于后续配置。
安装Twitch IRC插件
通过OpenClaw插件系统安装:
openclaw plugin install twitch-irc
使用交互式命令配置:
openclaw channels login twitch-irc
系统会依次提示你输入Bot用户名、OAuth Token和要加入的频道名。
配置openclaw.json
手动配置方式:
{
"channels": {
"twitch-irc": {
"enabled": true,
"username": "your_bot_username",
"token": "oauth:xxxxxxxxxxxxxx",
"channels": ["channel1", "channel2"],
"commandPrefix": "!ask"
}
}
}
username 是Bot的Twitch用户名,token 是OAuth令牌,channels 是要加入的频道列表(不含#号前缀),commandPrefix 是触发AI回复的命令前缀。
触发机制
Twitch聊天室消息量通常很大,特别是在热门直播间中。让AI响应每条消息既不现实也不合适。OpenClaw提供了多种触发模式:
命令前缀模式:只有以指定前缀开头的消息才会触发AI回复。例如设置 commandPrefix 为 !ask,用户发送 !ask 今天天气怎么样 时才会得到回复。这是最推荐的模式。
提及模式:当聊天消息中@了Bot用户名时触发回复。配置 "triggerMode": "mention" 即可。
关键词模式:当消息中包含特定关键词时触发。可以通过 "triggerKeywords": ["关键词1", "关键词2"] 配置。
{
"channels": {
"twitch-irc": {
"triggerMode": "command",
"commandPrefix": "!ai"
}
}
}
消息长度限制
Twitch IRC对单条消息有500字符的长度限制。如果AI回复超过这个长度,OpenClaw会自动将回复拆分为多条消息发送。你也可以在配置中调整这个行为:
{
"channels": {
"twitch-irc": {
"maxMessageLength": 450,
"splitLongMessages": true
}
}
}
建议将 maxMessageLength 设置为略小于500的值,留出余量给Twitch可能添加的前缀。
速率限制
Twitch对IRC消息发送有严格的速率限制。普通用户每30秒最多发送20条消息,认证为「已知机器人」后限制会放宽。OpenClaw的Twitch插件内置了速率控制逻辑,会自动排队和延迟发送以避免触发限制。
如果你的Bot需要在高流量频道中运行,建议到Twitch开发者门户申请「已知机器人」状态以获得更高的速率上限。
安全与权限
使用allowlist限制哪些用户可以触发AI回复:
{
"channels": {
"twitch-irc": {
"allowlist": ["user1", "user2"],
"moderatorsAllowed": true,
"subscribersOnly": false
}
}
}
moderatorsAllowed 设为true时,频道的管理员(Moderator)自动获得使用权限。subscribersOnly 设为true时,只有频道的订阅者才能使用AI功能。
多频道与共存
一个OpenClaw实例的Twitch Bot可以同时加入多个频道,每个频道的对话独立处理。同时,Twitch频道可以和OpenClaw的其他频道(如Discord、Telegram等)共存运行,共享同一个AI后端,非常适合跨平台运营的主播或社区。
常见问题
如果Bot无法连接到Twitch IRC,首先检查OAuth Token是否有效。Token可能过期,需要重新生成。如果Bot已连接但不响应消息,确认触发模式配置是否正确,以及Bot是否真的加入了目标频道。可以在OpenClaw日志中查看IRC连接和消息接收的详细状态。