Twitch

​

Kurulum

openclaw plugins install @openclaw/twitch

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

​

Hızlı kurulum

openclaw gateway run

{
  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ığı

​

Token yenileme (isteğe bağlı)

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

​

Çoklu hesap desteği

{
  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

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

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

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

​

Sorun giderme

openclaw doctor
openclaw channels status --probe

mybot için ortam değişkeni token kaynağı kullanılıyor
123456 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)

{
  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

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

​

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