openclaw/translation/vietnamese/docs/channels/twitch.vi.md

2.7 KiB

summary read_when
Cấu hình và thiết lập bot chat cho Twitch
Bạn muốn tích hợp Moltbot vào luồng livestream trên Twitch

Twitch (Plugin)

Moltbot hỗ trợ chat trên Twitch thông qua giao thức IRC. Bot sẽ tham gia vào luồng chat của bạn dưới tư cách là một người dùng Twitch bình thường để gửi và nhận tin nhắn.

Cài đặt Plugin

Twitch được cung cấp dưới dạng plugin riêng biệt:

moltbot plugins install @moltbot/twitch

Thiết lập nhanh (Dành cho người mới)

  1. Tạo tài khoản: Bạn nên tạo một tài khoản Twitch riêng cho bot (để tránh nhầm lẫn với tài khoản cá nhân).
  2. Lấy mã Token: Sử dụng công cụ Twitch Token Generator.
    • Chọn Bot Token.
    • Đảm bảo đã chọn quyền chat:readchat:write.
    • Sao chép Client IDAccess Token.
  3. Cấu hình:
    {
      channels: {
        twitch: {
          enabled: true,
          username: "ten_bot_cua_ban",
          accessToken: "oauth:abc123...", // Bắt đầu bằng oauth:
          clientId: "ma_client_id_cua_ban",
          channel: "ten_kenh_cua_ban",     // Tên kênh mà bot sẽ tham gia
          allowFrom: ["ID_nguoi_dung_cua_ban"] // Giới hạn người được điều khiển bot
        }
      }
    }
    

Kiểm soát quyền truy cập

Trên Twitch chat, bất kỳ ai cũng có thể gõ phím. Vì vậy, việc thiết lập quyền là cực kỳ quan trọng:

  • Nhắc tên: Mặc định bot chỉ phản hồi khi được @nhắc_tên.
  • Theo vai trò (allowedRoles): Bạn có thể quy định chỉ moderator (kiểm duyệt viên), vip, hoặc subscriber mới được dùng lệnh.
  • Theo ID người dùng (allowFrom): Cách an toàn nhất, chỉ những ID cụ thể mới có toàn quyền điều khiển bot.

Tự động làm mới Token (Refresh Token)

Mã Token lấy từ trình tạo mã thường có thời hạn ngắn. Để bot chạy ổn định lâu dài, bạn nên đăng ký một ứng dụng trên Twitch Developer Console để lấy clientSecretrefreshToken. Khi đó, Moltbot sẽ tự động làm mới mã đăng nhập mỗi khi hết hạn.

Các giới hạn

  • Mỗi tin nhắn bị giới hạn ở 500 ký tự (Hệ thống sẽ tự cắt nhỏ tin nhắn nếu dài hơn).
  • Không hỗ trợ gửi các tệp tin đa phương tiện trực tiếp (hình ảnh, video) vào chat.

Tài liệu liên quan: Cấu hình hệ thống, Plugin.