Developer and self-hosted

Twitch

IRC कनेक्शन के माध्यम से Twitch चैट समर्थन। OpenClaw चैनलों में संदेश प्राप्त करने और भेजने के लिए Twitch उपयोगकर्ता (bot खाता) के रूप में कनेक्ट होता है।

बंडल किया गया plugin

यदि आप पुराने build पर हैं या किसी custom install में Twitch शामिल नहीं है, तो npm package सीधे इंस्टॉल करें:

npm registry

bash

openclaw plugins install @openclaw/twitch

Local checkout

bash

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

मौजूदा आधिकारिक release tag का पालन करने के लिए bare package का उपयोग करें। सटीक version केवल तब pin करें जब आपको reproducible install चाहिए।

विवरण: Plugins

त्वरित setup (शुरुआती)

सुनिश्चित करें कि plugin उपलब्ध है

मौजूदा packaged OpenClaw रिलीज़ इसे पहले से bundle करती हैं। पुराने/custom installs ऊपर दिए गए commands से इसे मैन्युअल रूप से जोड़ सकते हैं।

Twitch bot खाता बनाएं

bot के लिए एक dedicated Twitch खाता बनाएं (या मौजूदा खाते का उपयोग करें)।

credentials जनरेट करें

Twitch Token Generator का उपयोग करें:

Bot Token चुनें
सत्यापित करें कि scopes chat:read और chat:write चुने गए हैं
Client ID और Access Token कॉपी करें

अपना Twitch user ID खोजें

username को Twitch user ID में बदलने के लिए https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/ का उपयोग करें।

token configure करें

Env: OPENCLAW_TWITCH_ACCESS_TOKEN=... (केवल default account)
या config: channels.twitch.accessToken

यदि दोनों सेट हैं, तो config को प्राथमिकता मिलती है (env fallback केवल default-account के लिए है)।

gateway शुरू करें

configured channel के साथ gateway शुरू करें।

न्यूनतम config:

json5

{  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/    },  },}

यह क्या है

Gateway के स्वामित्व वाला Twitch channel।
Deterministic routing: replies हमेशा Twitch पर वापस जाते हैं।
प्रत्येक account एक isolated session key agent:<agentId>:twitch:<accountName> से map होता है।
username bot का account है (जो authenticate करता है), channel वह chat room है जिसमें शामिल होना है।

Setup (विस्तृत)

credentials जनरेट करें

Twitch Token Generator का उपयोग करें:

Bot Token चुनें
सत्यापित करें कि scopes chat:read और chat:write चुने गए हैं
Client ID और Access Token कॉपी करें

bot configure करें

Env var (केवल default account)

bash

OPENCLAW_TWITCH_ACCESS_TOKEN=oauth:abc123...

Config

json5

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

यदि env और config दोनों सेट हैं, तो config को प्राथमिकता मिलती है।

Access control (अनुशंसित)

json5

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

कड़े allowlist के लिए allowFrom को प्राथमिकता दें। यदि आप role-based access चाहते हैं, तो इसके बजाय allowedRoles का उपयोग करें।

उपलब्ध roles: "moderator", "owner", "vip", "subscriber", "all".

Token refresh (वैकल्पिक)

Twitch Token Generator के tokens अपने आप refresh नहीं किए जा सकते - expire होने पर regenerate करें।

automatic token refresh के लिए, Twitch Developer Console पर अपना Twitch application बनाएं और config में जोड़ें:

json5

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

bot expiration से पहले अपने आप tokens refresh करता है और refresh events log करता है।

Multi-account support

प्रत्येक account के tokens के साथ channels.twitch.accounts का उपयोग करें। shared pattern के लिए Configuration देखें।

उदाहरण (दो channels में एक bot account):

json5

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

Access control

User ID allowlist (सबसे सुरक्षित)

json5

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

Role-based

json5

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

allowFrom एक कड़ा allowlist है। सेट होने पर, केवल वे user IDs allowed होते हैं। यदि आप role-based access चाहते हैं, तो allowFrom को unset छोड़ें और इसके बजाय allowedRoles configure करें।

@mention requirement disable करें

default रूप से, requireMention true है। disable करने और सभी messages का जवाब देने के लिए:

json5

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

Troubleshooting

पहले, diagnostic commands चलाएं:

bash

openclaw doctoropenclaw channels status --probe

Bot messages का जवाब नहीं देता

Access control जांचें: सुनिश्चित करें कि आपका user ID allowFrom में है, या test करने के लिए अस्थायी रूप से allowFrom हटाएं और allowedRoles: ["all"] सेट करें।
जांचें कि bot channel में है: bot को channel में निर्दिष्ट channel से जुड़ना होगा।

Token समस्याएं

"Failed to connect" या authentication errors:

सत्यापित करें कि accessToken OAuth access token value है (आमतौर पर oauth: prefix से शुरू होता है)
जांचें कि token में chat:read और chat:write scopes हैं
यदि token refresh का उपयोग कर रहे हैं, तो सत्यापित करें कि clientSecret और refreshToken सेट हैं

Token refresh काम नहीं कर रहा

refresh events के लिए logs जांचें:

Code

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

यदि आपको "token refresh disabled (no refresh token)" दिखता है:

सुनिश्चित करें कि clientSecret दिया गया है
सुनिश्चित करें कि refreshToken दिया गया है

Config

Account config

usernamestring

Bot username.

accessTokenstring

chat:read और chat:write के साथ OAuth access token.

clientIdstring

Twitch Client ID (Token Generator या आपके app से).

channelstringrequired

जुड़ने वाला channel.

enabledbooleandefault: true

इस account को enable करें.

clientSecretstring

वैकल्पिक: automatic token refresh के लिए.

refreshTokenstring

वैकल्पिक: automatic token refresh के लिए.

expiresInnumber

seconds में token expiry.

obtainmentTimestampnumber

Token प्राप्त होने का timestamp.

allowFromstring[]

User ID allowlist.

allowedRoles'Array<"moderator"

requireMentionbooleandefault: true

@mention आवश्यक करें.

Provider options

channels.twitch.enabled - channel startup enable/disable करें
channels.twitch.username - Bot username (simplified single-account config)
channels.twitch.accessToken - OAuth access token (simplified single-account config)
channels.twitch.clientId - Twitch Client ID (simplified single-account config)
channels.twitch.channel - जुड़ने वाला channel (simplified single-account config)
channels.twitch.accounts.<accountName> - Multi-account config (ऊपर दिए गए सभी account fields)

पूर्ण उदाहरण:

json5

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

Tool actions

agent twitch को action के साथ call कर सकता है:

send - channel को message भेजें

उदाहरण:

json5

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

सुरक्षा और ops

tokens को passwords की तरह मानें — tokens को कभी git में commit न करें।
लंबे समय तक चलने वाले bots के लिए automatic token refresh का उपयोग करें।
access control के लिए usernames के बजाय user ID allowlists का उपयोग करें।
token refresh events और connection status के लिए logs monitor करें।
tokens को न्यूनतम scope दें — केवल chat:read और chat:write request करें।
यदि अटके हों: यह पुष्टि करने के बाद gateway restart करें कि कोई अन्य process session का स्वामी नहीं है।

सीमाएं

प्रति message 500 characters (word boundaries पर auto-chunked).
chunking से पहले Markdown हटा दिया जाता है।
कोई rate limiting नहीं (Twitch की built-in rate limits का उपयोग करता है).

Twitch

बंडल किया गया plugin

npm registry

Local checkout

त्वरित setup (शुरुआती)

सुनिश्चित करें कि plugin उपलब्ध है

Twitch bot खाता बनाएं

credentials जनरेट करें

अपना Twitch user ID खोजें

token configure करें

gateway शुरू करें

यह क्या है

Setup (विस्तृत)

credentials जनरेट करें

bot configure करें

Env var (केवल default account)

Config

Access control (अनुशंसित)

Token refresh (वैकल्पिक)

Multi-account support

Access control

User ID allowlist (सबसे सुरक्षित)

Role-based

@mention requirement disable करें

Troubleshooting

Config

Account config

Provider options

Tool actions

सुरक्षा और ops

सीमाएं

संबंधित

On this page

Molty