Twitch

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

Установка

Twitch поставляется как официальный плагин и не входит в основную установку.

openclaw plugins install @openclaw/twitch

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

plugins install регистрирует и включает плагин. При выборе 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...", // Client ID из 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",    },  },}

Если заданы оба значения, плагин использует провайдер аутентификации с обновлением, который продлевает токены до истечения срока действия и регистрирует каждое обновление в журнале. Без 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: "Привет, Twitch!",}

to является необязательным и по умолчанию использует настроенное для учётной записи значение channel.

Безопасность и эксплуатация

• Обращайтесь с токенами как с паролями — никогда не добавляйте токены в git.
• Используйте автоматическое обновление токенов для ботов, работающих продолжительное время.
• Используйте списки разрешённых идентификаторов пользователей, а не имена пользователей, для контроля доступа.
• Отслеживайте журнал, чтобы видеть события обновления токенов и состояние подключения.
• Минимизируйте области действия токенов — запрашивайте только chat:read и chat:write.
• Если устранить проблему не удаётся: перезапустите Gateway, предварительно убедившись, что никакой другой процесс не владеет сеансом.

Ограничения

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

Связанные материалы

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