Twitch

Hỗ trợ trò chuyện Twitch thông qua giao diện trò chuyện (IRC) của Twitch bằng ứng dụng khách Twurple. OpenClaw đăng nhập bằng tài khoản bot Twitch, tham gia một kênh cho mỗi tài khoản đã cấu hình và trả lời trong kênh đó.

Cài đặt

Twitch được phân phối dưới dạng Plugin chính thức; thành phần này không nằm trong bản cài đặt lõi.

openclaw plugins install @openclaw/twitch

openclaw plugins install ./path/to/local/twitch-plugin

plugins install đăng ký và bật Plugin. Việc chọn Twitch trong openclaw onboard hoặc openclaw channels add sẽ cài đặt Plugin khi cần. Sử dụng tên gói trần để theo dõi bản phát hành hiện tại; chỉ ghim phiên bản chính xác khi cần cài đặt có thể tái lập. Yêu cầu OpenClaw 2026.4.10 trở lên.

Chi tiết: Plugin

Thiết lập nhanh

openclaw gateway run

Cấu hình tối thiểu:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // Tài khoản Twitch của bot (dùng để xác thực)      accessToken: "oauth:abc123...", // Token truy cập OAuth (hoặc sử dụng biến môi trường OPENCLAW_TWITCH_ACCESS_TOKEN)      clientId: "xyz789...", // Client ID từ Trình tạo token      channel: "yourchannel", // Kênh trò chuyện Twitch cần tham gia (bắt buộc)      allowFrom: ["123456789"], // (khuyến nghị) Chỉ ID người dùng Twitch của bạn    },  },}

Đây là gì

• Một kênh Twitch do Gateway sở hữu.
• Định tuyến xác định: câu trả lời luôn được gửi trở lại kênh Twitch nơi tin nhắn bắt nguồn.
• Mỗi kênh đã tham gia ánh xạ tới một khóa phiên nhóm biệt lập agent:<agentId>:twitch:group:<channel>.
• username là tài khoản của bot (tài khoản xác thực), còn channel là phòng trò chuyện cần tham gia. Mỗi mục tài khoản tham gia đúng một kênh.
• Token hoạt động dù có hoặc không có tiền tố oauth:; OpenClaw chuẩn hóa cả hai dạng (trình hướng dẫn thiết lập yêu cầu dạng oauth:).

Làm mới token (tùy chọn)

OpenClaw không thể làm mới token từ Trình tạo token Twitch — hãy tạo lại khi token hết hạn (token có hiệu lực trong vài giờ; không cần đăng ký ứng dụng).

Để tự động làm mới, hãy tạo ứng dụng riêng tại Bảng điều khiển dành cho nhà phát triển Twitch và thêm:

{  channels: {    twitch: {      clientSecret: "your_client_secret",      refreshToken: "your_refresh_token",    },  },}

Khi cả hai đều được đặt, Plugin sử dụng trình cung cấp xác thực có khả năng làm mới để gia hạn token trước khi hết hạn và ghi nhật ký mỗi lần làm mới. Nếu không có refreshToken, Plugin ghi nhật ký token refresh disabled (no refresh token); nếu không có clientSecret, Plugin chuyển sang sử dụng token tĩnh (không làm mới).

Hỗ trợ nhiều tài khoản

Sử dụng channels.twitch.accounts với thông tin xác thực riêng cho từng tài khoản. Xem Cấu hình để biết mẫu dùng chung.

Ví dụ (một tài khoản bot trong hai kênh):

{  channels: {    twitch: {      accounts: {        channel1: {          username: "openclaw",          accessToken: "oauth:abc123...",          clientId: "xyz789...",          channel: "yourchannel",        },        channel2: {          username: "openclaw",          accessToken: "oauth:def456...",          clientId: "uvw012...",          channel: "secondchannel",        },      },    },  },}

Kiểm soát truy cập

allowFrom là danh sách cho phép cứng gồm các ID người dùng Twitch. Khi được đặt, allowedRoles bị bỏ qua; không đặt allowFrom nếu muốn sử dụng quyền truy cập dựa trên vai trò.

Các vai trò khả dụng: "moderator", "owner", "vip", "subscriber", "all".

{  channels: {    twitch: {      accounts: {        default: {          allowFrom: ["123456789", "987654321"],        },      },    },  },}

{  channels: {    twitch: {      accounts: {        default: {          allowedRoles: ["moderator", "vip"],        },      },    },  },}

{  channels: {    twitch: {      accounts: {        default: {          requireMention: false,        },      },    },  },}

Khắc phục sự cố

Trước tiên, chạy các lệnh chẩn đoán:

openclaw doctoropenclaw channels status --probe

Using env token source for mybotAccess token refreshed for user 123456 (expires in 14400s)

Cấu hình

Cấu hình tài khoản

Tùy chọn trình cung cấp

• channels.twitch.enabled - Bật/tắt việc khởi động kênh
• channels.twitch.username / accessToken / clientId / channel - Cấu hình một tài khoản đơn giản hóa (tài khoản default ngầm định; được ưu tiên hơn accounts.default)
• channels.twitch.accounts.<accountName> - Cấu hình nhiều tài khoản (tất cả các trường tài khoản ở trên)
• channels.twitch.defaultAccount - Tên tài khoản nào là mặc định
• channels.twitch.markdown.tables - Chế độ hiển thị bảng Markdown (off | bullets | code | block)

Ví dụ đầy đủ:

{  channels: {    twitch: {      enabled: true,      username: "openclaw",      accessToken: "oauth:abc123...",      clientId: "xyz789...",      channel: "yourchannel",      clientSecret: "secret123...",      refreshToken: "refresh456...",      allowFrom: ["123456789"],      accounts: {        second: {          username: "mybot",          accessToken: "oauth:def456...",          clientId: "uvw012...",          channel: "your_channel",          enabled: true,          expiresIn: 14400,          obtainmentTimestamp: 1706092800000,          allowedRoles: ["moderator"],        },      },    },  },}

Thao tác công cụ

Tác tử có thể gửi tin nhắn Twitch thông qua thao tác send của công cụ tin nhắn:

{  channel: "twitch",  action: "send",  to: "#mychannel",  message: "Hello Twitch!",}

to là tùy chọn và mặc định sử dụng channel đã cấu hình của tài khoản.

An toàn và vận hành

• Coi token như mật khẩu — không bao giờ cam kết token vào git.
• Sử dụng tính năng tự động làm mới token cho các bot chạy lâu dài.
• Sử dụng danh sách cho phép theo ID người dùng thay vì tên người dùng để kiểm soát truy cập.
• Theo dõi nhật ký để kiểm tra các sự kiện làm mới token và trạng thái kết nối.
• Giới hạn phạm vi token ở mức tối thiểu — chỉ yêu cầu chat:read và chat:write.
• Nếu gặp bế tắc: khởi động lại Gateway sau khi xác nhận không có tiến trình nào khác sở hữu phiên.

Giới hạn

• 500 ký tự cho mỗi tin nhắn; các câu trả lời dài hơn được chia nhỏ tại ranh giới từ.
• Markdown được loại bỏ trước khi gửi (trò chuyện Twitch là văn bản thuần túy; các dòng mới được chuyển thành dấu cách).
• OpenClaw không tự thêm giới hạn tốc độ; ứng dụng khách trò chuyện Twurple xử lý các giới hạn tốc độ của Twitch.

Liên quan

• Định tuyến kênh — định tuyến phiên cho tin nhắn
• Tổng quan về kênh — tất cả các kênh được hỗ trợ
• Nhóm — hành vi trò chuyện nhóm và cổng đề cập
• Ghép nối — quy trình xác thực tin nhắn trực tiếp và ghép nối
• Bảo mật — mô hình truy cập và tăng cường bảo mật