Twitch

Dukungan chat Twitch melalui koneksi IRC. OpenClaw terhubung sebagai pengguna Twitch (akun bot) untuk menerima dan mengirim pesan di channel.

# Plugin bawaan

Jika Anda menggunakan build lama atau instalasi kustom yang mengecualikan Twitch, instal paket npm secara langsung:

openclaw plugins install @openclaw/twitch

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

Gunakan paket dasar untuk mengikuti tag rilis resmi saat ini. Pin versi persis hanya ketika Anda memerlukan instalasi yang dapat direproduksi.

Detail: Plugin

# Penyiapan cepat (pemula)

Config minimal:

{
  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/
    },
  },
}

# Apa ini

• Channel Twitch yang dimiliki oleh Gateway.
• Perutean deterministik: balasan selalu kembali ke Twitch.
• Setiap akun dipetakan ke kunci sesi terisolasi agent:<agentId>:twitch:<accountName>.
• username adalah akun bot (yang melakukan autentikasi), channel adalah ruang chat yang akan dimasuki.

# Penyiapan (terperinci)

# Buat kredensial

Gunakan Twitch Token Generator:

• Pilih Bot Token
• Pastikan scope chat:read dan chat:write dipilih
• Salin Client ID dan Access Token

# Konfigurasikan bot

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

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

Jika env dan config sama-sama diatur, config lebih diprioritaskan.

# Kontrol akses (direkomendasikan)

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

Utamakan allowFrom untuk allowlist ketat. Gunakan allowedRoles sebagai gantinya jika Anda menginginkan akses berbasis peran.

Peran yang tersedia: "moderator", "owner", "vip", "subscriber", "all".

# Refresh token (opsional)

Token dari Twitch Token Generator tidak dapat direfresh secara otomatis - buat ulang saat kedaluwarsa.

Untuk refresh token otomatis, buat aplikasi Twitch Anda sendiri di Twitch Developer Console dan tambahkan ke config:

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

Bot otomatis merefresh token sebelum kedaluwarsa dan mencatat event refresh.

# Dukungan multi-akun

Gunakan channels.twitch.accounts dengan token per akun. Lihat Konfigurasi untuk pola bersama.

Contoh (satu akun bot di dua channel):

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

# Kontrol akses

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

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

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

# Pemecahan masalah

Pertama, jalankan perintah diagnostik:

openclaw doctor
openclaw channels status --probe

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

# Config

# Config akun

# Opsi provider

• channels.twitch.enabled - Aktifkan/nonaktifkan startup channel
• channels.twitch.username - Nama pengguna bot (config satu akun yang disederhanakan)
• channels.twitch.accessToken - Token akses OAuth (config satu akun yang disederhanakan)
• channels.twitch.clientId - Client ID Twitch (config satu akun yang disederhanakan)
• channels.twitch.channel - Channel yang akan dimasuki (config satu akun yang disederhanakan)
• channels.twitch.accounts.<accountName> - Config multi-akun (semua field akun di atas)

Contoh lengkap:

{
  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"],
        },
      },
    },
  },
}

# Tindakan alat

Agent dapat memanggil twitch dengan tindakan:

• send - Kirim pesan ke channel

Contoh:

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

# Keamanan dan ops

• Perlakukan token seperti kata sandi — Jangan pernah commit token ke git.
• Gunakan refresh token otomatis untuk bot yang berjalan lama.
• Gunakan allowlist ID pengguna alih-alih nama pengguna untuk kontrol akses.
• Pantau log untuk event refresh token dan status koneksi.
• Batasi scope token seminimal mungkin — Hanya minta chat:read dan chat:write.
• Jika macet: Mulai ulang gateway setelah memastikan tidak ada proses lain yang memiliki sesi.

# Batasan

• 500 karakter per pesan (dipecah otomatis pada batas kata).
• Markdown dihapus sebelum pemecahan.
• Tidak ada pembatasan laju (menggunakan batas laju bawaan Twitch).

# Terkait

• Perutean Channel — perutean sesi untuk pesan
• Ikhtisar Channel — semua channel yang didukung
• Grup — perilaku chat grup dan gating mention
• Pairing — autentikasi DM dan alur pairing
• Keamanan — model akses dan hardening