Twitch

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

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:

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)

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

# Cấu hình bot

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".

# 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",
        },
      },
    },
  },
}

# Kiểm soát truy cập

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

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

# Cấu hình

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

# 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ố