Twitch

Підтримка чату Twitch через інтерфейс чату Twitch (IRC) за допомогою клієнта Twurple. OpenClaw входить у систему як обліковий запис бота Twitch, приєднується до одного каналу для кожного налаштованого облікового запису та відповідає в цьому каналі.

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

Twitch постачається як офіційний Plugin і не входить до базового встановлення.

openclaw plugins install @openclaw/twitch

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

plugins install реєструє та вмикає Plugin. Вибір Twitch під час openclaw onboard або openclaw channels add встановлює його за потреби. Використовуйте назву пакета без версії, щоб отримувати поточний випуск; фіксуйте точну версію лише для відтворюваних установлень. Потрібна версія OpenClaw 2026.4.10 або новіша.

Докладніше: Плагіни

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

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:).

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

Токени з Twitch Token Generator не можуть оновлюватися OpenClaw — створіть їх повторно після завершення строку дії (вони діють кілька годин; реєстрація застосунку не потрібна).

Для автоматичного оновлення створіть власний застосунок у Twitch Developer Console і додайте:

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

Якщо задано обидва параметри, Plugin використовує постачальник автентифікації з оновленням, який поновлює токени до завершення строку їхньої дії та записує кожне оновлення в журнал. Без refreshToken він записує token refresh disabled (no refresh token); без clientSecret він повертається до статичного токена (без оновлення).

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

Використовуйте channels.twitch.accounts з окремими обліковими даними для кожного облікового запису. Спільний шаблон описано в розділі Конфігурація.

Приклад (один обліковий запис бота у двох каналах):

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

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

allowFrom — це суворий список дозволених ідентифікаторів користувачів Twitch. Якщо його задано, allowedRoles ігнорується; не задавайте allowFrom, щоб натомість використовувати доступ на основі ролей.

Доступні ролі: "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,        },      },    },  },}

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

Спочатку виконайте діагностичні команди:

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

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

Агент може надсилати повідомлення Twitch через дію send інструмента повідомлень:

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

to є необов’язковим і за замовчуванням використовує налаштований для облікового запису channel.

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

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

Обмеження

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

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

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