Twitch

Twurple istemcisi aracılığıyla Twitch'in sohbet (IRC) arayüzü üzerinden Twitch sohbet desteği. OpenClaw, bir Twitch bot hesabıyla oturum açar, yapılandırılmış her hesap için bir kanala katılır ve o kanalda yanıt verir.

Kurulum

Twitch, resmî bir Plugin olarak sunulur; çekirdek kurulumun parçası değildir.

openclaw plugins install @openclaw/twitch

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

plugins install, Plugin'i kaydeder ve etkinleştirir. openclaw onboard veya openclaw channels add sırasında Twitch seçildiğinde gerektiğinde kurulur. Güncel sürümü takip etmek için yalnızca paket adını kullanın; tam sürümü yalnızca tekrarlanabilir kurulumlar için sabitleyin. OpenClaw 2026.4.10 veya daha yenisini gerektirir.

Ayrıntılar: Plugin'ler

Hızlı kurulum

openclaw gateway run

Asgari yapılandırma:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // Botun Twitch hesabı (kimlik doğrulaması yapar)      accessToken: "oauth:abc123...", // OAuth erişim token'ı (veya OPENCLAW_TWITCH_ACCESS_TOKEN ortam değişkenini kullanın)      clientId: "xyz789...", // Token Generator'dan alınan istemci kimliği      channel: "yourchannel", // Hangi Twitch kanalının sohbetine katılacağı (zorunlu)      allowFrom: ["123456789"], // (önerilir) Yalnızca Twitch kullanıcı kimliğiniz    },  },}

Nedir?

• Gateway'in sahip olduğu bir Twitch kanalıdır.
• Belirlenimci yönlendirme: yanıtlar her zaman mesajın geldiği Twitch kanalına geri gönderilir.
• Katılınan her kanal, yalıtılmış bir grup oturumu anahtarıyla agent:<agentId>:twitch:group:<channel> eşlenir.
• username botun hesabıdır (kimlik doğrulaması yapan), channel ise katılınacak sohbet odasıdır. Her hesap girdisi tam olarak bir kanala katılır.
• Token'lar oauth: önekiyle veya öneksiz çalışır; OpenClaw her iki biçimi de normalleştirir (kurulum sihirbazı oauth: biçimini bekler).

Gelen iletilerin dayanıklılığı

OpenClaw, kabul edilen her Twitch sohbet iletisini normal dağıtımdan önce kalıcı olarak kuyruğa alır. Bekleyen veya yeniden denenebilir iletiler Gateway yeniden başlatıldığında korunur, yapılandırılmış kanal için sıralı kalır ve etkin ya da saklanan tamamlanma kaydı mevcut olduğu sürece yinelenen kuyruk girdilerini engellemek için Twitch'in ileti kimliğini kullanır.

Twitch sohbeti, istemci kabul ettikten sonra bir PRIVMSG öğesini yeniden oynatmaz. Bu, yerel kabul ile dağıtım arasındaki çökme aralığını korur ancak kalıcı kabulden önce kaçırılan iletileri kurtaramaz. Kuyruğa ekleme işleminin kendisi başarısız olursa OpenClaw hatayı günlüğe kaydeder; yeniden bağlanmak Twitch'ten bu iletiyi yeniden göndermesini istemez.

Token yenileme (isteğe bağlı)

Twitch Token Generator tarafından oluşturulan token'lar OpenClaw tarafından yenilenemez; süreleri dolduğunda yeniden oluşturun (birkaç saat geçerlidirler; uygulama kaydı gerekmez).

Otomatik yenileme için Twitch Developer Console üzerinden kendi uygulamanızı oluşturun ve şunları ekleyin:

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

Her ikisi de ayarlandığında Plugin, token'ları süreleri dolmadan yenileyen ve her yenilemeyi günlüğe kaydeden bir yenilemeli kimlik doğrulama sağlayıcısı kullanır. refreshToken olmadan token refresh disabled (no refresh token) günlüğe kaydedilir; clientSecret olmadan statik (yenilenmeyen) bir token'a geri dönülür.

Çoklu hesap desteği

Hesap başına kimlik bilgileriyle channels.twitch.accounts kullanın. Ortak kalıp için Yapılandırma bölümüne bakın.

Örnek (iki kanalda tek bot hesabı):

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

Erişim denetimi

allowFrom, Twitch kullanıcı kimliklerinden oluşan katı bir izin listesidir. Ayarlandığında allowedRoles yok sayılır; bunun yerine rol tabanlı erişim kullanmak için allowFrom ayarını kaldırılmış bırakın.

Kullanılabilir roller: "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,        },      },    },  },}

Sorun giderme

Önce tanılama komutlarını çalıştırın:

openclaw doctoropenclaw channels status --probe

mybot için ortam değişkeni token kaynağı kullanılıyor123456 kullanıcısının erişim token'ı yenilendi (14400s içinde süresi dolacak)

Yapılandırma

Hesap yapılandırması

Sağlayıcı seçenekleri

• channels.twitch.enabled - Kanal başlangıcını etkinleştirir/devre dışı bırakır
• channels.twitch.username / accessToken / clientId / channel - Basitleştirilmiş tek hesap yapılandırması (örtük default hesabı; accounts.default üzerinde önceliklidir)
• channels.twitch.accounts.<accountName> - Çoklu hesap yapılandırması (yukarıdaki tüm hesap alanları)
• channels.twitch.defaultAccount - Hangi hesap adının varsayılan olduğu
• channels.twitch.markdown.tables - Markdown tablosu oluşturma modu (off | bullets | code | block)

Tam örnek:

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

Araç eylemleri

Aracı, ileti aracının send eylemi üzerinden Twitch iletileri gönderebilir:

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

to isteğe bağlıdır ve varsayılan olarak hesabın yapılandırılmış channel değerini kullanır.

Güvenlik ve operasyonlar

• Token'ları parolalar gibi ele alın - token'ları asla git'e işlemeyin.
• Uzun süre çalışan botlar için otomatik token yenilemeyi kullanın.
• Erişim denetimi için kullanıcı adları yerine kullanıcı kimliği izin listelerini kullanın.
• Token yenileme olayları ve bağlantı durumu için günlükleri izleyin.
• Token kapsamlarını en düşük düzeyde tutun - yalnızca chat:read ve chat:write kapsamlarını isteyin.
• Takılırsanız: başka hiçbir işlemin oturumun sahibi olmadığını doğruladıktan sonra Gateway'i yeniden başlatın.

Sınırlar

• Mesaj başına 500 karakter; daha uzun yanıtlar sözcük sınırlarından parçalara ayrılır.
• Markdown gönderilmeden önce kaldırılır (Twitch sohbeti düz metindir; yeni satırlar boşluklara dönüşür).
• OpenClaw kendi başına herhangi bir hız sınırlaması eklemez; Twitch hız sınırlarını Twurple sohbet istemcisi yönetir.

İlgili

• Kanal Yönlendirme — iletiler için oturum yönlendirmesi
• Kanallara Genel Bakış — desteklenen tüm kanallar
• Gruplar — grup sohbeti davranışı ve bahsetme denetimi
• Eşleştirme — DM kimlik doğrulaması ve eşleştirme akışı
• Güvenlik — erişim modeli ve sağlamlaştırma