Discord

พร้อมใช้งานสำหรับ DM และช่องกิลด์ผ่าน Discord gateway อย่างเป็นทางการ

การตั้งค่าอย่างรวดเร็ว

คุณจะต้องสร้างแอปพลิเคชันใหม่พร้อมบอต เพิ่มบอตไปยังเซิร์ฟเวอร์ของคุณ และจับคู่บอตกับ 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>

แนะนำ: ตั้งค่าเวิร์กสเปซกิลด์

เมื่อ DM ทำงานแล้ว คุณสามารถตั้งค่าเซิร์ฟเวอร์ 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>)
• Group DM จะถูกละเว้นโดยค่าเริ่มต้น (channels.discord.dm.groupEnabled=false)
• คำสั่งสแลชแบบเนทีฟทำงานในเซสชันคำสั่งที่แยกต่างหาก (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 บนปุ่มนั้น (ID ผู้ใช้ Discord, แท็ก หรือ *) เมื่อกำหนดค่าแล้ว ผู้ใช้ที่ไม่ตรงกันจะได้รับการปฏิเสธแบบชั่วคราว

คำสั่งสแลช /model และ /models จะเปิดตัวเลือกโมเดลแบบโต้ตอบ พร้อมดรอปดาวน์ผู้ให้บริการ โมเดล และรันไทม์ที่เข้ากันได้ รวมถึงขั้นตอนส่ง /models add เลิกใช้แล้ว และตอนนี้จะส่งคืนข้อความเลิกใช้แทนการลงทะเบียนโมเดลจากแชต คำตอบของตัวเลือกเป็นแบบชั่วคราว และมีเพียงผู้ใช้ที่เรียกใช้งานเท่านั้นที่ใช้ได้ เมนูเลือกของ Discord จำกัดไว้ที่ 25 ตัวเลือก ดังนั้นให้เพิ่มรายการ provider/* ไปยัง agents.defaults.models เมื่อคุณต้องการให้ตัวเลือกแสดงโมเดลที่ค้นพบแบบไดนามิกเฉพาะสำหรับผู้ให้บริการที่เลือก เช่น openai-codex หรือ vllm

ไฟล์แนบ:

• บล็อก 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[].match.roles เพื่อกำหนดเส้นทางสมาชิกกิลด์ Discord ไปยังเอเจนต์ต่าง ๆ ตาม ID บทบาท การผูกตามบทบาทยอมรับเฉพาะ ID บทบาท และจะถูกประเมินหลังจากการผูก peer หรือ parent-peer และก่อนการผูกเฉพาะกิลด์ หากการผูกตั้งค่าฟิลด์การจับคู่อื่นด้วย (เช่น 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 ข้ามการลงทะเบียนและการล้างคำสั่ง slash-command ของ Discord ระหว่างเริ่มต้น คำสั่งที่ลงทะเบียนไว้ก่อนหน้านี้อาจยังมองเห็นได้ใน Discord จนกว่าคุณจะลบออกจากแอป Discord
• การยืนยันสิทธิ์ของคำสั่งแบบเนทีฟใช้รายการอนุญาต/นโยบายของ Discord ชุดเดียวกับการจัดการข้อความปกติ
• คำสั่งอาจยังมองเห็นได้ใน UI ของ Discord สำหรับผู้ใช้ที่ไม่ได้รับอนุญาต การเรียกใช้ยังคงบังคับใช้การยืนยันสิทธิ์ของ OpenClaw และส่งคืน "not authorized"

ดู คำสั่ง Slash สำหรับแคตตาล็อกคำสั่งและพฤติกรรม

การตั้งค่าคำสั่ง slash เริ่มต้น:

• 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.*

พฤติกรรมเกตเริ่มต้น:

UI คอมโพเนนต์ v2

OpenClaw ใช้คอมโพเนนต์ Discord v2 สำหรับการอนุมัติ exec และเครื่องหมายข้ามบริบท การทำงานของข้อความ Discord ยังรับ components สำหรับ UI แบบกำหนดเองได้ด้วย (ขั้นสูง; ต้องสร้างเพย์โหลดคอมโพเนนต์ผ่านเครื่องมือ 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 เมื่อใช้ allowlist ของบทบาท/ผู้ใช้
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 เพื่อควบคุมเซสชัน คำสั่งใช้เอเจนต์เริ่มต้นของบัญชีและปฏิบัติตามกฎ allowlist และนโยบายกลุ่มเดียวกับคำสั่ง 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" และเลือกเสียง Text-to-speech ภายใต้ voice.tts.openai.voice หรือ voice.tts.providers.openai.voice cedar เป็นตัวเลือกที่ฟังดูเป็นเสียงผู้ชายที่ดีในโมเดล OpenAI TTS ปัจจุบัน
• การแทนที่ 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 แบบ pure-JS เป็นค่าเริ่มต้นสำหรับการรับเสียง Discord แพ็กเกจเนทีฟ @discordjs/opus ที่เป็นตัวเลือกจะถูกละเว้นโดยนโยบายติดตั้ง pnpm ของ repo เพื่อให้การติดตั้งปกติ เลน 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) ซ้ำหลังอัปเดต ให้รวบรวมรายงาน dependency และบันทึก บรรทัด @discordjs/voice ที่บันเดิลมารวมการแก้ไข padding จาก upstream discord.js PR #11449 ซึ่งปิด discord.js issue #11419
• อีเวนต์รับ 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 เมื่อต้องการแอดออนเนทีฟ prebuilt สำหรับ macOS arm64 จาก upstream หากใช้รันไทม์ Node อื่น ตัวติดตั้งแบบเลือกใช้อาจต้องใช้ toolchain สร้างจากซอร์ส node-gyp ในเครื่อง

หลังติดตั้งแอดออนเนทีฟแล้ว ให้เริ่ม Gateway ด้วย:

OPENCLAW_DISCORD_OPUS_DECODER=native pnpm gateway:watch

บันทึกเสียงแบบละเอียดควรแสดง discord voice: opus decoder: @discordjs/opus หากไม่มีการเลือกใช้ผ่าน env หรือหากแอดออนเนทีฟหายไปหรือโหลดบนโฮสต์ไม่ได้ OpenClaw จะบันทึก discord voice: opus decoder: opusscript และรับเสียงต่อผ่านตัวถอยกลับแบบ pure-JS

ไปป์ไลน์ STT ร่วมกับ TTS:

• การจับ PCM ของ Discord ถูกแปลงเป็นไฟล์ชั่วคราว WAV
• tools.media.audio จัดการ STT เช่น openai/gpt-4o-mini-transcribe
• ทรานสคริปต์ถูกส่งผ่าน ingress และการกำหนดเส้นทางของ Discord ขณะที่ LLM ตอบกลับทำงานด้วยนโยบายเอาต์พุตเสียงที่ซ่อนเครื่องมือ tts ของเอเจนต์และขอข้อความที่ส่งกลับ เพราะเสียง Discord เป็นผู้ดูแลการเล่น TTS ขั้นสุดท้าย
• voice.model เมื่อตั้งค่า จะแทนที่เฉพาะ LLM ตอบกลับสำหรับผลัดช่องเสียงนี้
• voice.tts ถูกผสานทับ messages.tts; ผู้ให้บริการที่รองรับการสตรีมจะส่งข้อมูลเข้าตัวเล่นโดยตรง มิฉะนั้นไฟล์เสียงที่ได้จะถูกเล่นในช่องที่เข้าร่วมอยู่

ตัวอย่างเซสชันช่องเสียง agent-proxy เริ่มต้น:

{  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 สัญญาณ barge-in ที่มาเร็วมากซึ่งมี 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=...
• เมื่อ consult แบบเรียลไทม์: 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 ...
• เมื่อตรวจพบ barge-in: 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
• เมื่อปิดใช้ barge-in: 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 เริ่มเล่นเสียงผู้ช่วยแล้ว bridge จะเริ่มนับชังก์เอาต์พุตของผู้ช่วย, ไบต์ 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 หมายความว่ารอบผู้พูดเปิดขึ้นแต่ไม่มีเสียงที่ใช้ได้ไปถึง bridge แบบเรียลไทม์ interruptedPlayback=true หมายความว่ารอบอินพุตนั้นซ้อนทับกับเอาต์พุตของผู้ช่วยและทริกเกอร์ตรรกะ barge-in

ฟิลด์ที่มีประโยชน์:

• outputAudioMs: ระยะเวลาเสียงผู้ช่วยที่สร้างโดยผู้ให้บริการแบบเรียลไทม์ก่อนบรรทัดบันทึก
• audioMs: ระยะเวลาเสียงผู้ช่วยที่ OpenClaw นับก่อนการเล่นกลับหยุด
• elapsedMs: เวลาตามนาฬิกาจริงระหว่างการเปิดและปิดสตรีมเล่นกลับหรือรอบผู้พูด
• discordBytes: ไบต์ PCM สเตอริโอ 48 kHz ที่ส่งไปยังหรือรับจากเสียง 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 ชั่วคราว พฤติกรรม noise gate หรือไคลเอนต์กดไมค์ชั่วครู่
• audio playback stopped reason=stream-close โดยไม่มี barge-in หรือ provider-clear-audio ใกล้เคียง หมายความว่าสตรีมเล่นกลับ Discord ภายในเครื่องจบลงโดยไม่คาดคิด ตรวจสอบบันทึกผู้ให้บริการและเครื่องเล่น Discord ก่อนหน้า
• capture ignored during playback (barge-in disabled) หมายความว่า OpenClaw ตั้งใจทิ้งอินพุตขณะที่เสียงผู้ช่วยกำลังทำงาน เปิดใช้ voice.realtime.bargeIn หากคุณต้องการให้คำพูดขัดจังหวะการเล่นกลับ
• barge-in ignored ... outputActive=false หมายความว่า Discord หรือ VAD ของผู้ให้บริการรายงานคำพูด แต่ OpenClaw ไม่มีการเล่นกลับที่กำลังทำงานให้ขัดจังหวะ สิ่งนี้ไม่ควรตัดเสียง

ข้อมูลประจำตัวจะถูกแก้ตามแต่ละคอมโพเนนต์: auth เส้นทาง LLM สำหรับ voice.model, auth STT สำหรับ tools.media.audio, auth TTS สำหรับ messages.tts/voice.tts, และ auth ผู้ให้บริการแบบเรียลไทม์สำหรับ voice.realtime.providers หรือคอนฟิก auth ปกติของผู้ให้บริการ

ข้อความเสียง

ข้อความเสียง Discord แสดงตัวอย่างรูปคลื่นและต้องใช้เสียง OGG/Opus OpenClaw สร้างรูปคลื่นให้อัตโนมัติ แต่ต้องมี ffmpeg และ ffprobe บนโฮสต์ Gateway เพื่อตรวจสอบและแปลง

• ระบุ พาธไฟล์ภายในเครื่อง (URL จะถูกปฏิเสธ)
• ละเว้นเนื้อหาข้อความ (Discord ปฏิเสธข้อความ + ข้อความเสียงใน payload เดียวกัน)
• ยอมรับรูปแบบเสียงใดก็ได้ 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 ตามหลักสิทธิ์น้อยที่สุด
• หากการ deploy/สถานะของคำสั่งล้าสมัย ให้รีสตาร์ท Gateway แล้วตรวจสอบอีกครั้งด้วย openclaw channels status --probe

ที่เกี่ยวข้อง