​

Twitch

​

Plugin مضمّن

openclaw plugins install @openclaw/twitch

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

​

إعداد سريع (للمبتدئين)

1. تأكد من أن plugin الخاص بـ Twitch متاح.
   • تتضمنه إصدارات OpenClaw المجمعة الحالية بالفعل.
   • يمكن لعمليات التثبيت الأقدم/المخصصة إضافته يدويًا بالأوامر أعلاه.
2. أنشئ حساب Twitch مخصصًا للروبوت (أو استخدم حسابًا موجودًا).
3. أنشئ بيانات الاعتماد: Twitch Token Generator
   • اختر Bot Token
   • تحقق من تحديد النطاقين chat:read وchat:write
   • انسخ Client ID وAccess Token
4. اعثر على معرّف مستخدم Twitch الخاص بك: https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/
5. اضبط الرمز المميز:
   • متغير البيئة: OPENCLAW_TWITCH_ACCESS_TOKEN=... (للحساب الافتراضي فقط)
   • أو التكوين: channels.twitch.accessToken
   • إذا تم تعيين الاثنين، تكون أولوية التكوين أعلى (والرجوع إلى env للحساب الافتراضي فقط).
6. ابدأ gateway.

{
  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 هي غرفة الدردشة المطلوب الانضمام إليها.

​

الإعداد (تفصيلي)

​

إنشاء بيانات الاعتماد

• اختر 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
    },
  },
}

​

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

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

​

دعم الحسابات المتعددة

{
  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: {
          allowedRoles: ["moderator", "vip"],
        },
      },
    },
  },
}

​

قائمة سماح حسب معرّف المستخدم (الأكثر أمانًا)

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

​

وصول قائم على الأدوار (بديل)

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

​

تعطيل شرط @mention

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

​

استكشاف الأخطاء وإصلاحها

openclaw doctor
openclaw channels status --probe

​

الروبوت لا يرد على الرسائل

​

مشكلات الرمز المميز

• تحقق من أن accessToken هو قيمة OAuth access token (ويبدأ عادةً بالبادئة oauth:)
• تحقق من أن الرمز المميز يملك النطاقين chat:read وchat:write
• إذا كنت تستخدم تحديث الرمز المميز، فتأكد من تعيين clientSecret وrefreshToken

​

تحديث الرمز المميز لا يعمل

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

• تأكد من توفير clientSecret
• تأكد من توفير refreshToken

​

التكوين

• username - اسم مستخدم الروبوت
• accessToken - OAuth access token مع chat:read وchat:write
• clientId - Twitch Client ID (من Token Generator أو من تطبيقك)
• channel - القناة المطلوب الانضمام إليها (مطلوب)
• enabled - تمكين هذا الحساب (الافتراضي: true)
• clientSecret - اختياري: لتحديث الرمز المميز تلقائيًا
• refreshToken - اختياري: لتحديث الرمز المميز تلقائيًا
• expiresIn - انتهاء صلاحية الرمز المميز بالثواني
• obtainmentTimestamp - الطابع الزمني للحصول على الرمز المميز
• allowFrom - قائمة سماح معرّفات المستخدمين
• allowedRoles - التحكم في الوصول القائم على الأدوار ("moderator" | "owner" | "vip" | "subscriber" | "all")
• requireMention - طلب @mention (الافتراضي: true)

• channels.twitch.enabled - تمكين/تعطيل بدء تشغيل القناة
• channels.twitch.username - اسم مستخدم الروبوت (تكوين مبسط لحساب واحد)
• channels.twitch.accessToken - OAuth access token (تكوين مبسط لحساب واحد)
• 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"],
        },
      },
    },
  },
}

​

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

• send - إرسال رسالة إلى قناة

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

​

السلامة والعمليات

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

​

الحدود

• 500 حرف لكل رسالة (مع تجزئة تلقائية عند حدود الكلمات)
• تتم إزالة Markdown قبل التجزئة
• لا يوجد تحديد لمعدل الطلبات (يستخدم حدود المعدل المضمنة في Twitch)

​

ذو صلة

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