Discord

جاهز للرسائل المباشرة وقنوات النقابة عبر Gateway الرسمي لـ Discord.

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

ستحتاج إلى إنشاء تطبيق جديد مع روبوت، وإضافة الروبوت إلى خادمك، وإقرانه بـ OpenClaw. نوصي بإضافة روبوتك إلى خادمك الخاص. إذا لم يكن لديك واحد بعد، أنشئ واحدًا أولًا (اختر Create My Own > For me and my friends).

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"cat > discord.patch.json5 <<'JSON5'{channels: {discord: {  enabled: true,  token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./discord.patch.json5 --dry-runopenclaw config patch --file ./discord.patch.json5openclaw gateway

{channels: {discord: {enabled: true,token: {source: "env",provider: "default",id: "DISCORD_BOT_TOKEN",},},},}

DISCORD_BOT_TOKEN=...

{channels: {discord: {enabled: true,accounts: {personal: {  token: { source: "env", provider: "default", id: "DISCORD_PERSONAL_TOKEN" },  applicationId: "111111111111111111",},work: {  token: { source: "env", provider: "default", id: "DISCORD_WORK_TOKEN" },  applicationId: "222222222222222222",},},},},}

openclaw pairing list discordopenclaw pairing approve discord <CODE>

موصى به: إعداد مساحة عمل للنقابة

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

{channels: {discord: {groupPolicy: "allowlist",guilds: {YOUR_SERVER_ID: {  requireMention: true,  users: ["YOUR_USER_ID"],},},},},}

{channels: {discord: {guilds: {YOUR_SERVER_ID: {  requireMention: false,},},},},}

أنشئ الآن بعض القنوات على خادم Discord وابدأ الدردشة. يستطيع وكيلك رؤية اسم القناة، وتحصل كل قناة على جلستها المعزولة الخاصة — بحيث يمكنك إعداد #coding أو #home أو #research أو أي شيء يناسب سير عملك.

نموذج وقت التشغيل

• يملك Gateway اتصال Discord.
• توجيه الردود حتمي: تعود الردود الواردة من Discord إلى Discord.
• تُضاف بيانات تعريف خادم/قناة Discord إلى موجّه النموذج كسياق غير موثوق به، وليس كبادئة رد مرئية للمستخدم. إذا نسخ نموذج ذلك الغلاف مرة أخرى، يزيل OpenClaw بيانات التعريف المنسوخة من الردود الصادرة ومن سياق إعادة التشغيل المستقبلي.
• افتراضيًا (session.dmScope=main)، تشارك المحادثات المباشرة جلسة الوكيل الرئيسية (agent:main:main).
• قنوات الخوادم هي مفاتيح جلسات معزولة (agent:<agentId>:discord:channel:<channelId>).
• تُتجاهل الرسائل المباشرة الجماعية افتراضيًا (channels.discord.dm.groupEnabled=false).
• تعمل أوامر slash الأصلية في جلسات أوامر معزولة (agent:<agentId>:discord:slash:<userId>)، مع الاستمرار في حمل CommandTargetSessionKey إلى جلسة المحادثة الموجّهة.
• يستخدم تسليم إعلانات cron/heartbeat النصية فقط إلى Discord الإجابة النهائية المرئية للمساعد مرة واحدة. تبقى حمولات الوسائط والمكوّنات المهيكلة متعددة الرسائل عندما يصدر الوكيل عدة حمولات قابلة للتسليم.

قنوات المنتديات

تقبل قنوات المنتديات والوسائط في Discord منشورات السلاسل فقط. يدعم OpenClaw طريقتين لإنشائها:

• أرسل رسالة إلى أصل المنتدى (channel:<forumId>) لإنشاء سلسلة تلقائيًا. يستخدم عنوان السلسلة أول سطر غير فارغ من رسالتك.
• استخدم openclaw message thread create لإنشاء سلسلة مباشرة. لا تمرّر --message-id لقنوات المنتديات.

مثال: الإرسال إلى أصل المنتدى لإنشاء سلسلة

openclaw message send --channel discord --target channel:<forumId> \  --message "Topic title\nBody of the post"

مثال: إنشاء سلسلة منتدى صراحةً

openclaw message thread create --channel discord --target channel:<forumId> \  --thread-name "Topic title" --message "Body of the post"

لا تقبل أصول المنتديات مكوّنات Discord. إذا كنت تحتاج إلى مكوّنات، فأرسل إلى السلسلة نفسها (channel:<threadId>).

المكوّنات التفاعلية

يدعم OpenClaw حاويات مكوّنات Discord v2 لرسائل الوكيل. استخدم أداة الرسائل مع حمولة components. تُوجَّه نتائج التفاعل مرة أخرى إلى الوكيل كرسائل واردة عادية وتتبع إعدادات Discord replyToMode الحالية.

الكتل المدعومة:

• text, section, separator, actions, media-gallery, file
• تسمح صفوف الإجراءات بما يصل إلى 5 أزرار أو قائمة اختيار واحدة
• أنواع الاختيار: string, user, role, mentionable, channel

افتراضيًا، تكون المكوّنات للاستخدام مرة واحدة. عيّن components.reusable=true للسماح باستخدام الأزرار والاختيارات والنماذج عدة مرات حتى تنتهي صلاحيتها.

لتقييد من يمكنه النقر على زر، عيّن allowedUsers على ذلك الزر (معرّفات مستخدمي Discord أو الوسوم أو *). عند التهيئة، يتلقى المستخدمون غير المطابقين رفضًا عابرًا.

تفتح أوامر slash /model و/models منتقي نماذج تفاعليًا مع قوائم منسدلة لمزوّد الخدمة والنموذج وبيئة التشغيل المتوافقة، إضافة إلى خطوة إرسال. أصبح /models add مهمَلًا، ويعيد الآن رسالة إهمال بدلًا من تسجيل النماذج من الدردشة. يكون رد المنتقي عابرًا ولا يمكن استخدامه إلا للمستخدم الذي استدعاه. قوائم اختيار Discord محدودة بـ 25 خيارًا، لذا أضف إدخالات provider/* إلى agents.defaults.models عندما تريد أن يعرض المنتقي النماذج المكتشفة ديناميكيًا فقط لمزوّدي خدمات محددين مثل openai-codex أو vllm.

مرفقات الملفات:

• يجب أن تشير كتل file إلى مرجع مرفق (attachment://<filename>)
• وفّر المرفق عبر media/path/filePath (ملف واحد)؛ استخدم media-gallery لعدة ملفات
• استخدم filename لتجاوز اسم الرفع عندما يجب أن يطابق مرجع المرفق

نماذج Modal:

• أضف components.modal مع ما يصل إلى 5 حقول
• أنواع الحقول: text, checkbox, radio, select, role-select, user-select
• يضيف OpenClaw زر تشغيل تلقائيًا

مثال:

{  channel: "discord",  action: "send",  to: "channel:123456789012345678",  message: "Optional fallback text",  components: {    reusable: true,    text: "Choose a path",    blocks: [      {        type: "actions",        buttons: [          {            label: "Approve",            style: "success",            allowedUsers: ["123456789012345678"],          },          { label: "Decline", style: "danger" },        ],      },      {        type: "actions",        select: {          type: "string",          placeholder: "Pick an option",          options: [            { label: "Option A", value: "a" },            { label: "Option B", value: "b" },          ],        },      },    ],    modal: {      title: "Details",      triggerLabel: "Open form",      fields: [        { type: "text", label: "Requester" },        {          type: "select",          label: "Priority",          options: [            { label: "Low", value: "low" },            { label: "High", value: "high" },          ],        },      ],    },  },}

التحكم في الوصول والتوجيه

{accessGroups: {operators: {  type: "message.senders",  members: {    "*": ["global-owner-id"],    discord: ["discord:123456789012345678"],    telegram: ["987654321"],  },},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:operators"],},},}

{accessGroups: {maintainers: {  type: "discord.channelAudience",  guildId: "1456350064065904867",  channelId: "1456744319972282449",  membership: "canViewChannel",},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:maintainers"],},},}

{accessGroups: {maintainers: {  type: "discord.channelAudience",  guildId: "1456350064065904867",  channelId: "1456744319972282449",},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"],},},}

{channels: {discord: {  groupPolicy: "allowlist",  guilds: {    "123456789012345678": {      requireMention: true,      ignoreOtherMentions: true,      users: ["987654321098765432"],      roles: ["123456789012345678"],      channels: {        general: { allow: true },        help: { allow: true, requireMention: true },      },    },  },},},}

توجيه الوكلاء المستند إلى الأدوار

استخدم bindings[].match.roles لتوجيه أعضاء خوادم Discord إلى وكلاء مختلفين حسب معرّف الدور. تقبل الارتباطات المستندة إلى الأدوار معرّفات الأدوار فقط، وتُقيَّم بعد ارتباطات النظير أو النظير الأصل وقبل ارتباطات الخادم فقط. إذا عيّن ارتباط حقول مطابقة أخرى أيضًا (مثلًا peer + guildId + roles)، فيجب أن تتطابق كل الحقول المهيأة.

{  bindings: [    {      agentId: "opus",      match: {        channel: "discord",        guildId: "123456789012345678",        roles: ["111111111111111111"],      },    },    {      agentId: "sonnet",      match: {        channel: "discord",        guildId: "123456789012345678",      },    },  ],}

الأوامر الأصلية ومصادقة الأوامر

• يتم تعيين القيمة الافتراضية لـ commands.native إلى "auto" ويكون مفعلا لـ Discord.
• التجاوز لكل قناة: channels.discord.commands.native.
• يؤدي commands.native=false إلى تخطي تسجيل أوامر الشرطة المائلة في Discord وتنظيفها أثناء بدء التشغيل. قد تبقى الأوامر المسجلة سابقا مرئية في Discord إلى أن تزيلها من تطبيق Discord.
• تستخدم مصادقة الأوامر الأصلية قوائم السماح/السياسات نفسها في Discord مثل معالجة الرسائل العادية.
• قد تظل الأوامر مرئية في واجهة Discord للمستخدمين غير المصرح لهم؛ لكن التنفيذ يظل يفرض مصادقة OpenClaw ويعيد "غير مصرح".

راجع أوامر الشرطة المائلة لمعرفة كتالوج الأوامر وسلوكها.

إعدادات أوامر الشرطة المائلة الافتراضية:

• ephemeral: true

تفاصيل الميزة

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

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

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

{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,        },      },    },  },},},}

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

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

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

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

{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",},},}

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

الأدوات وبوابات الإجراءات

تتضمن إجراءات رسائل Discord إجراءات المراسلة وإدارة القنوات والإشراف والحضور والبيانات الوصفية.

أمثلة أساسية:

• المراسلة: sendMessage، readMessages، editMessage، deleteMessage، threadReply
• التفاعلات: react، reactions، emojiList
• الإشراف: timeout، kick، ban
• الحضور: setPresence

يقبل الإجراء event-create معلمة image اختيارية (URL أو مسار ملف محلي) لتعيين صورة غلاف الحدث المجدول.

توجد بوابات الإجراءات ضمن channels.discord.actions.*.

سلوك البوابة الافتراضي:

واجهة مستخدم Components v2

يستخدم OpenClaw مكونات Discord v2 لموافقات التنفيذ وعلامات السياقات المتعددة. يمكن لإجراءات رسائل Discord أيضًا قبول components لواجهة مستخدم مخصصة (متقدم؛ يتطلب إنشاء حمولة مكوّن عبر أداة discord)، بينما تظل embeds القديمة متاحة لكنها غير موصى بها.

• يعيّن channels.discord.ui.components.accentColor لون التمييز المستخدم في حاويات مكونات Discord (hex).
• عيّنه لكل حساب باستخدام channels.discord.accounts.<id>.ui.components.accentColor.
• يتم تجاهل embeds عند وجود مكونات v2.

مثال:

{  channels: {    discord: {      ui: {        components: {          accentColor: "#5865F2",        },      },    },  },}

الصوت

لدى Discord سطحان صوتيان متميزان: قنوات الصوت في الوقت الفعلي (محادثات مستمرة) ومرفقات الرسائل الصوتية (تنسيق معاينة الموجة). يدعم Gateway كليهما.

قنوات الصوت

قائمة التحقق للإعداد:

1. فعّل Message Content Intent في Discord Developer Portal.
2. فعّل Server Members Intent عند استخدام قوائم السماح للأدوار/المستخدمين.
3. ادعُ الروبوت باستخدام نطاقي bot وapplications.commands.
4. امنح أذونات Connect وSpeak وSend Messages وRead Message History في قناة الصوت الهدف.
5. فعّل الأوامر الأصلية (commands.native أو channels.discord.commands.native).
6. اضبط channels.discord.voice.

استخدم /vc join|leave|status للتحكم في الجلسات. يستخدم الأمر الوكيل الافتراضي للحساب ويتبع قواعد قائمة السماح وسياسة المجموعات نفسها مثل أوامر Discord الأخرى.

/vc join channel:<voice-channel-id>/vc status/vc leave

لفحص الأذونات الفعلية للروبوت قبل الانضمام، شغّل:

openclaw channels capabilities --channel discord --target channel:<voice-channel-id>

مثال الانضمام التلقائي:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai-codex/gpt-5.5",        autoJoin: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        allowedChannels: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        daveEncryption: true,        decryptionFailureTolerance: 24,        connectTimeoutMs: 30000,        reconnectGraceMs: 15000,        realtime: {          provider: "openai",          model: "gpt-realtime-2",          voice: "cedar",        },      },    },  },}

ملاحظات:

• يتجاوز voice.tts إعداد messages.tts لتشغيل الصوت في stt-tts فقط. تستخدم أوضاع الوقت الحقيقي voice.realtime.voice.
• يتحكم voice.mode في مسار المحادثة. القيمة الافتراضية هي agent-proxy: تتولى واجهة صوتية في الوقت الحقيقي إدارة توقيت الأدوار، والمقاطعة، والتشغيل، وتفوّض العمل الجوهري إلى وكيل OpenClaw الموجّه عبر openclaw_agent_consult، وتتعامل مع النتيجة كما لو كانت مطالبة Discord مكتوبة من ذلك المتحدث. يحتفظ stt-tts بالتدفق الأقدم القائم على STT الدفعي مع TTS. يتيح bidi لنموذج الوقت الحقيقي المحادثة مباشرة مع إتاحة openclaw_agent_consult لعقل OpenClaw.
• يتحكم voice.agentSession في محادثة OpenClaw التي تستقبل أدوار الصوت. اتركه غير معيّن لاستخدام جلسة قناة الصوت نفسها، أو اضبط { mode: "target", target: "channel:<text-channel-id>" } لجعل قناة الصوت تعمل كامتداد ميكروفون/مكبر صوت لجلسة قناة نصية موجودة في Discord مثل #maintainers.
• يتجاوز voice.model عقل وكيل OpenClaw لاستجابات Discord الصوتية والاستشارات في الوقت الحقيقي. اتركه غير معيّن ليرث نموذج الوكيل الموجّه. وهو منفصل عن voice.realtime.model.
• يوجّه agent-proxy الكلام عبر discord-voice، ما يحافظ على تفويض المالك/الأدوات العادي للمتحدث والجلسة المستهدفة لكنه يخفي أداة الوكيل tts لأن صوت Discord يمتلك التشغيل. افتراضياً، يمنح agent-proxy الاستشارة وصولاً كاملاً إلى الأدوات بمستوى مكافئ للمالك للمتحدثين المالكين (voice.realtime.toolPolicy: "owner") ويفضل بشدة استشارة وكيل OpenClaw قبل الإجابات الجوهرية (voice.realtime.consultPolicy: "always"). في وضع always الافتراضي هذا، لا تنطق طبقة الوقت الحقيقي كلاماً حشوياً تلقائياً قبل إجابة الاستشارة؛ بل تلتقط الكلام وتنسخه، ثم تنطق إجابة OpenClaw الموجّهة. إذا انتهت عدة إجابات استشارة مفروضة بينما لا يزال Discord يشغل الإجابة الأولى، تُصفّ إجابات الكلام الدقيقة اللاحقة حتى يصبح التشغيل خاملاً بدلاً من استبدال الكلام في منتصف الجملة.
• في وضع stt-tts، يستخدم STT tools.media.audio؛ ولا يؤثر voice.model في النسخ.
• في أوضاع الوقت الحقيقي، تضبط voice.realtime.provider وvoice.realtime.model وvoice.realtime.voice جلسة الصوت في الوقت الحقيقي. لاستخدام OpenAI Realtime 2 مع عقل Codex، استخدم voice.realtime.model: "gpt-realtime-2" وvoice.model: "openai-codex/gpt-5.5".
• يقبل موفر الوقت الحقيقي في OpenAI أسماء أحداث Realtime 2 الحالية والأسماء المستعارة القديمة المتوافقة مع Codex لأحداث صوت المخرجات والنص المنسوخ، بحيث يمكن أن تنحرف لقطات الموفر المتوافقة دون إسقاط صوت المساعد.
• يتحكم voice.realtime.bargeIn فيما إذا كانت أحداث بدء المتحدث في Discord تقاطع التشغيل النشط في الوقت الحقيقي. إذا تُرك غير معيّن، فإنه يتبع إعداد مقاطعة صوت الإدخال لدى موفر الوقت الحقيقي.
• يتحكم voice.realtime.minBargeInAudioEndMs في الحد الأدنى لمدة تشغيل المساعد قبل أن تقطع مقاطعة OpenAI في الوقت الحقيقي الصوت. الافتراضي: 250. اضبط 0 للمقاطعة الفورية في الغرف منخفضة الصدى، أو ارفعه لإعدادات مكبرات الصوت كثيرة الصدى.
• لاستخدام صوت OpenAI في تشغيل Discord، اضبط voice.tts.provider: "openai" واختر صوت تحويل نص إلى كلام ضمن voice.tts.openai.voice أو voice.tts.providers.openai.voice. يُعد cedar خياراً جيداً ذا طابع صوتي ذكوري على نموذج TTS الحالي من OpenAI.
• تنطبق تجاوزات systemPrompt في Discord لكل قناة على أدوار نصوص الصوت المنسوخة لتلك القناة الصوتية.
• تستمد أدوار نصوص الصوت المنسوخة حالة المالك من allowFrom في Discord (أو dm.allowFrom)؛ ولا يمكن للمتحدثين غير المالكين الوصول إلى الأدوات المخصصة للمالك فقط (مثل gateway وcron).
• صوت Discord اختياري للإعدادات النصية فقط؛ اضبط channels.discord.voice.enabled=true (أو أبقِ كتلة channels.discord.voice موجودة) لتمكين أوامر /vc، ووقت تشغيل الصوت، وقصد Gateway GuildVoiceStates.
• يمكن لـ channels.discord.intents.voiceStates تجاوز اشتراك قصد حالة الصوت صراحةً. اتركه غير معيّن ليتبع القصد حالة تمكين الصوت الفعلية.
• إذا احتوى voice.autoJoin على عدة إدخالات للنقابة نفسها، ينضم OpenClaw إلى آخر قناة مهيأة لتلك النقابة.
• voice.allowedChannels قائمة سماح اختيارية للإقامة. اتركها غير معيّنة للسماح لـ /vc join بالدخول إلى أي قناة صوتية مصرّح بها في Discord. عند تعيينها، تُقيّد عمليات /vc join والانضمام التلقائي عند بدء التشغيل ونقل حالة صوت البوت بالإدخالات المدرجة { guildId, channelId }. اضبطها على مصفوفة فارغة لرفض جميع عمليات انضمام Discord الصوتية. إذا نقل Discord البوت خارج قائمة السماح، يغادر OpenClaw تلك القناة ويعيد الانضمام إلى هدف الانضمام التلقائي المهيأ عندما يكون متاحاً.
• يمرر voice.daveEncryption وvoice.decryptionFailureTolerance إلى خيارات الانضمام في @discordjs/voice.
• الإعدادات الافتراضية لـ @discordjs/voice هي daveEncryption=true وdecryptionFailureTolerance=24 إذا تُركت غير معيّنة.
• يستخدم OpenClaw افتراضياً مفكك ترميز opusscript المكتوب بـ JS فقط لاستقبال صوت Discord. يتجاهل repo حزمة @discordjs/opus الأصلية الاختيارية وفق سياسة تثبيت pnpm، بحيث لا تقوم عمليات التثبيت العادية ومسارات Docker والاختبارات غير ذات الصلة بتجميع إضافة أصلية. يمكن لمضيفي أداء الصوت المخصصين الاشتراك عبر OPENCLAW_DISCORD_OPUS_DECODER=native بعد تثبيت الإضافة الأصلية.
• يتحكم voice.connectTimeoutMs في انتظار Ready الأولي الخاص بـ @discordjs/voice لمحاولات /vc join والانضمام التلقائي. الافتراضي: 30000.
• يتحكم voice.reconnectGraceMs في مدة انتظار OpenClaw لجلسة صوتية منقطعة كي تبدأ إعادة الاتصال قبل تدميرها. الافتراضي: 15000.
• في وضع stt-tts، لا يتوقف تشغيل الصوت لمجرد أن مستخدماً آخر بدأ الكلام. لتجنب حلقات التغذية الراجعة، يتجاهل OpenClaw التقاط الصوت الجديد أثناء تشغيل TTS؛ تحدث بعد انتهاء التشغيل للدور التالي. تمرر أوضاع الوقت الحقيقي بدايات المتحدث كإشارات مقاطعة إلى موفر الوقت الحقيقي.
• في أوضاع الوقت الحقيقي، قد يبدو الصدى من مكبرات الصوت إلى ميكروفون مفتوح كمقاطعة ويقاطع التشغيل. لغرف Discord كثيرة الصدى، اضبط voice.realtime.providers.openai.interruptResponseOnInputAudio: false لمنع OpenAI من المقاطعة التلقائية عند صوت الإدخال. أضف voice.realtime.bargeIn: true إذا كنت لا تزال تريد أن تقاطع أحداث بدء المتحدث في Discord التشغيل النشط. يتجاهل جسر OpenAI في الوقت الحقيقي عمليات اقتطاع التشغيل الأقصر من voice.realtime.minBargeInAudioEndMs باعتبارها غالباً صدى/ضجيجاً ويسجلها كمتخطاة بدلاً من مسح تشغيل Discord.
• يتحكم voice.captureSilenceGraceMs في مدة انتظار OpenClaw بعد أن يبلغ Discord بأن المتحدث توقف قبل إنهاء ذلك المقطع الصوتي لـ STT. الافتراضي: 2500؛ ارفع هذه القيمة إذا كان Discord يقسم الوقفات الطبيعية إلى نصوص منسوخة جزئية متقطعة.
• عندما يكون ElevenLabs هو موفر TTS المحدد، يستخدم تشغيل صوت Discord TTS بالتدفق ويبدأ من تدفق استجابة الموفر. تعود الموفرات التي لا تدعم التدفق إلى مسار الملف المؤقت المركّب.
• يراقب OpenClaw أيضاً حالات فشل فك تشفير الاستقبال ويتعافى تلقائياً عبر مغادرة/إعادة الانضمام إلى القناة الصوتية بعد إخفاقات متكررة ضمن نافذة قصيرة.
• إذا أظهرت سجلات الاستقبال بشكل متكرر DecryptionFailed(UnencryptedWhenPassthroughDisabled) بعد التحديث، فاجمع تقرير اعتماديات وسجلات. يتضمن خط @discordjs/voice المرفق إصلاح الحشو upstream من PR #11449 في discord.js، الذي أغلق issue #11419 في discord.js.
• أحداث استقبال The operation was aborted متوقعة عندما ينهي OpenClaw مقطع متحدث ملتقطاً؛ وهي تشخيصات مطولة، لا تحذيرات.
• تتضمن سجلات صوت Discord المطولة معاينة محدودة من سطر واحد لنص STT المنسوخ لكل مقطع متحدث مقبول، بحيث يعرض التصحيح جانب المستخدم وجانب رد الوكيل دون تفريغ نصوص منسوخة غير محدودة.
• في وضع agent-proxy، يتخطى رجوع الاستشارة المفروضة أجزاء النص المنسوخ التي تبدو غير مكتملة مثل النص المنتهي بـ ... أو واصل لاحق مثل and، إضافة إلى عبارات الإغلاق الواضحة غير القابلة للتنفيذ مثل “سأعود حالاً” أو “وداعاً”. تعرض السجلات forced agent consult skipped reason=... عندما يمنع ذلك إجابة قديمة في الطابور.

إعداد opus الأصلي لنسخ المصدر:

pnpm installmise exec node@22 -- pnpm discord:opus:install

استخدم Node 22 للـ Gateway عندما تريد الإضافة الأصلية المبنية مسبقاً upstream لنظام macOS arm64. إذا استخدمت وقت تشغيل Node آخر، فقد يحتاج المثبت الاختياري إلى سلسلة أدوات بناء مصدر محلية لـ node-gyp.

بعد تثبيت الإضافة الأصلية، ابدأ Gateway باستخدام:

OPENCLAW_DISCORD_OPUS_DECODER=native pnpm gateway:watch

ينبغي أن تعرض سجلات الصوت المطولة discord voice: opus decoder: @discordjs/opus. من دون الاشتراك عبر متغير البيئة، أو إذا كانت الإضافة الأصلية مفقودة أو لا يمكن تحميلها على المضيف، يسجل OpenClaw discord voice: opus decoder: opusscript ويواصل استقبال الصوت عبر بديل JS الصرف.

مسار STT مع TTS:

• يتم تحويل التقاط PCM من Discord إلى ملف WAV مؤقت.
• يتولى tools.media.audio معالجة STT، على سبيل المثال openai/gpt-4o-mini-transcribe.
• يُرسل النص المنسوخ عبر مدخل Discord والتوجيه بينما يعمل LLM للاستجابة بسياسة إخراج صوتي تخفي أداة الوكيل tts وتطلب نصاً مُعاداً، لأن صوت Discord يمتلك تشغيل TTS النهائي.
• عند تعيين voice.model، فإنه يتجاوز فقط LLM الخاص بالاستجابة لهذا الدور في القناة الصوتية.
• يُدمج voice.tts فوق messages.tts؛ تغذي الموفرات القادرة على التدفق المشغل مباشرة، وإلا فيُشغل ملف الصوت الناتج في القناة المنضم إليها.

مثال جلسة قناة صوتية افتراضية للوكيل الوكيل:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai-codex/gpt-5.5",        realtime: {          provider: "openai",          model: "gpt-realtime-2",          voice: "cedar",        },      },    },  },}

من دون كتلة voice.agentSession، تحصل كل قناة صوتية على جلسة OpenClaw موجّهة خاصة بها. على سبيل المثال، يتحدث /vc join channel:234567890123456789 إلى الجلسة الخاصة بتلك القناة الصوتية في Discord. نموذج الوقت الحقيقي هو واجهة الصوت فقط؛ وتُسلّم الطلبات الجوهرية إلى وكيل OpenClaw المهيأ. إذا أنتج نموذج الوقت الحقيقي نصاً نهائياً منسوخاً من دون استدعاء أداة الاستشارة، يفرض OpenClaw الاستشارة كرجوع بحيث يظل السلوك الافتراضي مشابهاً للتحدث إلى الوكيل.

مثال STT مع TTS القديم:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "stt-tts",        model: "openai/gpt-5.4-mini",        tts: {          provider: "openai",          openai: {            model: "gpt-4o-mini-tts",            voice: "cedar",          },        },      },    },  },}

مثال bidi في الوقت الحقيقي:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai-codex/gpt-5.5",        realtime: {          provider: "openai",          model: "gpt-realtime-2",          voice: "cedar",          toolPolicy: "safe-read-only",          consultPolicy: "always",        },      },    },  },}

الصوت كامتداد لجلسة قناة Discord موجودة:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "agent-proxy",        model: "openai-codex/gpt-5.5",        agentSession: {          mode: "target",          target: "channel:123456789012345678",        },        realtime: {          provider: "openai",          model: "gpt-realtime-2",          voice: "cedar",        },      },    },  },}

في وضع agent-proxy، ينضم البوت إلى القناة الصوتية المهيأة، لكن أدوار وكيل OpenClaw تستخدم الجلسة والوكيل الموجّهين العاديين للقناة المستهدفة. تنطق جلسة الصوت في الوقت الحقيقي النتيجة المعادة داخل القناة الصوتية. لا يزال بإمكان وكيل الإشراف استخدام أدوات الرسائل العادية وفقاً لسياسة أدواته، بما في ذلك إرسال رسالة Discord منفصلة إذا كان ذلك هو الإجراء الصحيح.

صيغ الأهداف المفيدة:

• يوجّه target: "channel:123456789012345678" عبر جلسة قناة نصية في Discord.
• يُعامل target: "123456789012345678" كهدف قناة.
• يوجّه target: "dm:123456789012345678" أو target: "user:123456789012345678" عبر جلسة الرسائل المباشرة تلك.

مثال OpenAI Realtime للبيئات كثيرة الصدى:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai-codex/gpt-5.5",        realtime: {          provider: "openai",          model: "gpt-realtime-2",          voice: "cedar",          bargeIn: true,          minBargeInAudioEndMs: 500,          consultPolicy: "always",          providers: {            openai: {              interruptResponseOnInputAudio: false,            },          },        },      },    },  },}

استخدم هذا عندما يسمع النموذج تشغيل Discord الخاص به عبر ميكروفون مفتوح، لكنك لا تزال تريد مقاطعته بالتحدث. يمنع OpenClaw OpenAI من المقاطعة التلقائية عند إدخال صوت خام، بينما يتيح bargeIn: true لأحداث بدء متحدث Discord وصوت المتحدث النشط بالفعل إلغاء استجابات الوقت الفعلي النشطة قبل أن تصل اللفة الملتقطة التالية إلى OpenAI. تُعامل إشارات المقاطعة المبكرة جدًا التي يكون فيها audioEndMs أقل من minBargeInAudioEndMs على أنها صدى/ضجيج محتمل ويتم تجاهلها حتى لا ينقطع النموذج عند أول إطار تشغيل.

سجلات الصوت المتوقعة:

• عند الانضمام: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
• عند بدء الوقت الفعلي: discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...
• عند صوت المتحدث: discord voice: realtime speaker turn opened ...، وdiscord voice: realtime input audio started ... outputAudioMs=... outputActive=...، وdiscord voice: realtime speaker turn closed ... chunks=... discordBytes=... realtimeBytes=... interruptedPlayback=...
• عند تخطي كلام قديم: discord voice: realtime forced agent consult skipped reason=incomplete-transcript ... أو reason=non-actionable-closing ...
• عند اكتمال استجابة الوقت الفعلي: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
• عند إيقاف/إعادة ضبط التشغيل: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• عند استشارة الوقت الفعلي: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• عند إجابة الوكيل: discord voice: agent turn answer ...
• عند الكلام المطابق المدرج في الطابور: discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=...، يتبعه discord voice: realtime exact speech dequeued reason=player-idle ...
• عند اكتشاف المقاطعة: discord voice: realtime barge-in detected source=speaker-start ... أو discord voice: realtime barge-in detected source=active-speaker-audio ...، يتبعه discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...
• عند مقاطعة الوقت الفعلي: discord voice: realtime model interrupt requested client:response.cancel reason=barge-in، يتبعه إما discord voice: realtime model audio truncated client:conversation.item.truncate reason=barge-in audioEndMs=... أو discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...
• عند تجاهل الصدى/الضجيج: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
• عند تعطيل المقاطعة: discord voice: realtime capture ignored during playback (barge-in disabled) ...
• عند التشغيل الخامل: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

لتصحيح الصوت المنقطع، اقرأ سجلات الصوت في الوقت الفعلي كخط زمني:

1. يعني realtime audio playback started أن Discord بدأ تشغيل صوت المساعد. يبدأ الجسر من هذه النقطة في عد أجزاء مخرجات المساعد، وبايتات Discord PCM، وبايتات موفر الوقت الفعلي، ومدة الصوت المركب.
2. يحدد realtime speaker turn opened أن متحدث Discord أصبح نشطًا. إذا كان التشغيل نشطًا بالفعل وكان bargeIn مفعّلًا، فقد يتبعه barge-in detected source=speaker-start.
3. يحدد realtime input audio started أول إطار صوت فعلي تم استلامه لتلك اللفة من المتحدث. يعني outputActive=true أو قيمة غير صفرية لـ outputAudioMs هنا أن الميكروفون يرسل إدخالًا بينما لا يزال تشغيل المساعد نشطًا.
4. يعني barge-in detected source=active-speaker-audio أن OpenClaw رأى صوت متحدث مباشرًا بينما كان تشغيل المساعد نشطًا. يفيد هذا في التمييز بين مقاطعة حقيقية وحدث بدء متحدث في Discord بلا صوت مفيد.
5. يعني barge-in requested reason=... أن OpenClaw طلب من موفر الوقت الفعلي إلغاء الاستجابة النشطة أو اقتطاعها. ويتضمن outputAudioMs، وoutputActive، وplaybackChunks حتى تتمكن من رؤية مقدار صوت المساعد الذي تم تشغيله فعليًا قبل المقاطعة.
6. realtime audio playback stopped reason=... هو نقطة إعادة ضبط تشغيل Discord المحلية. يوضح السبب من أوقف التشغيل: barge-in، أو player-idle، أو provider-clear-audio، أو forced-agent-consult، أو stream-close، أو session-close.
7. يلخص realtime speaker turn closed لفة الإدخال الملتقطة. يعني chunks=0 أو hasAudio=false أن لفة المتحدث فُتحت لكن لم يصل أي صوت قابل للاستخدام إلى جسر الوقت الفعلي. ويعني interruptedPlayback=true أن لفة الإدخال تلك تداخلت مع مخرجات المساعد وشغّلت منطق المقاطعة.

حقول مفيدة:

• outputAudioMs: مدة صوت المساعد التي أنشأها موفر الوقت الفعلي قبل سطر السجل.
• audioMs: مدة صوت المساعد التي عدّها OpenClaw قبل توقف التشغيل.
• elapsedMs: وقت الساعة الفعلي بين فتح وإغلاق دفق التشغيل أو لفة المتحدث.
• discordBytes: بايتات PCM ستيريو بتردد 48 كيلوهرتز المرسلة إلى Discord voice أو المستلمة منه.
• realtimeBytes: بايتات PCM بتنسيق الموفر المرسلة إلى موفر الوقت الفعلي أو المستلمة منه.
• playbackChunks: أجزاء صوت المساعد الممررة إلى Discord للاستجابة النشطة.
• sinceLastAudioMs: الفجوة بين آخر إطار صوت متحدث ملتقط وإغلاق لفة المتحدث.

أنماط شائعة:

• غالبًا ما يشير الانقطاع الفوري مع source=active-speaker-audio وoutputAudioMs صغير ووجود المستخدم نفسه بالقرب إلى دخول صدى السماعة إلى الميكروفون. ارفع voice.realtime.minBargeInAudioEndMs، أو اخفض مستوى صوت السماعة، أو استخدم سماعات رأس، أو عيّن voice.realtime.providers.openai.interruptResponseOnInputAudio: false.
• يعني source=speaker-start متبوعًا بـ speaker turn closed ... hasAudio=false أن Discord أبلغ عن بدء متحدث لكن لم يصل أي صوت إلى OpenClaw. قد يكون ذلك حدث Discord voice عابرًا، أو سلوك بوابة ضجيج، أو عميلًا يفعّل الميكروفون للحظة قصيرة.
• يعني audio playback stopped reason=stream-close دون مقاطعة قريبة أو provider-clear-audio أن دفق تشغيل Discord المحلي انتهى بشكل غير متوقع. تحقق من سجلات الموفر ومشغل Discord السابقة.
• يعني capture ignored during playback (barge-in disabled) أن OpenClaw أسقط الإدخال عمدًا بينما كان صوت المساعد نشطًا. فعّل voice.realtime.bargeIn إذا كنت تريد أن يقاطع الكلام التشغيل.
• يعني barge-in ignored ... outputActive=false أن Discord أو VAD الخاص بالموفر أبلغ عن كلام، لكن لم يكن لدى OpenClaw تشغيل نشط لمقاطعته. لا ينبغي أن يؤدي هذا إلى قطع الصوت.

تُحل بيانات الاعتماد لكل مكون: مصادقة مسار LLM لـ voice.model، ومصادقة STT لـ tools.media.audio، ومصادقة TTS لـ messages.tts/voice.tts، ومصادقة موفر الوقت الفعلي لـ voice.realtime.providers أو إعدادات المصادقة العادية الخاصة بالموفر.

رسائل الصوت

تعرض رسائل الصوت في Discord معاينة موجية وتتطلب صوت OGG/Opus. ينشئ OpenClaw الموجة تلقائيًا، لكنه يحتاج إلى ffmpeg وffprobe على مضيف Gateway للفحص والتحويل.

• وفّر مسار ملف محليًا (تُرفض عناوين URL).
• احذف محتوى النص (يرفض Discord النص + رسالة صوتية في الحمولة نفسها).
• يُقبل أي تنسيق صوت؛ يحوّله OpenClaw إلى OGG/Opus حسب الحاجة.

message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true)

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

openclaw doctoropenclaw channels status --probeopenclaw logs --follow

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

{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",      },    },  },},},}

مرجع التكوين

المرجع الأساسي: مرجع التكوين - Discord.

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

• تعامل مع رموز البوتات كأسرار (يفضل DISCORD_BOT_TOKEN في البيئات الخاضعة للإشراف).
• امنح أذونات Discord بأقل امتيازات ممكنة.
• إذا كانت حالة نشر الأوامر/الحالة قديمة، فأعد تشغيل Gateway ثم أعد الفحص باستخدام openclaw channels status --probe.

ذات صلة