Twitch

​

التثبيت

openclaw plugins install @openclaw/twitch

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

​

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

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:).

​

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

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

​

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

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

​

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

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

​

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

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

​

الحدود

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

​

ذو صلة

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