SUSI.AI Twitchbot 常见问题与故障排除指南
SUSI.AI Twitchbot 是一款智能聊天机器人，能在 Twitch 直播中与观众互动。本指南将帮助新手快速解决使用过程中可能遇到的常见问题，让你的直播互动更顺畅。
机器人无法连接到 Twitch 频道？检查配置变量设置
配置变量错误是导致连接失败的最常见原因。确保你的环境变量设置正确，特别是以下关键参数：
解决步骤：
- 确认
CHANNEL变量填写的是你的 Twitch 频道名称（不含#符号） OAUTH_TOKEN必须是从 Twitch 开发者平台获取的有效令牌USERNAME应与你的 Twitch 机器人账号一致HEROKU_URL需正确设置为你的应用 URL
机器人不响应@提及？检查消息处理逻辑
当观众在聊天中@机器人时无响应，可能是消息处理出现问题。正常情况下，机器人应像这样与观众互动：
解决步骤：
- 确保观众消息中正确包含
@机器人用户名格式 - 检查网络连接，确保机器人能访问 SUSI API（http://api.susi.ai/susi/chat.json）
- 验证
index.js中第 33-83 行的聊天事件处理逻辑是否正常运行
机器人频繁断开连接？启用自动重连功能
如果机器人经常离线，可能是连接稳定性问题。查看 index.js 第 20 行，确保已启用自动重连：
connection: { reconnect: true }
优化建议：
- 确保服务器网络稳定
- 检查是否有防火墙阻止了连接
- 考虑增加重连间隔时间
部署到 Heroku 后机器人不在线？检查端口配置
Heroku 部署时常见的端口配置问题可通过 index.js 第 89-92 行解决：
const port = process.env.PORT || 3000; app.listen(port, () => { console.log(`Listening on ${port}`); });
部署检查清单：
- 确认
Procfile文件存在且内容为web: node index.js - 检查 Heroku 应用是否已正确配置所有环境变量
- 通过 Heroku 日志查看是否有启动错误
机器人响应缓慢？优化 API 请求
如果机器人回答延迟较长，可能是 API 请求处理需要优化。查看 index.js 第 51-80 行的 API 调用部分，考虑：
性能优化建议：
- 检查网络延迟，确保服务器能快速访问 SUSI API
- 考虑添加请求超时处理
- 优化大数据返回时的消息格式（如
index.js第 60-71 行的表格数据处理）
命令总结：快速排查工具
使用以下命令帮助诊断问题：
- 检查依赖安装：
npm install
- 本地测试运行：
npm start
- 查看应用日志：
heroku logs --tail
通过以上步骤，大多数常见问题都能快速解决。如果问题仍然存在，请检查项目源码文件，特别是 index.js 中的错误处理逻辑。
