Discord

​

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

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" },
    },
  },
}
JSON5
openclaw config patch --file ./discord.patch.json5 --dry-run
openclaw config patch --file ./discord.patch.json5
openclaw 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 discord
openclaw pairing approve discord <CODE>

​

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

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

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

​

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

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

​

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

• أرسل رسالة إلى أصل المنتدى (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"

​

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

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

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

• أضف 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: [
    {
      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: {
      suppressEmbeds: false,
    },
  },
}

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

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

​

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

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

​

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

• يضبط channels.discord.ui.components.accentColor لون التمييز المستخدم في حاويات مكوّنات Discord (سداسي).
• اضبطه لكل حساب باستخدام channels.discord.accounts.<id>.ui.components.accentColor.
• يتحكم channels.discord.agentComponents.ttlMs في مدة بقاء استدعاءات مكوّنات Discord المرسلة مسجلة (الافتراضي 1800000، الحد الأقصى 86400000). اضبطه لكل حساب باستخدام channels.discord.accounts.<id>.agentComponents.ttlMs.
• يتم تجاهل embeds عند وجود مكوّنات v2.
• يتم كبت معاينات URL العادية افتراضيًا. اضبط suppressEmbeds: false على إجراء رسالة عندما ينبغي توسيع رابط صادر واحد.

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

​

الصوت

​

القنوات الصوتية

1. فعّل Message Content Intent في بوابة مطوري Discord.
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 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/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",
          speakerVoice: "cedar",
        },
      },
    },
  },
}

• يتجاوز voice.tts إعداد messages.tts لتشغيل الصوت في stt-tts فقط. تستخدم أوضاع الوقت الفعلي voice.realtime.speakerVoice.
• يتحكم 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.
• يتيح voice.followUsers للبوت الانضمام إلى صوت Discord والانتقال والمغادرة مع مستخدمين محددين. راجع متابعة المستخدمين في الصوت لقواعد السلوك والأمثلة.
• يوجّه 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.speakerVoice جلسة الصوت في الوقت الفعلي. لاستخدام OpenAI Realtime 2 مع عقل Codex، استخدم voice.realtime.model: "gpt-realtime-2" وvoice.model: "openai/gpt-5.5".
• تتضمن أوضاع الصوت في الوقت الفعلي ملفات ملف تعريف صغيرة IDENTITY.md وUSER.md وSOUL.md في تعليمات مزود الوقت الفعلي افتراضياً حتى تحافظ الأدوار المباشرة السريعة على الهوية نفسها، وتأريض المستخدم، والشخصية نفسها مثل وكيل OpenClaw الموجّه. اضبط voice.realtime.bootstrapContextFiles على مجموعة فرعية لتخصيص ذلك، أو [] لتعطيله. تقتصر ملفات التمهيد المدعومة للوقت الفعلي على ملفات ملف التعريف تلك؛ ويبقى AGENTS.md في سياق الوكيل العادي. لا يستبدل سياق ملف التعريف المحقون openclaw_agent_consult لعمل مساحة العمل، أو الحقائق الحالية، أو البحث في الذاكرة، أو الإجراءات المدعومة بالأدوات.
• في وضع الوقت الفعلي agent-proxy من OpenAI، اضبط voice.realtime.requireWakeName: true لإبقاء صوت Discord في الوقت الفعلي صامتاً حتى يبدأ النسخ أو ينتهي باسم تنبيه. يجب أن تكون أسماء التنبيه المضبوطة كلمة واحدة أو كلمتين. إذا كان voice.realtime.wakeNames غير مضبوط، يستخدم OpenClaw name للوكيل الموجّه بالإضافة إلى OpenClaw، مع الرجوع إلى معرف الوكيل بالإضافة إلى OpenClaw. يعطل شرط اسم التنبيه الاستجابة التلقائية لمزود الوقت الفعلي، ويوجّه الأدوار المقبولة عبر مسار استشارة وكيل OpenClaw، ويعطي إقراراً صوتياً قصيراً عند التعرف على اسم تنبيه بادئ من نسخ جزئي قبل وصول النسخة النهائية.
• يقبل مزود OpenAI في الوقت الفعلي أسماء أحداث Realtime 2 الحالية والأسماء المستعارة القديمة المتوافقة مع Codex لأحداث صوت الإخراج والنص المنسوخ، بحيث يمكن أن تنحرف لقطات المزود المتوافقة دون إسقاط صوت المساعد.
• يتحكم voice.realtime.bargeIn فيما إذا كانت أحداث بدء متحدث Discord تقاطع تشغيل الوقت الفعلي النشط. إذا كان غير مضبوط، فإنه يتبع إعداد مقاطعة صوت الإدخال لمزود الوقت الفعلي.
• يتحكم voice.realtime.minBargeInAudioEndMs في الحد الأدنى لمدة تشغيل المساعد قبل أن يقتطع تداخل OpenAI في الوقت الفعلي الصوت. الافتراضي: 250. اضبطه على 0 للمقاطعة الفورية في الغرف منخفضة الصدى، أو ارفعه لإعدادات مكبرات الصوت كثيرة الصدى.
• لاستخدام صوت OpenAI في تشغيل Discord، اضبط voice.tts.provider: "openai" واختر صوت Text-to-speech ضمن voice.tts.providers.openai.speakerVoice. يُعد cedar خياراً جيداً ذا وقع ذكوري في نموذج OpenAI TTS الحالي.
• تنطبق تجاوزات systemPrompt لكل قناة في Discord على أدوار النص المنسوخ الصوتية لتلك القناة الصوتية.
• تستمد أدوار النص المنسوخ الصوتية حالة المالك من allowFrom في Discord (أو dm.allowFrom) للأوامر وإجراءات القنوات المقيدة بالمالك. تتبع مرئية أدوات الوكيل سياسة الأدوات المضبوطة للجلسة الموجّهة.
• صوت 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 مرمّز libopus-wasm المضمّن لاستقبال صوت Discord وتشغيل PCM الخام في الوقت الفعلي. يشحن بناء WebAssembly مثبتاً من libopus ولا يتطلب إضافات opus أصلية.
• يتحكم 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. الافتراضي: 2000؛ ارفع هذا إذا كان Discord يقسم الوقفات العادية إلى نصوص جزئية متقطعة.
• عندما يكون ElevenLabs هو مزود TTS المحدد، يستخدم تشغيل صوت Discord بث TTS ويبدأ من تدفق استجابة المزود. تعود المزودات التي لا تدعم البث إلى مسار الملف المؤقت المصطنع.
• يراقب OpenClaw أيضاً فشل فك تشفير الاستقبال ويتعافى تلقائياً بمغادرة القناة الصوتية وإعادة الانضمام إليها بعد إخفاقات متكررة في نافذة قصيرة.
• إذا أظهرت سجلات الاستقبال مراراً DecryptionFailed(UnencryptedWhenPassthroughDisabled) بعد التحديث، فاجمع تقرير تبعية وسجلات. يتضمن سطر @discordjs/voice المضمّن إصلاح الحشو الصاعد من PR #11449 في discord.js، الذي أغلق issue #11419 في discord.js.
• أحداث استقبال The operation was aborted متوقعة عندما ينهي OpenClaw مقطع متحدث ملتقطاً؛ وهي تشخيصات مسهبة، لا تحذيرات.
• تتضمن سجلات صوت Discord المسهبة معاينة محدودة بسطر واحد لنص STT المنسوخ لكل مقطع متحدث مقبول، بحيث يُظهر التصحيح كلاً من جانب المستخدم وجانب رد الوكيل دون تفريغ نص منسوخ غير محدود.
• في وضع agent-proxy، يتخطى رجوع الاستشارة المفروضة أجزاء النص المنسوخ التي تبدو غير مكتملة، مثل النص المنتهي بـ ... أو رابط لاحق مثل and، إضافة إلى الخواتيم الواضحة غير القابلة للتنفيذ مثل “سأعود حالاً” أو “إلى اللقاء”. تعرض السجلات forced agent consult skipped reason=... عندما يمنع هذا إجابة قديمة مصطفة.

​

متابعة المستخدمين في الصوت

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        followUsersEnabled: true,
        followUsers: ["discord:123456789012345678"],
        allowedChannels: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
      },
    },
  },
}

• يقبل followUsers معرّفات مستخدمي Discord الخام وقيم discord:<id>. يطبّع OpenClaw كلا الشكلين قبل مطابقة أحداث حالة الصوت.
• يكون followUsersEnabled افتراضياً true عند ضبط followUsers. اضبطه على false للاحتفاظ بالقائمة المحفوظة مع إيقاف المتابعة الصوتية التلقائية.
• عندما ينضم مستخدم مُتابَع إلى قناة صوتية مسموحة، ينضم OpenClaw إلى تلك القناة. عندما ينتقل المستخدم، ينتقل OpenClaw معه. عندما ينقطع المستخدم المُتابَع النشط، يغادر OpenClaw.
• إذا كان عدة مستخدمين مُتابَعين في النقابة نفسها وغادر المستخدم المُتابَع النشط، ينتقل OpenClaw إلى قناة مستخدم مُتابَع آخر متعقَّب قبل مغادرة النقابة. إذا انتقل عدة مستخدمين مُتابَعين في الوقت نفسه، يفوز أحدث حدث حالة صوت مرصود.
• لا يزال allowedChannels مطبقاً. يُتجاهل المستخدم المُتابَع في قناة غير مسموحة، وتنتقل جلسة مملوكة للمتابعة إلى مستخدم مُتابَع آخر أو تغادر.
• يوفق OpenClaw أحداث حالة الصوت الفائتة عند بدء التشغيل وبفاصل زمني محدود. تأخذ المصالحة عينات من النقابات المضبوطة وتحد من عمليات بحث REST لكل تشغيل، لذلك قد تحتاج قوائم followUsers الكبيرة جداً إلى أكثر من فاصل واحد حتى تتقارب.
• إذا نقل Discord أو مسؤول البوت أثناء متابعته لمستخدم، يعيد OpenClaw بناء جلسة الصوت ويحافظ على ملكية المتابعة عندما تكون الوجهة مسموحة. إذا نُقل البوت إلى خارج allowedChannels، يغادر OpenClaw ويعيد الانضمام إلى الهدف المضبوط عند وجوده.
• قد يغادر تعافي استقبال DAVE القناة نفسها ويعيد الانضمام إليها بعد إخفاقات فك تشفير متكررة. تحتفظ الجلسات المملوكة للمتابعة بملكية المتابعة عبر مسار التعافي هذا، لذلك لا يزال انقطاع مستخدم مُتابَع لاحق يغادر القناة.

• استخدم followUsers للإعدادات الشخصية أو إعدادات المشغّل حيث يجب أن يكون البوت في الصوت تلقائياً عندما تكون أنت هناك.
• استخدم autoJoin للبوتات ذات الغرف الثابتة التي يجب أن تكون حاضرة حتى عندما لا يكون أي مستخدم متعقَّب في الصوت.
• استخدم /vc join للانضمامات لمرة واحدة أو للغرف التي سيكون فيها الحضور الصوتي التلقائي مفاجئاً.

• تعرض سجلات استقبال الصوت discord voice: opus decoder: libopus-wasm.
• يشفر تشغيل الوقت الفعلي صوت PCM خاما بتردد 48 كيلوهرتز وبقناتين إلى Opus باستخدام حزمة libopus-wasm المضمنة نفسها قبل تسليم الحزم إلى @discordjs/voice.
• يحول تشغيل الملفات وتدفقات المزود إلى PCM خام بتردد 48 كيلوهرتز وبقناتين باستخدام ffmpeg، ثم يستخدم libopus-wasm لتدفق حزم Opus المرسل إلى Discord.

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

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        model: "openai/gpt-5.5",
        followUsersEnabled: true,
        followUsers: ["123456789012345678"],
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          speakerVoice: "cedar",
        },
      },
    },
  },
}

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

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

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

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

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

• عند الانضمام: 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 بدأ تشغيل صوت المساعد. يبدأ الجسر من هذه النقطة في عد مقاطع إخراج المساعد، وبايتات PCM الخاصة بـ Discord، وبايتات مزود الوقت الفعلي، ومدة الصوت المركب.
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 أو المستلمة منه.
• 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، أو سلوك بوابة ضجيج، أو قيام عميل بتفعيل الميكروفون للحظة قصيرة.
• يعني 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 تشغيل نشط لمقاطعته. لا ينبغي أن يؤدي هذا إلى قطع الصوت.

​

الرسائل الصوتية

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

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

​

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

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

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

{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
        windowSeconds: 60,
        cooldownSeconds: 60,
      },
    },
    discord: {
      // Optional Discord-wide override. Account blocks override individual
      // fields and inherit omitted fields from here.
      botLoopProtection: {
        maxEventsPerWindow: 4,
      },
      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 a Mantis Discord mention with the configured user id.
            Mantis: "MANTIS_DISCORD_USER_ID",
          },
          botLoopProtection: {
            // Allow up to five messages per minute before suppressing the pair.
            maxEventsPerWindow: 5,
            windowSeconds: 60,
            cooldownSeconds: 90,
          },
        },
      },
    },
  },
}

​

مرجع التكوين

​

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

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

​

ذو صلة