Twitch

Підтримка чату Twitch через IRC-з’єднання. OpenClaw підключається як користувач Twitch (обліковий запис бота), щоб отримувати й надсилати повідомлення в каналах.

# Вбудований Plugin

Якщо ви використовуєте старішу збірку або кастомне встановлення, яке не включає Twitch, встановіть npm-пакет напряму:

openclaw plugins install @openclaw/twitch

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

Використовуйте пакет без версії, щоб стежити за поточним офіційним тегом випуску. Закріплюйте точну версію лише тоді, коли вам потрібне відтворюване встановлення.

Докладніше: Plugins

# Швидке налаштування (для початківців)

Мінімальна конфігурація:

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw", // Bot's Twitch account
      accessToken: "oauth:abc123...", // OAuth Access Token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)
      clientId: "xyz789...", // Client ID from Token Generator
      channel: "vevisk", // Which Twitch channel's chat to join (required)
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only - get it from https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
    },
  },
}

# Що це таке

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

# Налаштування (докладно)

# Згенеруйте облікові дані

Використайте Twitch Token Generator:

• Виберіть Bot Token
• Перевірте, що вибрано області доступу chat:read і chat:write
• Скопіюйте Client ID і Access Token

# Налаштуйте бота

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
    },
  },
}

Якщо задано і змінну середовища, і конфігурацію, конфігурація має пріоритет.

# Контроль доступу (рекомендовано)

{
  channels: {
    twitch: {
      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only
    },
  },
}

Надавайте перевагу allowFrom для жорсткого списку дозволених. Використовуйте allowedRoles натомість, якщо вам потрібен доступ на основі ролей.

Доступні ролі: "moderator", "owner", "vip", "subscriber", "all".

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

Токени з Twitch Token Generator не можна автоматично оновлювати — згенеруйте новий після завершення строку дії.

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

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

Бот автоматично оновлює токени до завершення строку дії та записує події оновлення в журнали.

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

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

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

{
  channels: {
    twitch: {
      accounts: {
        channel1: {
          username: "openclaw",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "vevisk",
        },
        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

Using env token source for mybot
Access token refreshed for user 123456 (expires in 14400s)

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

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

# Параметри провайдера

• channels.twitch.enabled - Увімкнути/вимкнути запуск каналу
• channels.twitch.username - Ім’я користувача бота (спрощена конфігурація одного облікового запису)
• channels.twitch.accessToken - Токен доступу OAuth (спрощена конфігурація одного облікового запису)
• channels.twitch.clientId - Twitch Client ID (спрощена конфігурація одного облікового запису)
• channels.twitch.channel - Канал, до якого потрібно приєднатися (спрощена конфігурація одного облікового запису)
• channels.twitch.accounts.<accountName> - Конфігурація кількох облікових записів (усі поля облікового запису вище)

Повний приклад:

{
  channels: {
    twitch: {
      enabled: true,
      username: "openclaw",
      accessToken: "oauth:abc123...",
      clientId: "xyz789...",
      channel: "vevisk",
      clientSecret: "secret123...",
      refreshToken: "refresh456...",
      allowFrom: ["123456789"],
      allowedRoles: ["moderator", "vip"],
      accounts: {
        default: {
          username: "mybot",
          accessToken: "oauth:abc123...",
          clientId: "xyz789...",
          channel: "your_channel",
          enabled: true,
          clientSecret: "secret123...",
          refreshToken: "refresh456...",
          expiresIn: 14400,
          obtainmentTimestamp: 1706092800000,
          allowFrom: ["123456789", "987654321"],
          allowedRoles: ["moderator"],
        },
      },
    },
  },
}

# Дії інструментів

Агент може викликати twitch з дією:

• send - Надіслати повідомлення в канал

Приклад:

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

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

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

# Обмеження

• 500 символів на повідомлення (автоматично розбивається на частини на межах слів).
• Markdown видаляється перед розбиттям на частини.
• Без обмеження частоти (використовуються вбудовані обмеження частоти Twitch).

# Пов’язане

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