Discord

يدعم Discord وسوم الرد في مخرجات الوكيل:

• [[reply_to_current]]
• [[reply_to:<id>]]

يتم التحكم فيه عبر channels.discord.replyToMode:

• off (الافتراضي)
• first
• all
• batched

ملاحظة: يعطل off تسلسل الردود الضمني. تظل وسوم [[reply_to_*]] الصريحة محترمة. يرفق first دائما مرجع الرد الأصلي الضمني بأول رسالة صادرة إلى Discord في الدور. يرفق batched مرجع الرد الأصلي الضمني الخاص بـ Discord فقط عندما يكون الدور الوارد دفعة مؤجلة من عدة رسائل. يكون هذا مفيدا عندما تريد الردود الأصلية أساسا للمحادثات المتدفقة الغامضة، وليس لكل دور برسالة واحدة.

تعرض معرفات الرسائل في السياق/السجل حتى تتمكن الوكلاء من استهداف رسائل محددة.

يمكن لـ OpenClaw بث مسودات الردود بإرسال رسالة مؤقتة وتعديلها مع وصول النص. يأخذ channels.discord.streaming القيم off | partial | block | progress (الافتراضي). يحافظ progress على مسودة حالة واحدة قابلة للتحرير ويحدثها بتقدم الأدوات حتى التسليم النهائي؛ وstreamMode اسم مستعار قديم وقت التشغيل. شغل openclaw doctor --fix لإعادة كتابة الإعدادات المحفوظة إلى المفتاح القياسي.

اضبط channels.discord.streaming.mode على off لتعطيل تعديلات معاينة Discord. إذا تم تفعيل بث الكتل في Discord صراحة، يتخطى OpenClaw بث المعاينة لتجنب البث المزدوج.

{
channels: {
discord: {
  streaming: {
    mode: "progress",
    progress: {
      label: "auto",
      maxLines: 8,
      toolProgress: true,
    },
  },
},
},
}

• يعدل partial رسالة معاينة واحدة مع وصول الرموز.
• يصدر block مقاطع بحجم مسودة (استخدم draftChunk لضبط الحجم ونقاط الفصل، مع تقييدها بـ textChunkLimit).
• تلغي النهائيات التي تحتوي على وسائط أو خطأ أو رد صريح تعديلات المعاينة المعلقة.
• يتحكم streaming.preview.toolProgress (افتراضيا true) فيما إذا كانت تحديثات الأداة/التقدم تعيد استخدام رسالة المعاينة.
• يتحكم streaming.preview.commandText / streaming.progress.commandText في تفاصيل الأمر/التنفيذ ضمن أسطر التقدم الموجزة: raw (الافتراضي) أو status (تسمية الأداة فقط).

إخفاء نص الأمر/التنفيذ الخام مع الإبقاء على أسطر التقدم الموجزة:

{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

بث المعاينة نصي فقط؛ تعود ردود الوسائط إلى التسليم العادي. عند تفعيل بث block صراحة، يتخطى OpenClaw بث المعاينة لتجنب البث المزدوج.

سياق سجل الخادم:

• القيمة الافتراضية لـ channels.discord.historyLimit هي 20
• الاحتياطي: messages.groupChat.historyLimit
• يعطل 0

عناصر التحكم في سجل الرسائل المباشرة:

• channels.discord.dmHistoryLimit
• channels.discord.dms["<user_id>"].historyLimit

سلوك السلاسل:

• توجه سلاسل Discord كجلسات قناة وترث إعدادات القناة الأصلية ما لم يتم تجاوزها.
• ترث جلسات السلاسل اختيار /model على مستوى جلسة القناة الأصلية كاحتياطي للنموذج فقط؛ ما تزال اختيارات /model المحلية للسلسلة لها الأولوية ولا ينسخ سجل النصوص من الأصل إلا إذا تم تفعيل وراثة النصوص.
• يختار channels.discord.thread.inheritParent (افتراضيا false) السلاسل التلقائية الجديدة للبذر من نص الأصل. توجد التجاوزات لكل حساب ضمن channels.discord.accounts.<id>.thread.inheritParent.
• يمكن لتفاعلات أداة الرسائل حل أهداف الرسائل المباشرة user:<id>.
• يتم الحفاظ على guilds.<guild>.channels.<channel>.requireMention: false أثناء احتياطي تفعيل مرحلة الرد.

تحقن موضوعات القنوات كسياق غير موثوق. تتحكم قوائم السماح بمن يمكنه تشغيل الوكيل، وليست حد تنقيح كامل للسياق الإضافي.

يستطيع Discord ربط سلسلة بهدف جلسة بحيث تستمر رسائل المتابعة في تلك السلسلة بالتوجيه إلى الجلسة نفسها (بما في ذلك جلسات الوكلاء الفرعيين).

الأوامر:

• /focus <target> ربط السلسلة الحالية/الجديدة بهدف وكيل فرعي/جلسة
• /unfocus إزالة ربط السلسلة الحالية
• /agents عرض التشغيلات النشطة وحالة الربط
• /session idle <duration|off> فحص/تحديث إلغاء التركيز التلقائي عند عدم النشاط للروابط المركزة
• /session max-age <duration|off> فحص/تحديث الحد الأقصى الصارم للعمر للروابط المركزة

الإعدادات:

{
session: {
threadBindings: {
  enabled: true,
  idleHours: 24,
  maxAgeHours: 0,
},
},
channels: {
discord: {
  threadBindings: {
    enabled: true,
    idleHours: 24,
    maxAgeHours: 0,
    spawnSessions: true,
    defaultSpawnContext: "fork",
  },
},
},
}

ملاحظات:

• يضبط session.threadBindings.* الافتراضيات العامة.
• يتجاوز channels.discord.threadBindings.* سلوك Discord.
• يتحكم spawnSessions في إنشاء/ربط السلاسل تلقائيا لـ sessions_spawn({ thread: true }) وعمليات إنشاء سلاسل ACP. الافتراضي: true.
• يتحكم defaultSpawnContext في سياق الوكيل الفرعي الأصلي لعمليات الإنشاء المرتبطة بالسلاسل. الافتراضي: "fork".
• يتم ترحيل مفاتيح spawnSubagentSessions/spawnAcpSessions المهملة بواسطة openclaw doctor --fix.
• إذا كانت روابط السلاسل معطلة لحساب ما، فلن تكون /focus وعمليات ربط السلاسل ذات الصلة متاحة.

راجع الوكلاء الفرعيون، ووكلاء ACP، ومرجع الإعدادات.

لمساحات عمل ACP الثابتة "الدائمة التشغيل"، اضبط روابط ACP المكتوبة على المستوى الأعلى التي تستهدف محادثات Discord.

مسار الإعدادات:

• bindings[] مع type: "acp" وmatch.channel: "discord"

مثال:

{
agents: {
list: [
  {
    id: "codex",
    runtime: {
      type: "acp",
      acp: {
        agent: "codex",
        backend: "acpx",
        mode: "persistent",
        cwd: "/workspace/openclaw",
      },
    },
  },
],
},
bindings: [
{
  type: "acp",
  agentId: "codex",
  match: {
    channel: "discord",
    accountId: "default",
    peer: { kind: "channel", id: "222222222222222222" },
  },
  acp: { label: "codex-main" },
},
],
channels: {
discord: {
  guilds: {
    "111111111111111111": {
      channels: {
        "222222222222222222": {
          requireMention: false,
        },
      },
    },
  },
},
},
}

ملاحظات:

• يربط /acp spawn codex --bind here القناة أو السلسلة الحالية في مكانها ويحافظ على الرسائل المستقبلية في جلسة ACP نفسها. ترث رسائل السلسلة ربط القناة الأصلية.
• في قناة أو سلسلة مربوطة، يعيد /new و/reset ضبط جلسة ACP نفسها في مكانها. يمكن لروابط السلاسل المؤقتة تجاوز حل الهدف أثناء نشاطها.
• يتحكم spawnSessions في إنشاء/ربط السلاسل الفرعية عبر --thread auto|here.

راجع وكلاء ACP لتفاصيل سلوك الربط.

وضع إشعارات التفاعلات لكل خادم:

• off
• own (الافتراضي)
• all
• allowlist (يستخدم guilds.<id>.users)

تحول أحداث التفاعل إلى أحداث نظام وتلحق بجلسة Discord الموجهة.

يرسل ackReaction رمزا تعبيريا للإقرار أثناء معالجة OpenClaw لرسالة واردة.

ترتيب الحل:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• احتياطي الرمز التعبيري لهوية الوكيل (agents.list[].identity.emoji، وإلا "👀")

ملاحظات:

• يقبل Discord الرموز التعبيرية اليونيكود أو أسماء الرموز التعبيرية المخصصة.
• استخدم "" لتعطيل التفاعل لقناة أو حساب.

تكون عمليات كتابة الإعدادات التي تبدأها القناة مفعلة افتراضيا.

يؤثر هذا في تدفقات /config set|unset (عند تفعيل ميزات الأوامر).

التعطيل:

{
channels: {
discord: {
  configWrites: false,
},
},
}

وجه حركة WebSocket الخاصة ببوابة Discord وعمليات بحث REST عند بدء التشغيل (معرف التطبيق + حل قائمة السماح) عبر وكيل HTTP(S) باستخدام channels.discord.proxy.

{
channels: {
discord: {
  proxy: "http://proxy.example:8080",
},
},
}

تجاوز لكل حساب:

{
channels: {
discord: {
  accounts: {
    primary: {
      proxy: "http://proxy.example:8080",
    },
  },
},
},
}

فعل حل PluralKit لربط الرسائل الموكلة بهوية عضو النظام:

{
channels: {
discord: {
  pluralkit: {
    enabled: true,
    token: "pk_live_...", // optional; needed for private systems
  },
},
},
}

ملاحظات:

• يمكن لقوائم السماح استخدام pk:<memberId>
• لا تطابق أسماء عرض الأعضاء حسب الاسم/الاسم المختصر إلا عندما تكون channels.discord.dangerouslyAllowNameMatching: true
• تستخدم عمليات البحث معرف الرسالة الأصلي وتكون مقيدة بنافذة زمنية
• إذا فشل البحث، تعامل الرسائل الموكلة كرسائل بوت ويتم إسقاطها ما لم يكن allowBots=true

استخدم mentionAliases عندما تحتاج الوكلاء إلى إشارات صادرة حتمية لمستخدمي Discord معروفين. المفاتيح هي المعالجات دون @ البادئة؛ والقيم هي معرفات مستخدمي Discord. تبقى المعالجات غير المعروفة، و@everyone، و@here، والإشارات داخل مسافات كود Markdown دون تغيير.

{
channels: {
discord: {
  mentionAliases: {
    Vladislava: "123456789012345678",
  },
  accounts: {
    ops: {
      mentionAliases: {
        OpsLead: "234567890123456789",
      },
    },
  },
},
},
}

تطبق تحديثات الحضور عندما تضبط حقل حالة أو نشاط، أو عندما تفعل الحضور التلقائي.

مثال على الحالة فقط:

{
channels: {
discord: {
  status: "idle",
},
},
}

مثال على النشاط (الحالة المخصصة هي نوع النشاط الافتراضي):

{
channels: {
discord: {
  activity: "Focus time",
  activityType: 4,
},
},
}

مثال على البث:

{
channels: {
discord: {
  activity: "Live coding",
  activityType: 1,
  activityUrl: "https://twitch.tv/openclaw",
},
},
}

خريطة أنواع النشاط:

• 0: تشغيل
• 1: بث (يتطلب activityUrl)
• 2: استماع
• 3: مشاهدة
• 4: مخصص (يستخدم نص النشاط كحالة الحالة؛ الرمز التعبيري اختياري)
• 5: منافسة

مثال على الحضور التلقائي (إشارة صحة وقت التشغيل):

{
channels: {
discord: {
  autoPresence: {
    enabled: true,
    intervalMs: 30000,
    minUpdateIntervalMs: 15000,
    exhaustedText: "token exhausted",
  },
},
},
}

يربط الحضور التلقائي توفّر وقت التشغيل بحالة Discord: healthy => online، degraded أو unknown => idle، exhausted أو unavailable => dnd. تجاوزات النص الاختيارية:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText (يدعم العنصر النائب {reason})

يدعم Discord التعامل مع الموافقات المستندة إلى الأزرار في الرسائل الخاصة، ويمكنه اختياريًا نشر مطالبات الموافقة في القناة الأصلية.

مسار الإعداد:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (اختياري؛ يعود إلى commands.ownerAllowFrom عند الإمكان)
• channels.discord.execApprovals.target (dm | channel | both، الافتراضي: dm)
• agentFilter، وsessionFilter، وcleanupAfterResolve

يفعّل Discord تلقائيًا موافقات التنفيذ الأصلية عندما تكون enabled غير مضبوطة أو تساوي "auto" وكان يمكن حلّ موافِق واحد على الأقل، إما من execApprovals.approvers أو من commands.ownerAllowFrom. لا يستنتج Discord موافقي التنفيذ من allowFrom الخاصة بالقناة، أو dm.allowFrom القديمة، أو defaultTo للرسائل المباشرة. اضبط enabled: false لتعطيل Discord صراحةً كعميل موافقة أصلي.

بالنسبة إلى أوامر المجموعات الحساسة الخاصة بالمالك فقط، مثل /diagnostics و/export-trajectory، يرسل OpenClaw مطالبات الموافقة والنتائج النهائية بشكل خاص. يحاول أولًا استخدام رسالة Discord خاصة عندما يكون لدى المالك المستدعي مسار مالك في Discord؛ وإذا لم يكن ذلك متاحًا، فإنه يعود إلى أول مسار مالك متاح من commands.ownerAllowFrom، مثل Telegram.

عندما تكون target هي channel أو both، تكون مطالبة الموافقة مرئية في القناة. يمكن للموافقين الذين تم حلّهم فقط استخدام الأزرار؛ ويتلقى المستخدمون الآخرون رفضًا مؤقتًا. تتضمن مطالبات الموافقة نص الأمر، لذلك لا تفعّل التسليم إلى القناة إلا في القنوات الموثوقة. إذا تعذّر اشتقاق معرّف القناة من مفتاح الجلسة، يعود OpenClaw إلى التسليم عبر رسالة خاصة.

يعرض Discord أيضًا أزرار الموافقة المشتركة التي تستخدمها قنوات الدردشة الأخرى. يضيف محوّل Discord الأصلي أساسًا توجيه رسائل الموافقة الخاصة إلى الموافقين والتوزيع إلى القنوات. عند وجود هذه الأزرار، تكون هي تجربة الموافقة الأساسية؛ ويجب على OpenClaw أن يضمّن أمر /approve يدويًا فقط عندما تشير نتيجة الأداة إلى أن موافقات الدردشة غير متاحة أو أن الموافقة اليدوية هي المسار الوحيد. إذا لم يكن وقت تشغيل الموافقة الأصلي في Discord نشطًا، يبقي OpenClaw مطالبة /approve <id> <decision> المحلية الحتمية مرئية. إذا كان وقت التشغيل نشطًا ولكن تعذّر تسليم بطاقة أصلية إلى أي هدف، يرسل OpenClaw إشعار احتياط في الدردشة نفسها يتضمن أمر /approve الدقيق من الموافقة المعلّقة.

تتبع مصادقة Gateway وحلّ الموافقة عقد عميل Gateway المشترك (تُحلّ معرّفات plugin: عبر plugin.approval.resolve؛ وتُحلّ المعرّفات الأخرى عبر exec.approval.resolve). تنتهي صلاحية الموافقات بعد 30 دقيقة افتراضيًا.

راجع موافقات التنفيذ.

• فعّل Message Content Intent
• فعّل Server Members Intent عندما تعتمد على حلّ المستخدم/العضو
• أعد تشغيل Gateway بعد تغيير الأهداف

• تحقق من groupPolicy
• تحقق من قائمة السماح للخادم ضمن channels.discord.guilds
• إذا كانت خريطة channels للخادم موجودة، فلا يُسمح إلا بالقنوات المدرجة
• تحقق من سلوك requireMention وأنماط الإشارة

فحوصات مفيدة:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

الأسباب الشائعة:

• groupPolicy="allowlist" من دون قائمة سماح مطابقة للخادم/القناة
• تكوين requireMention في المكان الخطأ (يجب أن يكون ضمن channels.discord.guilds أو إدخال القناة)
• حظر المرسل بواسطة قائمة سماح users الخاصة بالخادم/القناة

السجلات المعتادة:

• Slow listener detected ...
• stuck session: sessionKey=agent:...:discord:... state=processing ...

إعدادات ضبط صف Gateway في Discord:

• حساب واحد: channels.discord.eventQueue.listenerTimeout
• حسابات متعددة: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• يتحكم هذا فقط في عمل مستمع Gateway الخاص بـ Discord، وليس عمر دور الوكيل

لا يطبق Discord مهلة مملوكة للقناة على أدوار الوكيل الموضوعة في الصف. تسلم مستمعات الرسائل العمل فورًا، وتحافظ تشغيلات Discord الموضوعة في الصف على الترتيب لكل جلسة حتى تكتمل دورة حياة الجلسة/الأداة/وقت التشغيل أو يتم إجهاض العمل.

{
channels: {
discord: {
  accounts: {
    default: {
      eventQueue: {
        listenerTimeout: 120000,
      },
    },
  },
},
},
}

يجلب OpenClaw بيانات Discord الوصفية /gateway/bot قبل الاتصال. تعود حالات الفشل العابرة إلى عنوان URL الافتراضي لـ Gateway الخاص بـ Discord، ويتم تقييد معدلها في السجلات.

إعدادات ضبط مهلة البيانات الوصفية:

• حساب واحد: channels.discord.gatewayInfoTimeoutMs
• حسابات متعددة: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• بديل متغير البيئة عندما يكون التكوين غير معين: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• الافتراضي: 30000 (30 ثانية)، الحد الأقصى: 120000

ينتظر OpenClaw حدث READY الخاص بـ Gateway في Discord أثناء بدء التشغيل وبعد إعادة الاتصال في وقت التشغيل. قد تحتاج إعدادات الحسابات المتعددة مع التدرج في بدء التشغيل إلى نافذة READY أطول عند بدء التشغيل من القيمة الافتراضية.

إعدادات ضبط مهلة READY:

• بدء التشغيل لحساب واحد: channels.discord.gatewayReadyTimeoutMs
• بدء التشغيل لحسابات متعددة: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• بديل متغير البيئة عند بدء التشغيل عندما يكون التكوين غير معين: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• الافتراضي عند بدء التشغيل: 15000 (15 ثانية)، الحد الأقصى: 120000
• وقت التشغيل لحساب واحد: channels.discord.gatewayRuntimeReadyTimeoutMs
• وقت التشغيل لحسابات متعددة: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• بديل متغير البيئة في وقت التشغيل عندما يكون التكوين غير معين: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• الافتراضي في وقت التشغيل: 30000 (30 ثانية)، الحد الأقصى: 120000

لا تعمل فحوصات أذونات channels status --probe إلا مع معرفات القنوات الرقمية.

إذا كنت تستخدم مفاتيح slug، فقد تظل المطابقة في وقت التشغيل تعمل، لكن probe لا يمكنه التحقق من الأذونات بالكامل.

• الرسائل المباشرة معطلة: channels.discord.dm.enabled=false
• سياسة الرسائل المباشرة معطلة: channels.discord.dmPolicy="disabled" (قديم: channels.discord.dm.policy)
• انتظار موافقة الاقتران في وضع pairing

افتراضيا، يتم تجاهل الرسائل التي يكتبها الروبوت.

إذا عيّنت channels.discord.allowBots=true، فاستخدم قواعد إشارة وقائمة سماح صارمة لتجنب سلوك الحلقات. فضّل channels.discord.allowBots="mentions" لقبول رسائل الروبوتات فقط عندما تشير إلى الروبوت.

{
channels: {
discord: {
  accounts: {
    mantis: {
      // Mantis listens to other bots only when they mention her.
      allowBots: "mentions",
    },
    molty: {
      // Molty listens to all bot-authored Discord messages.
      allowBots: true,
      mentionAliases: {
        // Lets Molty write "@Mantis" and send a real Discord mention.
        Mantis: "MANTIS_DISCORD_USER_ID",
      },
    },
  },
},
},
}

• أبقِ OpenClaw محدثا (openclaw update) حتى يكون منطق استرداد استقبال صوت Discord موجودا
• تأكد من channels.discord.voice.daveEncryption=true (الافتراضي)
• ابدأ من channels.discord.voice.decryptionFailureTolerance=24 (الافتراضي في المنبع) واضبطه فقط عند الحاجة
• راقب السجلات بحثا عن:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• إذا استمرت الإخفاقات بعد إعادة الانضمام التلقائية، فاجمع السجلات وقارنها بسجل استقبال DAVE في المنبع في discord.js #11419 وdiscord.js #11449