المتطلبات الأساسية
- حساب Discord
- خادم Discord حيث تمتلك صلاحية Manage Server
- مثيل Claw (أنشئ واحداً هنا)
دليل الإعداد
إنشاء تطبيق Discord
- انتقل إلى Discord Developer Portal
- انقر فوق New Application
- امنحه اسماً (على سبيل المثال، “My AI Bot”) وانقر فوق Create
إنشاء Bot
- في تطبيقك، انتقل إلى علامة التبويب Bot
- انقر فوق Add Bot ← Yes, do it!
- ضمن Privileged Gateway Intents، قم بتمكين:
- Message Content Intent (مطلوب)
- Server Members Intent (موصى به)
- انقر فوق Reset Token لإنشاء bot token
- انسخ الـ token — ستحتاج إليه في الخطوة التالية
دعوة الـ Bot إلى خادمك
- انتقل إلى علامة التبويب OAuth2 ← URL Generator
- ضمن Scopes، حدد:
botوapplications.commands - ضمن Bot Permissions، حدد:
Send MessagesوRead Message History - انسخ عنوان URL الذي تم إنشاؤه وافتحه في متصفحك
- حدد خادمك وانقر فوق Authorize
التكوين في لوحة تحكم LemonData
- انتقل إلى Claw Dashboard
- انقر فوق أيقونة الإعدادات في مثيلك
- افتح علامة التبويب IM Integrations
- قم بتوسيع قسم Discord
- قم بلصق الـ Bot Token الخاص بك
- انقر فوق Save
الاستخدام في الخوادم
إعدادات المجموعة
قم بتكوين سلوك الخادم (guild) في علامة التبويب IM Integrations في لوحة التحكم الخاصة بك:| الإعداد | الخيارات | الوصف |
|---|---|---|
| Group Policy | مفتوح (افتراضي) / Allowlist / معطل | يتحكم في الوصول إلى قنوات الخادم |
| Require @mention | تشغيل / إيقاف | يستجيب الـ Bot فقط عند الإشارة إليه بـ @mention (موصى به) |
| Group IDs | قائمة بمعرفات guild IDs | التقييد بخوادم معينة (فارغ = جميع الخوادم) |
يستخدم Discord قوائم سماح (allowlists) للمستخدمين لكل guild بدلاً من قائمة سماح عالمية للمجموعات. لتصفية المستخدمين المتقدمة لكل guild، قم بالتكوين مباشرة في ملف تكوين OpenClaw.
سياسة الرسائل المباشرة (DM Policy)
التحكم في من يمكنه إرسال رسائل مباشرة إلى الـ bot الخاص بك:| السياسة | السلوك |
|---|---|
| Pairing (افتراضي) | يحصل المستخدمون الجدد على رمز إقران — أدخله في WebUI للمصرحة |
| Allowlist | فقط معرفات المستخدمين (user IDs) التي تحددها يمكنها إرسال رسائل مباشرة إلى الـ bot |
| Open | يمكن لأي شخص إرسال رسائل مباشرة إلى الـ bot (استخدمه بحذر) |
استكشاف الأخطاء وإصلاحها
الـ Bot متصل بالإنترنت ولكنه لا يستجيب
الـ Bot متصل بالإنترنت ولكنه لا يستجيب
- تأكد من تمكين Message Content Intent في Developer Portal
- تحقق من صحة bot token
- تحقق من أن الـ bot لديه إذن لقراءة وإرسال الرسائل في القناة
يظهر الـ Bot كغير متصل
يظهر الـ Bot كغير متصل
- تحقق من حالة مثيلك في لوحة التحكم (يجب أن تكون خضراء/قيد التشغيل)
- حاول إعادة تشغيل المثيل
- تحقق من عدم إعادة تعيين الـ token في Developer Portal
أخطاء 409 Conflict في السجلات
أخطاء 409 Conflict في السجلات
- يحدث هذا عندما يحاول مثيلان استخدام نفس bot token
- تأكد من تكوين مثيل Claw واحد فقط بهذا الـ token