Twitch

​

Встановлення

openclaw plugins install @openclaw/twitch

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

​

Швидке налаштування

openclaw gateway run

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Обліковий запис бота в Twitch (виконує автентифікацію)
      accessToken: "oauth:abc123...", // Токен доступу OAuth (або використовуйте змінну середовища OPENCLAW_TWITCH_ACCESS_TOKEN)
      clientId: "xyz789...", // Ідентифікатор клієнта з Token Generator
      channel: "yourchannel", // До чату якого каналу Twitch приєднатися (обов’язково)
      allowFrom: ["123456789"], // (рекомендовано) Лише ваш ідентифікатор користувача Twitch
    },
  },
}

​

Що це таке

• Канал Twitch, яким керує Gateway.
• Детермінізована маршрутизація: відповіді завжди надсилаються назад у канал Twitch, з якого надійшло повідомлення.
• Кожен приєднаний канал зіставляється з ізольованим ключем групового сеансу agent:<agentId>:twitch:group:<channel>.
• username — обліковий запис бота (який автентифікується), а channel — чат-кімната, до якої потрібно приєднатися. Один запис облікового запису приєднується рівно до одного каналу.
• Токени працюють із префіксом oauth: або без нього; OpenClaw нормалізує обидва варіанти (майстер налаштування очікує формат із oauth:).

​

Оновлення токена (необов’язково)

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

​

Підтримка кількох облікових записів

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

​

Контроль доступу

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

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

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

​

Усунення несправностей

openclaw doctor
openclaw channels status --probe

Використовується джерело токена зі змінної середовища для mybot
Токен доступу для користувача 123456 оновлено (завершення строку дії через 14400 с)

​

Конфігурація

​

Конфігурація облікового запису

​

Параметри постачальника

• channels.twitch.enabled — увімкнути або вимкнути запуск каналу
• channels.twitch.username / accessToken / clientId / channel — спрощена конфігурація одного облікового запису (неявний обліковий запис default; має пріоритет над accounts.default)
• channels.twitch.accounts.<accountName> — конфігурація кількох облікових записів (усі наведені вище поля облікового запису)
• channels.twitch.defaultAccount — назва облікового запису, який є типовим
• channels.twitch.markdown.tables — режим відтворення таблиць Markdown (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"],
        },
      },
    },
  },
}

​

Дії інструмента

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

​

Безпека та експлуатація

• Поводьтеся з токенами як із паролями — ніколи не додавайте токени до git.
• Використовуйте автоматичне оновлення токенів для ботів, що працюють тривалий час.
• Використовуйте списки дозволених ідентифікаторів користувачів замість імен користувачів для контролю доступу.
• Відстежуйте журнали щодо подій оновлення токенів і стану підключення.
• Мінімізуйте області доступу токенів — запитуйте лише chat:read і chat:write.
• Якщо виникли труднощі: перезапустіть Gateway, попередньо переконавшись, що жоден інший процес не володіє сеансом.

​

Обмеження

• 500 символів на повідомлення; довші відповіді розбиваються на частини за межами слів.
• Markdown видаляється перед надсиланням (чат Twitch використовує звичайний текст; переноси рядків перетворюються на пробіли).
• OpenClaw не додає власного обмеження частоти запитів; клієнт чату Twurple обробляє обмеження частоти Twitch.

​

Пов’язані розділи

• Маршрутизація каналів — маршрутизація сеансів для повідомлень
• Огляд каналів — усі підтримувані канали
• Групи — поведінка групового чату й обмеження за згадкою
• Сполучення — автентифікація в особистих повідомленнях і процес сполучення
• Безпека — модель доступу та посилення захисту