教程

OpenClaw 接入 Twitch:直播间 AI 助手与 Twitch Chat 互动完全指南

OpenClaw 接入 Twitch 直播聊天的完整教程:Twitch 渠道通过 IRC 连接的工作原理、插件安装与 OAuth Token 获取、频道加入配置(joinChannels)、直播间消息过滤(只处理命令触发的消息)、主播专属功能(Broadcaster/Mod 权限)、响应限速防止刷屏、典型使用场景(直播问答机器人/游戏攻略助手/观众互动),以及与 TwitchIO 和其他 Twitch Bot 框架的比较。

2026/3/224分钟 阅读ClaudeEagle

Twitch 是全球最大的游戏直播平台,每天有数百万观众在聊天室互动。 OpenClaw 可以让你的 AI 助手驻扎在直播间, 回答观众问题、提供游戏攻略、增强直播互动性。

工作原理

Twitch Chat 底层基于 IRC 协议,OpenClaw 通过 IRC 连接接收和发送消息:

Twitch 直播间观众 ↓ 发消息到 Twitch Chat Twitch IRC 服务器(irc.chat.twitch.tv) ↓ IRC 消息 OpenClaw Twitch 插件 ↓ 触发条件满足时 OpenClaw Gateway → AI 处理 → 回复到 Twitch Chat

安装 Twitch 插件

bash
openclaw plugins install @openclaw/twitch

获取 OAuth Token

Twitch Bot 需要 OAuth Token 进行身份验证:

1. 访问 https://twitchapps.com/tmi/ (Twitch IRC OAuth Token 生成器) 2. 用你的 Bot 账号登录(建议创建专用 Bot 账号) 3. 点击「Connect」获取 Token 格式:oauth:xxxxxxxxxxxxxxxxxxxxxxxxxx 4. 复制 Token(只显示一次)

推荐创建专用 Bot 账号,与你的主播账号分开, 避免混淆观众。

基础配置

json
{
  "channels": {
    "twitch": {
      "enabled": true,
      "username": "my_ai_bot",
      "oauthToken": "oauth:xxxxxxxxxxxxxxxxxx",
      "joinChannels": ["your_channel_name"],
      "triggerPrefix": "!ai",
      "broadcasterOnly": false
    }
  }
}

关键配置字段:

字段说明
usernameBot 的 Twitch 账号名
oauthTokenOAuth Token(oauth: 开头)
joinChannels要加入的频道列表(主播的频道名)
triggerPrefix触发 AI 的前缀(如 !ai)
broadcasterOnly只响应主播(true)还是所有人(false)

消息触发配置

直播间消息量很大,不能对每条消息都调用 AI—— 需要设置触发条件:

json
{
  "twitch": {
    "triggerPrefix": "!ai",
    "modOnly": false,
    "subscriberOnly": false,
    "cooldown": 10
  }
}
  • triggerPrefix: "!ai":只有以 !ai 开头的消息才触发
  • modOnly:只有管理员(Mod)才能触发
  • subscriberOnly:只有订阅者才能触发
  • cooldown:两次响应之间的最短间隔(秒),防止刷屏

使用示例:

观众:!ai 这个 Boss 怎么打? Bot:根据游戏攻略,这个 Boss 的弱点是... 建议装备:... 观众:!ai 你今天直播什么内容? Bot:今天的直播内容是...

主播专属功能

json
{
  "twitch": {
    "broadcasterCommands": {
      "enabled": true,
      "prefix": "!oc"
    }
  }
}

主播可以用特殊命令控制 Bot:

主播:!oc clear 清空 AI 的会话记忆 主播:!oc status 查看 AI 状态 主播:!oc off 暂停 AI 响应(让 Bot 安静) 主播:!oc on 恢复 AI 响应

典型直播场景

场景一:游戏攻略助手

直播《艾尔登法环》时: 观众:!ai 黄金树大鼓楼 Boss 怎么打 Bot:黄金树大鼓楼的王妃玛莲妮娅建议: 1. 使用出血武器(锯齿曲刀+腐烂+出血效果最强) 2. 骑战:骑马迂回攻击尾部...

场景二:直播问答互动

主播播放音乐/聊天时: 观众:!ai 这首歌叫什么 Bot:这首歌是 Daft Punk 的《Get Lucky》, 发行于 2013 年,来自专辑《Random Access Memories》 观众:!ai 主播今天用的是什么麦克风 Bot:根据直播间简介,主播使用的是 Blue Yeti X 麦克风

场景三:编程直播助手

Coding Stream 中: 观众:!ai 这个 TypeScript 错误是什么意思 Bot:TS2345: Argument of type 'string' is not assignable... 意思是你传入了字符串,但函数期望接收的是数字类型。 修复方法:在第 23 行加上 parseInt() 转换...

响应格式优化

Twitch Chat 有 500 字符限制,配置 AI 适当缩短回复:

markdown
# SOUL.md Twitch 专项配置

## Twitch 回复规范
- 控制在 400 字符以内(Twitch 限制 500 字符)
- 不用 Markdown 格式(Twitch 不渲染)
- 语气轻松友好,适合直播氛围
- 如果答案太长,先给出核心要点,
  提示观众"详细攻略见描述栏"

来源:OpenClaw 官方文档 - docs.openclaw.ai/channels/twitch

相关文章推荐

教程OpenClaw 接入 Twitch:直播聊天室 AI Bot、IRC 协议配置与用户角色权限控制OpenClaw 接入 Twitch 完整教程:IRC 协议 Bot 账号配置、Token 生成步骤、两种访问控制(用户 ID 白名单 vs 角色权限 broadcaster/moderator/subscriber)、关闭 @提及要求、Token 自动刷新、多账号多频道管理,以及常见问题排查。2026/3/3教程WorkBuddy 直连微信:发条消息就能远程指挥电脑干活,兼容 OpenClaw 技能体系腾讯 WorkBuddy 微信直连功能详解:配置微信客服号即可远程指挥电脑执行任务,支持企微断网自动重连与定时任务自动化,技能包完全兼容OpenClaw体系可无缝迁移,附向内隔离向外防御安全设计解读。2026/8/15教程OpenClaw Sessions 磁盘维护完全指南:sessions.json 自动清理与 openclaw sessions cleanup 命令详解 OpenClaw session.maintenance 磁盘维护配置:warn/enforce 双模式、清理执行顺序、maxDiskBytes/highWaterBytes 磁盘预算控制,以及 openclaw sessions cleanup 命令的 dry-run 安全用法。2026/8/13教程OpenClaw SecretRef 完全教程:让 API Key 不用再以明文躺在配置文件里详解 OpenClaw SecretRef 密钥引用机制:内存快照运行时模型、active/inactive Surface 判定逻辑、env/file/exec 三种引用来源写法,以及生产环境凭据管理的实战建议。2026/8/12教程OpenClaw Session Pruning 与 Compaction 的区别:谁在悄悄给你的会话上下文瘦身详解 OpenClaw Session Pruning 会话修剪机制:如何在每次 LLM 调用前修剪旧的工具调用结果以降低成本,与 Compaction 压缩机制的区别与配合方式,附智能默认值和手动配置方法。2026/8/12教程OpenClaw Prompt Caching 调优指南:cacheRetention、cache-ttl 修剪与心跳保温三件套详解 OpenClaw 提示缓存调优三大配置项:cacheRetention 缓存保留策略、contextPruning cache-ttl 上下文修剪、heartbeat 心跳保温,附配置合并优先级和不同场景的调优建议。2026/8/12