Twitch

دعم دردشة Twitch عبر واجهة الدردشة (IRC) الخاصة بـ Twitch باستخدام عميل Twurple. يسجّل OpenClaw الدخول بحساب روبوت Twitch، وينضم إلى قناة واحدة لكل حساب مُعدّ، ويرد في تلك القناة.

التثبيت

يُوزَّع Twitch بصفته Plugin رسميًا؛ وهو ليس جزءًا من التثبيت الأساسي.

openclaw plugins install @openclaw/twitch

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

يسجّل plugins install الـ Plugin ويفعّله. يؤدي اختيار Twitch أثناء openclaw onboard أو openclaw channels add إلى تثبيته عند الطلب. استخدم اسم الحزمة المجرّد لمتابعة الإصدار الحالي؛ ولا تثبّت إصدارًا محددًا بدقة إلا لعمليات التثبيت القابلة لإعادة الإنتاج. يتطلب OpenClaw 2026.4.10 أو إصدارًا أحدث.

التفاصيل: Plugins

الإعداد السريع

openclaw gateway run

الحد الأدنى للإعداد:

{  channels: {    twitch: {      enabled: true,      username: "openclaw", // Bot's Twitch account (authenticates)      accessToken: "oauth:abc123...", // OAuth access token (or use OPENCLAW_TWITCH_ACCESS_TOKEN env var)      clientId: "xyz789...", // Client ID from Token Generator      channel: "yourchannel", // Which Twitch channel's chat to join (required)      allowFrom: ["123456789"], // (recommended) Your Twitch user ID only    },  },}

ماهيته

• قناة Twitch يملكها Gateway.
• توجيه حتمي: تعود الردود دائمًا إلى قناة Twitch التي وردت منها الرسالة.
• ترتبط كل قناة منضم إليها بمفتاح جلسة مجموعة معزول agent:<agentId>:twitch:group:<channel>.
• يمثّل username حساب الروبوت (الذي يجري المصادقة)، بينما يحدد channel غرفة الدردشة المطلوب الانضمام إليها. ينضم كل إدخال حساب إلى قناة واحدة بالضبط.
• تعمل الرموز مع البادئة oauth: أو من دونها؛ يطبّع OpenClaw الصيغتين (ويتوقع معالج الإعداد الصيغة التي تتضمن oauth:).

تحديث الرمز (اختياري)

لا يستطيع OpenClaw تحديث الرموز الصادرة من مولّد رموز Twitch؛ أنشئها مجددًا عند انتهاء صلاحيتها (تدوم بضع ساعات، ولا يلزم تسجيل تطبيق).

للتحديث التلقائي، أنشئ تطبيقك الخاص في لوحة مطوري Twitch وأضف:

{  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. عند ضبطه، يُتجاهل 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

Using env token source for mybotAccess token refreshed for user 123456 (expires in 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"],        },      },    },  },}

إجراءات الأداة

يمكن للوكيل إرسال رسائل Twitch عبر الإجراء send لأداة الرسائل:

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

الحقل to اختياري، وتكون قيمته الافتراضية channel المضبوطة للحساب.

الأمان والتشغيل

• تعامل مع الرموز مثل كلمات المرور - لا تُثبّت الرموز أبدًا في git.
• استخدم التحديث التلقائي للرمز للروبوتات التي تعمل لفترات طويلة.
• استخدم قوائم السماح لمعرّفات المستخدمين بدلًا من أسماء المستخدمين للتحكم في الوصول.
• راقب السجلات لمتابعة أحداث تحديث الرمز وحالة الاتصال.
• قلّل نطاقات الرموز إلى الحد الأدنى - لا تطلب سوى chat:read وchat:write.
• إذا تعذّر عليك المتابعة: أعد تشغيل Gateway بعد التأكد من عدم امتلاك أي عملية أخرى للجلسة.

الحدود

• 500 حرف لكل رسالة؛ تُقسّم الردود الأطول عند حدود الكلمات.
• تُزال صياغة Markdown قبل الإرسال (دردشة Twitch نص عادي؛ وتتحول الأسطر الجديدة إلى مسافات).
• لا يضيف OpenClaw أي تقييد لمعدل الطلبات من جانبه؛ يتولى عميل دردشة Twurple معالجة حدود معدل Twitch.

ذو صلة

• توجيه القنوات — توجيه جلسات الرسائل
• نظرة عامة على القنوات — جميع القنوات المدعومة
• المجموعات — سلوك دردشة المجموعات وبوابة الإشارة
• الاقتران — مصادقة الرسائل المباشرة وتدفق الاقتران
• الأمان — نموذج الوصول والتعزيز الأمني