教程

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教程OpenClaw Standing Orders 完全指南:让 AI 记住你的长期规则和行为偏好OpenClaw Standing Orders(常驻指令)功能完整教程:Standing Orders 与 SOUL.md 的区别(动态运行时规则 vs 静态人格文件)、通过对话动态添加/查看/删除常驻指令、指令的持久化存储与跨会话生效机制、适合写入 Standing Orders 的内容类型(格式偏好/禁止行为/固定工作流)、与 Hooks 的协同使用、按渠道/Agent 设置不同的 Standing Orders,以及常驻指令的最佳实践(写清晰的规则、避免矛盾冲突、定期清理过时规则)。2026/3/26教程OpenClaw 多媒体处理完全指南:图片识别、音频转写与视频理解实战OpenClaw 多媒体处理(Media)完整教程:发送图片给 AI 进行视觉分析(OCR/物体识别/图表解读/代码截图)、音频消息自动转写为文字(Whisper/系统STT)、视频消息关键帧提取与理解、Node 摄像头实时拍照触发分析、媒体消息的渠道支持差异(各渠道的图片/音频/视频支持情况对比)、大文件处理策略(分割/压缩/超时设置)、媒体消息在不同 AI 模型上的能力对比(Claude Vision/GPT-4V/Gemini Pro Vision),以及本地媒体文件分析(read 工具读取图片路径)。2026/3/25教程OpenClaw TUI 完全指南:纯键盘操作的终端管理界面使用详解OpenClaw TUI(Terminal User Interface,终端用户界面)完整使用指南:TUI 与 Control UI(浏览器)的定位对比、适合 TUI 的场景(SSH 远程/无浏览器服务器/低带宽环境)、启动命令(openclaw tui)及参数、界面布局(Agents 面板/Sessions 面板/Channels 状态/Logs 实时流)、全键盘快捷键手册(导航/选择/搜索/刷新/退出)、在 TUI 中发送测试消息、实时日志过滤与搜索,以及 TUI 与 tmux/screen 配合使用的后台运行方案。2026/3/25教程OpenClaw Control UI 与 Dashboard 完全指南:浏览器管理 AI 助手的全功能界面OpenClaw Control UI(控制面板)与 Dashboard(仪表盘)完整使用指南:Control UI 的功能布局(Agents 管理/Tools 工具面板/Sessions 会话查看/Channel 渠道状态)、浏览器访问方式(本地 localhost:18789 vs 远程 SSH 隧道)、在 Control UI 中实时修改 Agent 配置(SOUL.md 编辑/模型切换/工具开关)、Dashboard 数据概览(Token 用量/渠道在线状态/会话列表/Node 节点健康)、从 Dashboard 发起诊断(doctor 命令)、以及 TUI(终端界面)的使用场景与快捷键。2026/3/24教程OpenClaw 群消息完全指南:群组配置、@ 触发、白名单与多 Bot 协同实战OpenClaw 群消息(Group Messages)完整配置教程:群组消息的触发方式(requireMention/commandPrefix/respondToAll)、各渠道群组配置差异(Telegram群/Discord服务器/Slack频道/WhatsApp群)、群组白名单与黑名单管理、限制特定成员才能触发 AI(allowedUsers/allowedRoles)、响应限速防刷屏(cooldown)、多 Bot 在同一群组协同分工的配置方案、群组 Session 的记忆与上下文管理,以及群组中 AI 的礼貌边界设计(何时发言/何时沉默)。2026/3/24