تكامل Clawdbot مع Discord

نظرة عامة على تكامل Clawdbot مع Discord

يتيح لك تكامل Clawdbot مع Discord جلب المساعدة المدعومة بالذكاء الاصطناعي إلى خوادم Discord الخاصة بك باستخدام بوابة بوت Discord الرسمية. هذا جاهز للرسائل الخاصة وقنوات النصوص في النقابات.

لماذا تستخدم Clawdbot مع Discord؟

Discord هي المنصة الرائدة للألعاب والتواصل المجتمعي. يوفر تكامل Clawdbot مع Discord:

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

1. أنشئ بوت Discord وانسخ رمز البوت
2. في إعدادات تطبيق Discord، قم بتمكين Message Content Intent (و Server Members Intent إذا لزم الأمر)
3. اضبط الرمز عبر env (DISCORD_BOT_TOKEN=...) أو config (channels.discord.token)
4. ادعُ البوت إلى خادمك مع أذونات الرسائل
5. ابدأ البوابة
6. الوصول عبر الرسائل الخاصة هو الاقتران افتراضياً؛ وافق على رمز الاقتران عند الاتصال الأول

الحد الأدنى من التكوين:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

إعداد Clawdbot Discord

المتطلبات الأساسية

قبل توصيل Clawdbot بـ Discord، تأكد من أن لديك:

• تم تثبيت Clawdbot على جهازك
• حساب Discord
• الوصول إلى بوابة مطوري Discord
• أذونات مسؤول الخادم

الخطوة 1: إنشاء تطبيق Discord

قم بإعداد تطبيق Clawdbot Discord الخاص بك:

1. اذهب إلى بوابة مطوري Discord
2. انقر على "New Application"
3. في تطبيقك: Bot → Add Bot
4. انسخ رمز البوت

الخطوة 2: تمكين نوايا البوابة

قم بتمكين النوايا التي يحتاجها Clawdbot:

• Message Content Intent — مطلوب لقراءة محتوى الرسائل
• Server Members Intent — مطلوب للقوائم المسموح بها أو البحث عن الأسماء

الخطوة 3: إنشاء رابط الدعوة

استخدم مولد URL OAuth2 في بوابة المطورين:

الأذونات المطلوبة لـ Clawdbot Discord:

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

الخطوة 4: تكوين Clawdbot Discord

أضف بوت Discord الخاص بك إلى Clawdbot:

متغير البيئة:

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

ملف التكوين (~/.clawdbot/clawdbot.json):

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

إذا تم تعيين كل من env و config، فإن config له الأسبقية.

الخطوة 5: بدء البوابة

clawdbot gateway --port 18789

يبدأ Discord تلقائياً عندما يكون الرمز متاحاً و channels.discord.enabled ليس false.

الخطوة 6: التحقق من الاتصال

تحقق من حالة Clawdbot Discord الخاص بك:

clawdbot channels status discord

كيف يعمل

• تنهار الدردشات المباشرة في الجلسة الرئيسية للوكيل (افتراضياً agent:main:main)
• تبقى قنوات النقابة معزولة كـ agent:<agentId>:discord:channel:<channelId>
• يتم تجاهل رسائل DM الجماعية افتراضياً؛ قم بالتمكين عبر channels.discord.dm.groupEnabled
• التوجيه حتمي: تعود الردود دائماً إلى القناة التي وصلت منها

ميزات Clawdbot Discord

التحكم في الوصول عبر الرسائل الخاصة

الدردشات المباشرة آمنة افتراضياً عبر channels.discord.dm.policy:

مثال (قائمة مسموح بها صارمة):

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

تكوين قنوات النقابة

اضبط قواعد لكل نقابة أو لكل قناة:

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

أوامر Slash

يدعم Clawdbot Discord أوامر slash الأصلية:

الأوامر الأصلية افتراضياً "auto" (مفعلة لـ Discord/Telegram). تجاوز بـ:

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

سجل سياق النقابة

اضبط channels.discord.historyLimit (افتراضي 20) لتضمين آخر N رسالة من النقابة كسياق عند الرد على إشارة. اضبط 0 للتعطيل.

التفاعلات

يمكن للوكيل تشغيل التفاعلات عبر أداة discord (مقيدة بـ channels.discord.actions.*).

تكوين Clawdbot Discord

مثال تكوين كامل

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

كتابات التكوين

افتراضياً، يُسمح لـ Discord بكتابة تحديثات التكوين التي يتم تشغيلها بواسطة /config set|unset. عطّل بـ:

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

تخزين بيانات اعتماد Clawdbot Discord

يخزن Clawdbot بيانات اعتماد Discord بأمان:

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

تبقى بيانات Clawdbot Discord الخاصة بك على جهازك المحلي.

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

البوت غير متصل

إذا ظهر Clawdbot Discord غير متصل:

1. تحقق من الرمز: clawdbot channels verify discord
2. تحقق من اتصال البوابة
3. راجع السجلات: cat /tmp/clawdbot/discord.log

أوامر Slash لا تعمل

إذا فشلت أوامر slash في Clawdbot Discord:

1. أعد تسجيل الأوامر عبر التكوين
2. تحقق من أذونات البوت
3. تحقق من تسجيل الأوامر الخاصة بالخادم

أخطاء الأذونات

إذا كان Clawdbot Discord يفتقر إلى الأذونات:

1. راجع موضع دور البوت في إعدادات الخادم
2. تحقق من الأذونات الخاصة بالقناة
3. أعد الدعوة بالأذونات الصحيحة

تحليل الأسماء

يستخدم تحليل الاسم → المعرف بحث أعضاء النقابة ويتطلب Server Members Intent. إذا لم يتمكن البوت من البحث عن الأعضاء، استخدم المعرفات أو إشارات <@id>.

أفضل ممارسات Clawdbot Discord

1. استخدم وضع الاقتران: آمن افتراضياً مع رموز الاقتران للرسائل الخاصة
2. حدد قيود القنوات: قيّد Clawdbot Discord على القنوات المناسبة
3. كوّن الأدوار: استخدم الوصول المستند إلى الأدوار لـ Clawdbot Discord
4. راقب النشاط: راجع سجلات Clawdbot Discord بانتظام
5. استخدم أوامر Slash: تجربة مستخدم أفضل من الأوامر النصية

حالات استخدام Clawdbot Discord

دعم المجتمع

انشر Clawdbot Discord كبوت دعم:

• أجب عن الأسئلة الشائعة تلقائياً
• صعّد المشاكل المعقدة
• وفّر مساعدة على مدار الساعة

مجتمعات الألعاب

استخدم Clawdbot Discord لخوادم الألعاب:

• البحث عن معلومات الألعاب
• تنسيق الفرق
• جدولة الأحداث

مجتمعات المطورين

Clawdbot Discord لخوادم المطورين:

• المساعدة في الكود
• البحث في الوثائق
• فرز الأخطاء

الخطوات التالية

• تكامل Clawdbot مع WhatsApp - قم بتوصيل Clawdbot بـ WhatsApp
• تكامل Clawdbot مع Telegram - قم بإعداد Clawdbot على Telegram
• دليل إعداد Clawdbot - دليل التثبيت الكامل