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...", // Client ID из 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: "Привет, Twitch!",
}

​

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

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

​

Ограничения

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

​

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

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