Discord

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

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>).
• تُتجاهل الرسائل المباشرة الجماعية افتراضيًا (channels.discord.dm.groupEnabled=false).
• تعمل أوامر slash الأصلية في جلسات أوامر معزولة (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: {
      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",
      },
    },
  },
}

​

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

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

​

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

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

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

​

الصوت

​

قنوات الصوت

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 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=... عندما يمنع ذلك إجابة قديمة في الطابور.

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

OPENCLAW_DISCORD_OPUS_DECODER=native pnpm gateway:watch

• يتم تحويل التقاط 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",
        },
      },
    },
  },
}

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

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

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

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

{
  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 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 تشغيل نشط لمقاطعته. لا ينبغي أن يؤدي هذا إلى قطع الصوت.

​

رسائل الصوت

• وفّر مسار ملف محليًا (تُرفض عناوين 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: {
    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_BOT_TOKEN في البيئات الخاضعة للإشراف).
• امنح أذونات Discord بأقل امتيازات ممكنة.
• إذا كانت حالة نشر الأوامر/الحالة قديمة، فأعد تشغيل Gateway ثم أعد الفحص باستخدام openclaw channels status --probe.

​

ذات صلة