Twitch

Twurple क्लाइंट के माध्यम से Twitch के चैट (IRC) इंटरफ़ेस पर Twitch चैट समर्थन। OpenClaw एक Twitch बॉट खाते के रूप में साइन इन करता है, प्रत्येक कॉन्फ़िगर किए गए खाते के लिए एक चैनल से जुड़ता है और उसी चैनल में उत्तर देता है।

इंस्टॉल करें

Twitch एक आधिकारिक Plugin के रूप में उपलब्ध है; यह मुख्य इंस्टॉलेशन का हिस्सा नहीं है।

openclaw plugins install @openclaw/twitch

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

plugins install Plugin को पंजीकृत और सक्षम करता है। openclaw onboard या openclaw channels add के दौरान Twitch चुनने पर इसे आवश्यकता के अनुसार इंस्टॉल किया जाता है। वर्तमान रिलीज़ का अनुसरण करने के लिए केवल पैकेज नाम का उपयोग करें; पुनरुत्पाद्य इंस्टॉलेशन के लिए ही कोई सटीक संस्करण पिन करें। OpenClaw 2026.4.10 या उसके बाद का संस्करण आवश्यक है।

विवरण: Plugins

त्वरित सेटअप

openclaw gateway run

न्यूनतम कॉन्फ़िगरेशन:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // बॉट का Twitch खाता (प्रमाणीकरण करता है)      accessToken: "oauth:abc123...", // OAuth अभिगम टोकन (या OPENCLAW_TWITCH_ACCESS_TOKEN परिवेश चर का उपयोग करें)      clientId: "xyz789...", // Token Generator से Client ID      channel: "yourchannel", // किस Twitch चैनल की चैट से जुड़ना है (आवश्यक)      allowFrom: ["123456789"], // (अनुशंसित) केवल आपकी Twitch उपयोगकर्ता ID    },  },}

यह क्या है

• Gateway के स्वामित्व वाला एक Twitch चैनल।
• नियतात्मक रूटिंग: उत्तर हमेशा उसी Twitch चैनल पर वापस जाते हैं जहाँ से संदेश आया था।
• जुड़ा हुआ प्रत्येक चैनल एक पृथक समूह सत्र कुंजी agent:<agentId>:twitch:group:<channel> से मैप होता है।
• username बॉट का खाता है (जो प्रमाणीकरण करता है), channel वह चैट रूम है जिससे जुड़ना है। प्रत्येक खाता प्रविष्टि ठीक एक चैनल से जुड़ती है।
• टोकन oauth: उपसर्ग के साथ या उसके बिना काम करते हैं; OpenClaw दोनों रूपों को सामान्यीकृत करता है (सेटअप विज़ार्ड oauth: रूप की अपेक्षा करता है)।

इनबाउंड टिकाऊपन

OpenClaw सामान्य प्रेषण से पहले स्वीकार किए गए प्रत्येक Twitch चैट संदेश को टिकाऊ रूप से कतारबद्ध करता है। लंबित या पुनः प्रयास योग्य संदेश Gateway के पुनः आरंभ होने के बाद भी बने रहते हैं, कॉन्फ़िगर किए गए चैनल के लिए क्रमबद्ध रहते हैं और सक्रिय या संरक्षित पूर्णता रिकॉर्ड मौजूद रहने तक डुप्लिकेट कतार प्रविष्टियों को रोकने के लिए Twitch की संदेश ID का उपयोग करते हैं।

क्लाइंट द्वारा स्वीकार किए जाने के बाद Twitch चैट किसी PRIVMSG को दोबारा नहीं भेजती। यह स्थानीय स्वीकार-से-प्रेषण क्रैश अवधि से सुरक्षा देता है, लेकिन टिकाऊ स्वीकृति से पहले छूटे संदेशों को पुनर्प्राप्त नहीं कर सकता। यदि कतार में जोड़ना ही विफल हो जाए, तो OpenClaw विफलता को लॉग करता है; दोबारा कनेक्ट होने पर Twitch से उस संदेश को पुनः भेजने का अनुरोध नहीं किया जाता।

टोकन रीफ़्रेश (वैकल्पिक)

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 उपयोगकर्ता ID की कठोर अनुमति-सूची है। इसे सेट करने पर 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 के लिए अभिगम टोकन रीफ़्रेश किया गया (14400s में समाप्त होगा)

कॉन्फ़िगरेशन

खाता कॉन्फ़िगरेशन

प्रदाता विकल्प

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

टूल क्रियाएँ

एजेंट संदेश टूल की send क्रिया के माध्यम से Twitch संदेश भेज सकता है:

{  channel: "twitch",  action: "send",  to: "#mychannel",  message: "नमस्ते Twitch!",}

to वैकल्पिक है और इसका डिफ़ॉल्ट मान खाते का कॉन्फ़िगर किया गया channel है।

सुरक्षा और संचालन

• टोकन को पासवर्ड की तरह मानें - टोकन को कभी भी git में कमिट न करें।
• लंबे समय तक चलने वाले बॉट के लिए स्वचालित टोकन रिफ़्रेश का उपयोग करें।
• एक्सेस नियंत्रण के लिए उपयोगकर्ता नामों के बजाय उपयोगकर्ता ID की अनुमतिसूचियों का उपयोग करें।
• टोकन रिफ़्रेश घटनाओं और कनेक्शन स्थिति के लिए लॉग की निगरानी करें।
• टोकन का दायरा न्यूनतम रखें - केवल chat:read और chat:write का अनुरोध करें।
• यदि अटक जाएँ: यह पुष्टि करने के बाद Gateway को पुनः आरंभ करें कि सत्र का स्वामी कोई अन्य प्रोसेस नहीं है।

सीमाएँ

• प्रति संदेश 500 वर्ण; लंबे उत्तरों को शब्द सीमाओं पर खंडों में बाँटा जाता है।
• भेजने से पहले Markdown हटा दिया जाता है (Twitch चैट सादा टेक्स्ट है; नई पंक्तियाँ रिक्त स्थान में बदल जाती हैं)।
• OpenClaw स्वयं कोई दर सीमा लागू नहीं करता; Twurple चैट क्लाइंट Twitch की दर सीमाओं को संभालता है।

संबंधित

• चैनल रूटिंग — संदेशों के लिए सत्र रूटिंग
• चैनलों का अवलोकन — सभी समर्थित चैनल
• समूह — समूह चैट का व्यवहार और उल्लेख नियंत्रण
• पेयरिंग — DM प्रमाणीकरण और पेयरिंग प्रवाह
• सुरक्षा — एक्सेस मॉडल और सुरक्षा सुदृढ़ीकरण