Twitch - OpenClaw

Hỗ trợ trò chuyện Twitch qua kết nối IRC. OpenClaw kết nối dưới dạng người dùng Twitch (tài khoản bot) để nhận và gửi tin nhắn trong các kênh.

Plugin đi kèm

Twitch được phát hành dưới dạng Plugin đi kèm trong các bản phát hành OpenClaw hiện tại, vì vậy các bản dựng đóng gói thông thường không cần cài đặt riêng.

Nếu bạn đang dùng bản dựng cũ hơn hoặc bản cài đặt tùy chỉnh loại trừ Twitch, hãy cài trực tiếp gói npm:

npm registry
Bản checkout cục bộ

openclaw plugins install @openclaw/twitch

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

Dùng gói trần để theo thẻ phát hành chính thức hiện tại. Chỉ ghim một phiên bản chính xác khi bạn cần bản cài đặt có thể tái lập. Chi tiết: Plugins

Thiết lập nhanh (người mới bắt đầu)

Đảm bảo Plugin có sẵn

Các bản phát hành OpenClaw đóng gói hiện tại đã đi kèm Plugin này. Các bản cài đặt cũ hơn/tùy chỉnh có thể thêm thủ công bằng các lệnh ở trên.

Tạo tài khoản bot Twitch

Tạo một tài khoản Twitch riêng cho bot (hoặc dùng tài khoản hiện có).

Tạo thông tin xác thực

Dùng Twitch Token Generator:

Chọn Mã bot
Xác minh các phạm vi chat:read và chat:write đã được chọn
Sao chép ID máy khách và Mã truy cập

Tìm ID người dùng Twitch của bạn

Dùng https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/ để chuyển đổi tên người dùng thành ID người dùng Twitch.

Cấu hình mã thông báo

Biến môi trường: OPENCLAW_TWITCH_ACCESS_TOKEN=... (chỉ tài khoản mặc định)
Hoặc cấu hình: channels.twitch.accessToken

Nếu cả hai đều được đặt, cấu hình được ưu tiên (dự phòng bằng biến môi trường chỉ áp dụng cho tài khoản mặc định).

Khởi động Gateway

Khởi động Gateway với kênh đã cấu hình.

Thêm kiểm soát truy cập (allowFrom hoặc allowedRoles) để ngăn người dùng trái phép kích hoạt bot. requireMention mặc định là true.

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

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Bot's Twitch account
      accessToken: "oauth:abc123...", // OAuth Access Token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)
      clientId: "xyz789...", // Client ID from Token Generator
      channel: "vevisk", // Which Twitch channel's chat to join (required)
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only - get it from https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
    },
  },
}

Đây là gì

Một kênh Twitch do Gateway sở hữu.
Định tuyến xác định: các phản hồi luôn quay lại Twitch.
Mỗi tài khoản ánh xạ tới một khóa phiên cô lập agent:<agentId>:twitch:<accountName>.
username là tài khoản của bot (tài khoản xác thực), channel là phòng trò chuyện cần tham gia.

Thiết lập (chi tiết)

Tạo thông tin xác thực

Dùng Twitch Token Generator:

Chọn Mã bot
Xác minh các phạm vi chat:read và chat:write đã được chọn
Sao chép ID máy khách và Mã truy cập

Không cần đăng ký ứng dụng thủ công. Mã thông báo hết hạn sau vài giờ.

Cấu hình bot

Biến môi trường (chỉ tài khoản mặc định)
Cấu hình

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
    },
  },
}

Nếu cả biến môi trường và cấu hình đều được đặt, cấu hình được ưu tiên.

Kiểm soát truy cập (khuyến nghị)

{
  channels: {
    twitch: {
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only
    },
  },
}

Ưu tiên allowFrom cho danh sách cho phép cứng. Thay vào đó dùng allowedRoles nếu bạn muốn truy cập dựa trên vai trò. Vai trò có sẵn: "moderator", "owner", "vip", "subscriber", "all".

Vì sao dùng ID người dùng? Tên người dùng có thể thay đổi, cho phép mạo danh. ID người dùng là vĩnh viễn.Tìm ID người dùng Twitch của bạn: https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/ (Chuyển đổi tên người dùng Twitch của bạn thành ID)

Làm mới mã thông báo (tùy chọn)

Các mã thông báo từ Twitch Token Generator không thể được làm mới tự động - hãy tạo lại khi hết hạn. Để tự động làm mới mã thông báo, hãy tạo ứng dụng Twitch của riêng bạn tại Twitch Developer Console và thêm vào cấu hình:

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

Bot tự động làm mới mã thông báo trước khi hết hạn và ghi nhật ký các sự kiện làm mới.

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

Dùng channels.twitch.accounts với mã thông báo theo 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: "vevisk",
        },
        channel2: {
          username: "openclaw",
          accessToken: "oauth:def456...",
          clientId: "uvw012...",
          channel: "secondchannel",
        },
      },
    },
  },
}

Mỗi tài khoản cần mã thông báo riêng (một mã thông báo cho mỗi kênh).

Kiểm soát truy cập

Danh sách cho phép ID người dùng (an toàn nhất)
Dựa trên vai trò
Tắt yêu cầu @mention

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

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

allowFrom là danh sách cho phép cứng. Khi được đặt, chỉ các ID người dùng đó mới được phép. Nếu bạn muốn truy cập dựa trên vai trò, hãy để allowFrom chưa đặt và cấu hình allowedRoles thay thế.

Theo mặc định, requireMention là true. Để tắt và phản hồi tất cả tin nhắn:

{
  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 doctor
openclaw channels status --probe

Bot không phản hồi tin nhắn

Kiểm tra kiểm soát truy cập: Đảm bảo ID người dùng của bạn nằm trong allowFrom, hoặc tạm thời xóa allowFrom và đặt allowedRoles: ["all"] để kiểm thử.
Kiểm tra bot có ở trong kênh: Bot phải tham gia kênh được chỉ định trong channel.

Sự cố mã thông báo

“Không kết nối được” hoặc lỗi xác thực:

Xác minh accessToken là giá trị mã truy cập OAuth (thường bắt đầu bằng tiền tố oauth:)
Kiểm tra mã thông báo có các phạm vi chat:read và chat:write
Nếu dùng làm mới mã thông báo, xác minh clientSecret và refreshToken đã được đặt

Làm mới mã thông báo không hoạt động

Kiểm tra nhật ký để tìm các sự kiện làm mới:

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

Nếu bạn thấy “token refresh disabled (no refresh token)”:

Đảm bảo clientSecret được cung cấp
Đảm bảo refreshToken được cung cấp

Cấu hình

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

username

string

Tên người dùng bot.

accessToken

string

Mã truy cập OAuth với chat:read và chat:write.

clientId

string

ID máy khách Twitch (từ Token Generator hoặc ứng dụng của bạn).

channel

string

bắt buộc

Kênh cần tham gia.

enabled

boolean

mặc định:"true"

Bật tài khoản này.

clientSecret

string

Tùy chọn: dùng để tự động làm mới mã thông báo.

refreshToken

string

Tùy chọn: dùng để tự động làm mới mã thông báo.

expiresIn

number

Thời hạn mã thông báo tính bằng giây.

obtainmentTimestamp

number

Dấu thời gian lấy mã thông báo.

allowFrom

string[]

Danh sách cho phép ID người dùng.

allowedRoles

Array<"moderator" | "owner" | "vip" | "subscriber" | "all">

Kiểm soát truy cập dựa trên vai trò.

requireMention

boolean

mặc định:"true"

Yêu cầu @mention.

Tùy chọn nhà cung cấp

channels.twitch.enabled - Bật/tắt khởi động kênh
channels.twitch.username - Tên người dùng bot (cấu hình một tài khoản được đơn giản hóa)
channels.twitch.accessToken - Mã truy cập OAuth (cấu hình một tài khoản được đơn giản hóa)
channels.twitch.clientId - ID máy khách Twitch (cấu hình một tài khoản được đơn giản hóa)
channels.twitch.channel - Kênh cần tham gia (cấu hình một tài khoản được đơn giản hóa)
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)

Ví dụ đầy đủ:

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

Hành động công cụ

Tác nhân có thể gọi twitch với hành động:

send - Gửi tin nhắn tới một kênh

Ví dụ:

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

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

Xử lý mã thông báo như mật khẩu — Không bao giờ commit mã thông báo vào git.
Dùng tự động làm mới mã thông báo cho các bot chạy lâu dài.
Dùng danh sách cho phép ID người dùng thay vì tên người dùng để kiểm soát truy cập.
Giám sát nhật ký để theo dõi sự kiện làm mới mã thông báo và trạng thái kết nối.
Giới hạn phạm vi mã thông báo ở mức tối thiểu — Chỉ yêu cầu chat:read và chat:write.
Nếu bị kẹt: 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 (tự động chia đoạn ở ranh giới từ).
Markdown bị loại bỏ trước khi chia đoạn.
Không giới hạn tốc độ (dùng giới hạn tốc độ tích hợp 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à kiểm soát @mention
Ghép nối — xác thực DM và luồng ghép nối
Bảo mật — mô hình truy cập và gia cố

Documentation Index

​Plugin đi kèm

​Thiết lập nhanh (người mới bắt đầu)

​Đây là gì

​Thiết lập (chi tiết)

​Tạo thông tin xác thực

​Cấu hình bot

​Kiểm soát truy cập (khuyến nghị)

​Làm mới mã thông báo (tùy chọn)

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

​Kiểm soát truy cập

​Khắc phục sự cố

​Cấu hình

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

​Tùy chọn nhà cung cấp

​Hành động công cụ

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

​Giới hạn

​Liên quan

Plugin đi kèm

Thiết lập nhanh (người mới bắt đầu)

Đây là gì

Thiết lập (chi tiết)

Tạo thông tin xác thực

Cấu hình bot

Kiểm soát truy cập (khuyến nghị)

Làm mới mã thông báo (tùy chọn)

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

Kiểm soát truy cập

Khắc phục sự cố

Cấu hình

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

Tùy chọn nhà cung cấp

Hành động công cụ

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

Giới hạn

Liên quan