Discord

OpenClaw kết nối với Discord dưới dạng bot thông qua gateway chính thức của Discord. Hỗ trợ tin nhắn trực tiếp và các kênh máy chủ.

Thiết lập nhanh

Tạo một ứng dụng Discord có bot, thêm bot vào máy chủ của bạn và ghép nối bot với OpenClaw. Nếu có thể, hãy sử dụng máy chủ riêng tư; nếu cần, hãy tạo máy chủ trước (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>

Khuyến nghị: Thiết lập không gian làm việc trên máy chủ

Sau khi tin nhắn trực tiếp hoạt động, bạn có thể biến máy chủ thành một không gian làm việc đầy đủ, trong đó mỗi kênh có phiên tác tử và ngữ cảnh riêng. Khuyến nghị cho máy chủ riêng tư chỉ có bạn và bot.

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

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

Bây giờ hãy tạo các kênh và bắt đầu trò chuyện. Tác tử nhìn thấy tên kênh và mỗi kênh là một phiên biệt lập — hãy thiết lập #coding, #home, #research hoặc bất kỳ tên nào phù hợp với quy trình làm việc của bạn.

Mô hình thời gian chạy

• Gateway quản lý kết nối Discord.
• Việc định tuyến phản hồi mang tính xác định: phản hồi cho dữ liệu đến từ Discord sẽ được gửi lại Discord.
• Siêu dữ liệu máy chủ/kênh Discord được thêm vào lời nhắc mô hình dưới dạng ngữ cảnh không đáng tin cậy, không phải dưới dạng tiền tố phản hồi hiển thị cho người dùng. Nếu mô hình sao chép lại lớp bao này, OpenClaw sẽ loại bỏ siêu dữ liệu đã sao chép khỏi các phản hồi gửi đi và khỏi ngữ cảnh phát lại trong tương lai.
• Theo mặc định (session.dmScope=main), các cuộc trò chuyện trực tiếp dùng chung phiên chính của tác tử (agent:main:main).
• Các kênh máy chủ có khóa phiên biệt lập (agent:<agentId>:discord:channel:<channelId>).
• Tin nhắn trực tiếp nhóm mặc định bị bỏ qua (channels.discord.dm.groupEnabled=false).
• Các lệnh gạch chéo gốc chạy trong các phiên lệnh biệt lập (agent:<agentId>:discord:slash:<userId>), đồng thời vẫn mang CommandTargetSessionKey đến phiên hội thoại được định tuyến.
• Việc gửi thông báo Cron/Heartbeat chỉ có văn bản đến Discord được thu gọn thành câu trả lời cuối cùng hiển thị từ trợ lý và chỉ gửi một lần. Nội dung phương tiện và tải thành phần có cấu trúc vẫn được gửi thành nhiều tin nhắn khi tác tử tạo ra nhiều tải có thể gửi.

Kênh diễn đàn

Các kênh diễn đàn và phương tiện của Discord chỉ chấp nhận bài đăng theo luồng. OpenClaw hỗ trợ hai cách để tạo chúng:

• Gửi tin nhắn đến kênh cha của diễn đàn (channel:<forumId>) để tự động tạo một luồng. Tiêu đề luồng là dòng không trống đầu tiên của tin nhắn (được cắt ngắn theo giới hạn 100 ký tự của Discord đối với tên luồng).
• Dùng openclaw message thread create để tạo trực tiếp một luồng. Không truyền --message-id cho các kênh diễn đàn.

Gửi đến kênh cha của diễn đàn để tạo một luồng:

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

Tạo một luồng diễn đàn một cách tường minh:

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

Kênh cha của diễn đàn không chấp nhận các thành phần Discord. Nếu cần các thành phần, hãy gửi đến chính luồng đó (channel:<threadId>).

Thành phần tương tác

OpenClaw hỗ trợ các vùng chứa thành phần v2 của Discord cho tin nhắn của tác tử. Dùng công cụ tin nhắn với tải trọng components. Kết quả tương tác được định tuyến trở lại tác tử như tin nhắn đến thông thường và tuân theo các cài đặt replyToMode hiện có của Discord.

Các khối được hỗ trợ:

• text, section, separator, actions, media-gallery, file
• Hàng hành động cho phép tối đa 5 nút hoặc một menu chọn duy nhất
• Các loại lựa chọn: string, user, role, mentionable, channel

Theo mặc định, các thành phần chỉ dùng một lần. Đặt components.reusable=true để cho phép dùng nút, lựa chọn và biểu mẫu nhiều lần cho đến khi hết hạn.

Để giới hạn người có thể nhấp vào một nút, hãy đặt allowedUsers trên nút đó (ID người dùng Discord, thẻ hoặc *). Người dùng không khớp sẽ nhận được thông báo từ chối chỉ hiển thị với họ.

Theo mặc định, lệnh gọi lại của thành phần hết hạn sau 30 phút. Đặt channels.discord.agentComponents.ttlMs để thay đổi thời gian tồn tại của sổ đăng ký lệnh gọi lại cho tài khoản mặc định, hoặc channels.discord.accounts.<accountId>.agentComponents.ttlMs cho từng tài khoản. Giá trị tính bằng mili giây, phải là số nguyên dương và bị giới hạn tối đa ở 86400000 (24 giờ). TTL dài hơn phù hợp với quy trình xem xét/phê duyệt cần duy trì khả năng sử dụng của các nút, nhưng cũng kéo dài khoảng thời gian mà một tin nhắn Discord cũ vẫn có thể kích hoạt hành động. Hãy ưu tiên TTL ngắn nhất đáp ứng nhu cầu và giữ giá trị mặc định nếu các lệnh gọi lại cũ có thể gây bất ngờ.

Các lệnh gạch chéo /model và /models mở trình chọn mô hình tương tác với các danh sách thả xuống cho nhà cung cấp, mô hình và môi trường chạy tương thích, cùng một bước Submit. /models add đã lỗi thời và trả về thông báo lỗi thời thay vì đăng ký mô hình từ cuộc trò chuyện. Phản hồi của trình chọn chỉ hiển thị với người dùng gọi lệnh và chỉ người đó mới có thể sử dụng. Menu chọn của Discord bị giới hạn ở 25 tùy chọn, vì vậy hãy thêm các mục provider/* vào agents.defaults.models khi bạn muốn trình chọn chỉ hiển thị các mô hình được phát hiện động cho những nhà cung cấp đã chọn như openai hoặc vllm.

Tệp đính kèm:

• Các khối file phải trỏ đến một tham chiếu tệp đính kèm (attachment://<filename>)
• Cung cấp tệp đính kèm qua media/path/filePath (một tệp); dùng media-gallery cho nhiều tệp
• Dùng filename để ghi đè tên tải lên khi tên đó cần khớp với tham chiếu tệp đính kèm

Biểu mẫu hộp thoại:

• Thêm components.modal với tối đa 5 trường
• Các loại trường: text, checkbox, radio, select, role-select, user-select
• OpenClaw tự động thêm nút kích hoạt

Ví dụ:

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

Kiểm soát truy cập và định tuyến

{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: { enabled: true },        help: { enabled: true, requireMention: true },      },    },  },},},}

Định tuyến tác tử dựa trên vai trò

Dùng bindings[].match.roles để định tuyến các thành viên máy chủ Discord đến các tác tử khác nhau theo ID vai trò. Các liên kết dựa trên vai trò chỉ chấp nhận ID vai trò và được đánh giá sau các liên kết ngang hàng hoặc ngang hàng cha, nhưng trước các liên kết chỉ dành cho máy chủ. Nếu một liên kết còn đặt các trường khớp khác (ví dụ peer + guildId + roles), tất cả các trường đã cấu hình đều phải khớp.

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

Lệnh gốc và ủy quyền lệnh

• commands.native mặc định là "auto" và được bật cho Discord.
• Ghi đè theo từng kênh: channels.discord.commands.native.
• commands.native=false bỏ qua việc đăng ký và dọn dẹp lệnh gạch chéo của Discord khi khởi động. Các lệnh đã đăng ký trước đó có thể vẫn hiển thị trong Discord cho đến khi bạn xóa chúng khỏi ứng dụng Discord.
• Việc xác thực lệnh gốc sử dụng cùng danh sách cho phép/chính sách Discord như khi xử lý tin nhắn thông thường.
• Các lệnh vẫn có thể hiển thị trong giao diện Discord đối với người dùng không được cấp quyền; khi thực thi, OpenClaw áp dụng xác thực và trả lời "không được cấp quyền".
• Cài đặt lệnh gạch chéo mặc định: ephemeral: true (channels.discord.slashCommand.ephemeral).

Xem Lệnh gạch chéo để biết danh mục lệnh và hành vi.

Chi tiết tính năng

{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_...", // tùy chọn; cần thiết cho các hệ thống riêng tư  },},},}

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

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

{channels: {discord: {  activity: "Thời gian tập trung",  activityType: 4,},},}

{channels: {discord: {  activity: "Lập trình trực tiếp",  activityType: 1,  activityUrl: "https://twitch.tv/openclaw",},},}

{channels: {discord: {  autoPresence: {    enabled: true,    intervalMs: 30000,    minUpdateIntervalMs: 15000,    exhaustedText: "token đã cạn",  },},},}

Công cụ và cổng kiểm soát hành động

Các hành động tin nhắn Discord bao gồm nhắn tin, quản trị kênh, kiểm duyệt, trạng thái hiện diện và siêu dữ liệu.

Ví dụ cốt lõi:

• nhắn tin: sendMessage, readMessages, editMessage, deleteMessage, threadReply
• phản ứng: react, reactions, emojiList
• kiểm duyệt: timeout, kick, ban
• trạng thái hiện diện: setPresence

Hành động event-create chấp nhận tham số image tùy chọn (URL hoặc đường dẫn tệp cục bộ) để đặt ảnh bìa cho sự kiện đã lên lịch.

Các cổng kiểm soát hành động nằm dưới channels.discord.actions.*.

Hành vi cổng mặc định:

Giao diện người dùng components v2

OpenClaw sử dụng Discord components v2 cho phê duyệt thực thi và dấu mốc xuyên ngữ cảnh. Các hành động tin nhắn Discord cũng có thể chấp nhận components cho giao diện người dùng tùy chỉnh (nâng cao; yêu cầu tạo tải trọng thành phần thông qua công cụ discord), trong khi embeds cũ vẫn khả dụng nhưng không được khuyến nghị.

• channels.discord.ui.components.accentColor đặt màu nhấn được các vùng chứa thành phần Discord sử dụng (hệ thập lục phân). Theo từng tài khoản: channels.discord.accounts.<id>.ui.components.accentColor.
• channels.discord.agentComponents.ttlMs kiểm soát khoảng thời gian các lệnh gọi lại thành phần Discord đã gửi tiếp tục được đăng ký (mặc định 1800000, tối đa 86400000). Theo từng tài khoản: channels.discord.accounts.<id>.agentComponents.ttlMs.
• embeds bị bỏ qua khi có components v2.
• Theo mặc định, bản xem trước URL thuần túy bị ẩn. Đặt suppressEmbeds: false trên một hành động tin nhắn khi cần mở rộng một liên kết gửi đi duy nhất.

Ví dụ:

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

Thoại

Discord có hai bề mặt thoại riêng biệt: kênh thoại thời gian thực (các cuộc trò chuyện liên tục) và tệp đính kèm tin nhắn thoại (định dạng xem trước dạng sóng). Gateway hỗ trợ cả hai.

Kênh thoại

Danh sách kiểm tra thiết lập:

1. Bật Message Content Intent trong Discord Developer Portal.
2. Bật Server Members Intent khi sử dụng danh sách cho phép theo vai trò/người dùng.
3. Mời bot với các phạm vi bot và applications.commands.
4. Cấp quyền Connect, Speak, Send Messages và Read Message History trong kênh thoại đích.
5. Bật lệnh gốc (commands.native hoặc channels.discord.commands.native).
6. Cấu hình channels.discord.voice.

Sử dụng /vc join|leave|status để điều khiển phiên. Lệnh sử dụng tác tử mặc định của tài khoản và tuân theo cùng các quy tắc danh sách cho phép và chính sách nhóm như các lệnh Discord khác.

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

Để kiểm tra các quyền có hiệu lực của bot trước khi tham gia:

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

Ví dụ tự động tham gia:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai/gpt-5.6-sol",        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.1",          speakerVoice: "cedar",        },      },    },  },}

Lưu ý:

• Giọng nói Discord là tính năng tùy chọn đối với các cấu hình chỉ dùng văn bản; đặt channels.discord.voice.enabled=true (hoặc giữ lại khối channels.discord.voice hiện có) để bật các lệnh /vc, môi trường chạy giọng nói và gateway intent GuildVoiceStates. channels.discord.intents.voiceStates có thể ghi đè rõ ràng việc đăng ký intent; để không đặt nhằm tuân theo trạng thái bật giọng nói có hiệu lực.
• voice.mode kiểm soát luồng hội thoại. Mặc định là agent-proxy: một giao diện giọng nói thời gian thực xử lý thời điểm chuyển lượt, ngắt lời và phát âm thanh, ủy quyền công việc thực chất cho tác nhân OpenClaw được định tuyến thông qua openclaw_agent_consult, đồng thời xử lý kết quả như một lời nhắc Discord được người nói đó nhập bằng văn bản. stt-tts giữ lại luồng STT theo lô cộng với TTS cũ hơn. bidi cho phép mô hình thời gian thực hội thoại trực tiếp, đồng thời cung cấp openclaw_agent_consult để sử dụng bộ não OpenClaw.
• voice.agentSession kiểm soát cuộc hội thoại OpenClaw nào nhận các lượt giọng nói. Để không đặt nếu muốn dùng phiên riêng của kênh thoại, hoặc đặt { mode: "target", target: "channel:<text-channel-id>" } để kênh thoại hoạt động như phần mở rộng micrô/loa của một phiên kênh văn bản Discord hiện có, chẳng hạn như #maintainers.
• voice.model ghi đè bộ não tác nhân OpenClaw dùng cho phản hồi giọng nói Discord và các lượt tham vấn thời gian thực. Để không đặt nhằm kế thừa mô hình tác nhân được định tuyến. Thiết lập này tách biệt với voice.realtime.model.
• voice.followUsers cho phép bot tham gia, di chuyển và rời khỏi kênh thoại Discord cùng những người dùng được chọn. Xem Theo dõi người dùng trong kênh thoại.
• agent-proxy định tuyến lời nói qua discord-voice, cơ chế này duy trì việc ủy quyền công cụ/chủ sở hữu thông thường cho người nói và phiên đích nhưng ẩn công cụ tts của tác nhân vì giọng nói Discord chịu trách nhiệm phát âm thanh. Theo mặc định, agent-proxy cấp cho lượt tham vấn quyền truy cập công cụ đầy đủ tương đương chủ sở hữu đối với người nói là chủ sở hữu (voice.realtime.toolPolicy: "owner") và đặc biệt ưu tiên tham vấn tác nhân OpenClaw trước khi đưa ra câu trả lời có nội dung thực chất (voice.realtime.consultPolicy: "always"). Trong chế độ always mặc định đó, lớp thời gian thực không tự động phát lời đệm trước câu trả lời tham vấn; nó thu và chuyển lời nói thành văn bản, sau đó phát câu trả lời OpenClaw đã được định tuyến. Nếu nhiều câu trả lời tham vấn bắt buộc hoàn tất trong khi Discord vẫn đang phát câu trả lời đầu tiên, các câu trả lời lời nói chính xác tiếp theo sẽ được xếp hàng cho đến khi quá trình phát rảnh, thay vì thay thế lời nói giữa câu.
• Trong chế độ stt-tts, STT sử dụng tools.media.audio; voice.model không ảnh hưởng đến việc chuyển lời nói thành văn bản.
• Trong các chế độ thời gian thực, voice.realtime.provider, voice.realtime.model và voice.realtime.speakerVoice cấu hình phiên âm thanh thời gian thực. Để sử dụng OpenAI Realtime 2.1 cùng bộ não Codex, hãy dùng voice.realtime.model: "gpt-realtime-2.1" và voice.model: "openai/gpt-5.6-sol".
• Theo mặc định, các chế độ giọng nói thời gian thực đưa những tệp hồ sơ nhỏ IDENTITY.md, USER.md và SOUL.md vào chỉ dẫn của nhà cung cấp thời gian thực, để các lượt trực tiếp nhanh duy trì cùng danh tính, nền tảng thông tin người dùng và cá tính như tác nhân OpenClaw được định tuyến. Đặt voice.realtime.bootstrapContextFiles thành một tập con để tùy chỉnh, hoặc [] để tắt. Chỉ các tệp hồ sơ đó được hỗ trợ; AGENTS.md vẫn nằm trong ngữ cảnh tác nhân thông thường. Ngữ cảnh hồ sơ được chèn không thay thế openclaw_agent_consult cho công việc trong không gian làm việc, dữ kiện hiện tại, tra cứu bộ nhớ hoặc hành động dựa trên công cụ.
• Trong chế độ thời gian thực agent-proxy của OpenAI, đặt voice.realtime.requireWakeName: true để giữ giọng nói thời gian thực Discord im lặng cho đến khi bản chép lời bắt đầu hoặc kết thúc bằng một tên đánh thức. Tên đánh thức được cấu hình phải dài một hoặc hai từ. Nếu không đặt voice.realtime.wakeNames, OpenClaw sử dụng name của tác nhân được định tuyến cộng với OpenClaw, và dự phòng bằng mã định danh tác nhân cộng với OpenClaw. Cơ chế kiểm soát bằng tên đánh thức sẽ tắt tính năng tự động phản hồi của nhà cung cấp thời gian thực, định tuyến các lượt được chấp nhận qua luồng tham vấn tác nhân OpenClaw và phát một lời xác nhận ngắn khi tên đánh thức ở đầu được nhận diện từ bản chép lời một phần trước khi bản chép lời cuối cùng đến.
• Nhà cung cấp thời gian thực OpenAI chấp nhận tên sự kiện Realtime 2 hiện tại và các bí danh cũ tương thích với Codex cho sự kiện âm thanh đầu ra và bản chép lời, nhờ đó các bản chụp nhanh tương thích của nhà cung cấp có thể thay đổi mà không làm mất âm thanh của trợ lý.
• voice.realtime.bargeIn kiểm soát việc các sự kiện bắt đầu nói của người nói trên Discord có ngắt quá trình phát thời gian thực đang hoạt động hay không. Nếu không đặt, thiết lập này tuân theo cài đặt ngắt do âm thanh đầu vào của nhà cung cấp thời gian thực.
• voice.realtime.minBargeInAudioEndMs kiểm soát thời lượng phát tối thiểu của trợ lý trước khi một lượt ngắt lời thời gian thực OpenAI cắt ngắn âm thanh. Mặc định: 250. Đặt 0 để ngắt ngay lập tức trong phòng ít tiếng vọng, hoặc tăng giá trị này cho các thiết lập loa có nhiều tiếng vọng.
• voice.tts chỉ ghi đè messages.tts cho việc phát giọng nói ở chế độ stt-tts; các chế độ thời gian thực sử dụng voice.realtime.speakerVoice thay thế. Để dùng một giọng OpenAI khi phát trên Discord, hãy đặt voice.tts.provider: "openai" và chọn một giọng chuyển văn bản thành lời nói trong voice.tts.providers.openai.speakerVoice. cedar là một lựa chọn có chất giọng nam phù hợp trên mô hình TTS OpenAI hiện tại.
• Các giá trị ghi đè systemPrompt theo từng kênh Discord áp dụng cho các lượt bản chép lời giọng nói của kênh thoại đó.
• Các lượt bản chép lời giọng nói suy ra trạng thái chủ sở hữu từ allowFrom (hoặc dm.allowFrom) của Discord cho các lệnh và hành động kênh bị giới hạn cho chủ sở hữu. Khả năng hiển thị công cụ của tác nhân tuân theo chính sách công cụ được cấu hình cho phiên được định tuyến.
• Nếu voice.autoJoin có nhiều mục cho cùng một máy chủ, OpenClaw sẽ tham gia kênh được cấu hình cuối cùng cho máy chủ đó.
• voice.allowedChannels là một danh sách cho phép lưu trú tùy chọn. Để không đặt nhằm cho phép /vc join tham gia bất kỳ kênh thoại Discord nào được ủy quyền. Khi được đặt, /vc join, tự động tham gia lúc khởi động và việc di chuyển trạng thái thoại của bot bị giới hạn ở các mục { guildId, channelId } đã liệt kê. Đặt thành một mảng rỗng để từ chối mọi lượt tham gia kênh thoại Discord. Nếu Discord di chuyển bot ra ngoài danh sách cho phép, OpenClaw sẽ rời kênh đó và tham gia lại đích tự động tham gia đã cấu hình khi có sẵn.
• voice.daveEncryption và voice.decryptionFailureTolerance được chuyển trực tiếp đến các tùy chọn tham gia của @discordjs/voice; giá trị mặc định từ thượng nguồn là daveEncryption=true và decryptionFailureTolerance=24.
• OpenClaw sử dụng codec libopus-wasm đi kèm để nhận giọng nói Discord và phát PCM thô theo thời gian thực. Gói này cung cấp một bản dựng WebAssembly libopus được cố định phiên bản và không yêu cầu phần bổ trợ opus gốc.
• voice.connectTimeoutMs kiểm soát thời gian chờ trạng thái Ready ban đầu của @discordjs/voice cho /vc join và các lần thử tự động tham gia. Mặc định: 30000.
• voice.reconnectGraceMs kiểm soát khoảng thời gian OpenClaw chờ một phiên thoại đã ngắt kết nối bắt đầu kết nối lại trước khi hủy phiên đó. Mặc định: 15000.
• Trong chế độ stt-tts, quá trình phát giọng nói không dừng chỉ vì người dùng khác bắt đầu nói. Để tránh vòng lặp phản hồi âm thanh, OpenClaw bỏ qua việc thu giọng nói mới trong khi TTS đang phát; hãy nói sau khi phát xong để bắt đầu lượt tiếp theo. Các chế độ thời gian thực chuyển tiếp sự kiện bắt đầu nói dưới dạng tín hiệu ngắt lời đến nhà cung cấp thời gian thực.
• Trong các chế độ thời gian thực, tiếng vọng từ loa vào micrô đang mở có thể bị coi là ngắt lời và làm gián đoạn quá trình phát. Đối với phòng Discord có nhiều tiếng vọng, hãy đặt voice.realtime.providers.openai.interruptResponseOnInputAudio: false để ngăn OpenAI tự động ngắt khi có âm thanh đầu vào. Thêm voice.realtime.bargeIn: true nếu bạn vẫn muốn các sự kiện bắt đầu nói của người nói trên Discord ngắt quá trình phát đang hoạt động. Cầu nối thời gian thực OpenAI bỏ qua các lần cắt ngắn quá trình phát có thời lượng ngắn hơn voice.realtime.minBargeInAudioEndMs vì có khả năng là tiếng vọng/tiếng ồn và ghi nhật ký rằng chúng đã bị bỏ qua, thay vì xóa quá trình phát Discord.
• voice.captureSilenceGraceMs kiểm soát khoảng thời gian OpenClaw chờ sau khi Discord báo rằng người nói đã dừng trước khi hoàn tất đoạn âm thanh đó để STT xử lý. Mặc định: 2000; hãy tăng giá trị này nếu Discord chia các khoảng dừng thông thường thành những bản chép lời một phần rời rạc.
• Khi ElevenLabs là nhà cung cấp TTS được chọn, quá trình phát giọng nói Discord sử dụng TTS truyền phát và bắt đầu từ luồng phản hồi của nhà cung cấp. Các nhà cung cấp không hỗ trợ truyền phát sẽ dự phòng về luồng dùng tệp tạm đã tổng hợp.
• OpenClaw theo dõi các lỗi giải mã khi nhận và tự động khôi phục bằng cách rời rồi tham gia lại kênh thoại sau nhiều lần lỗi trong một khoảng thời gian ngắn.
• Nếu nhật ký nhận liên tục hiển thị DecryptionFailed(UnencryptedWhenPassthroughDisabled) sau khi cập nhật, hãy thu thập báo cáo phụ thuộc và nhật ký. Phiên bản @discordjs/voice đi kèm bao gồm bản sửa lỗi phần đệm từ PR #11449 của discord.js, bản sửa này đã đóng vấn đề #11419 của discord.js.
• Các sự kiện nhận The operation was aborted là bình thường khi OpenClaw hoàn tất một đoạn âm thanh đã thu của người nói; đây là thông tin chẩn đoán chi tiết, không phải cảnh báo.
• Nhật ký giọng nói Discord chi tiết bao gồm bản xem trước bản chép lời STT một dòng có giới hạn cho mỗi đoạn âm thanh người nói được chấp nhận, nhờ đó quá trình gỡ lỗi hiển thị cả phía người dùng lẫn phía phản hồi của tác nhân mà không xuất văn bản bản chép lời không giới hạn.
• Trong chế độ agent-proxy, cơ chế dự phòng tham vấn bắt buộc bỏ qua các đoạn bản chép lời có khả năng chưa hoàn chỉnh, chẳng hạn như văn bản kết thúc bằng ... hoặc một từ nối ở cuối như "và", cùng những lời kết thúc rõ ràng không cần hành động như "tôi quay lại ngay" hoặc "tạm biệt". Nhật ký hiển thị forced agent consult skipped reason=... khi cơ chế này ngăn một câu trả lời cũ đang xếp hàng.

Theo dõi người dùng trong kênh thoại

Sử dụng voice.followUsers khi bạn muốn bot thoại Discord ở cùng một hoặc nhiều người dùng Discord đã biết, thay vì tham gia một kênh cố định lúc khởi động hoặc chờ /vc join.

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

Hành vi:

• followUsers chấp nhận mã định danh người dùng Discord thô và các giá trị discord:<id>. OpenClaw chuẩn hóa cả hai dạng trước khi đối chiếu các sự kiện trạng thái thoại.
• followUsersEnabled mặc định là true khi followUsers được cấu hình. Đặt thành false để giữ danh sách đã lưu nhưng dừng việc tự động theo dõi bằng giọng nói.
• Khi một người dùng được theo dõi tham gia kênh thoại được phép, OpenClaw tham gia kênh đó. Khi người dùng di chuyển, OpenClaw di chuyển theo họ. Khi người dùng được theo dõi đang hoạt động ngắt kết nối, OpenClaw rời kênh.
• Nếu nhiều người dùng được theo dõi ở trong cùng một máy chủ và người dùng được theo dõi đang hoạt động rời đi, OpenClaw sẽ chuyển sang kênh của một người dùng được theo dõi khác đang được theo dõi trước khi rời máy chủ. Nếu nhiều người dùng được theo dõi di chuyển cùng lúc, sự kiện trạng thái thoại được quan sát gần nhất sẽ được ưu tiên.
• allowedChannels vẫn được áp dụng. Người dùng được theo dõi trong một kênh không được phép sẽ bị bỏ qua, và phiên do tính năng theo dõi sở hữu sẽ chuyển sang một người dùng được theo dõi khác hoặc rời đi.
• OpenClaw đối soát các sự kiện trạng thái thoại bị bỏ lỡ khi khởi động và theo một khoảng thời gian có giới hạn. Quá trình đối soát lấy mẫu các máy chủ đã cấu hình và giới hạn số lượt tra cứu REST trong mỗi lần chạy, vì vậy danh sách followUsers rất lớn có thể cần nhiều hơn một khoảng thời gian để hội tụ.
• Nếu Discord hoặc quản trị viên di chuyển bot trong khi bot đang theo dõi một người dùng, OpenClaw sẽ dựng lại phiên thoại và duy trì quyền sở hữu của tính năng theo dõi khi đích đến được phép. Nếu bot bị di chuyển ra ngoài allowedChannels, OpenClaw sẽ rời đi và tham gia lại đích đã cấu hình khi có đích đó.
• Cơ chế khôi phục nhận DAVE có thể rời rồi tham gia lại cùng một kênh sau nhiều lần giải mã thất bại. Các phiên do tính năng theo dõi sở hữu vẫn duy trì quyền sở hữu của tính năng theo dõi trong suốt luồng khôi phục đó, vì vậy việc người dùng được theo dõi ngắt kết nối sau đó vẫn khiến bot rời kênh.

Chọn giữa các chế độ tham gia:

• Sử dụng followUsers cho các thiết lập cá nhân hoặc dành cho người vận hành, trong đó bot cần tự động có mặt trong kênh thoại khi bạn ở đó.
• Sử dụng autoJoin cho các bot phòng cố định cần hiện diện ngay cả khi không có người dùng được theo dõi nào trong kênh thoại.
• Sử dụng /vc join cho các lượt tham gia một lần hoặc những phòng mà sự hiện diện giọng nói tự động có thể gây bất ngờ.

Codec giọng nói Discord:

• Nhật ký nhận giọng nói hiển thị discord voice: opus decoder: libopus-wasm.
• Quá trình phát thời gian thực mã hóa PCM stereo thô 48 kHz thành Opus bằng cùng gói libopus-wasm đi kèm trước khi chuyển các gói tin cho @discordjs/voice.
• Quá trình phát tệp và luồng của nhà cung cấp chuyển mã thành PCM stereo thô 48 kHz bằng ffmpeg, sau đó sử dụng libopus-wasm cho luồng gói tin Opus được gửi đến Discord.

Quy trình STT cộng với TTS:

• Luồng thu PCM của Discord được chuyển đổi thành một tệp WAV tạm thời.
• tools.media.audio xử lý STT, ví dụ openai/gpt-4o-mini-transcribe.
• Bản chép lời được gửi qua luồng tiếp nhận và định tuyến của Discord trong khi LLM phản hồi chạy với chính sách đầu ra giọng nói, chính sách này ẩn công cụ tts của tác tử và yêu cầu trả về văn bản, vì kênh thoại Discord chịu trách nhiệm phát TTS cuối cùng.
• Khi được đặt, voice.model chỉ ghi đè LLM phản hồi cho lượt kênh thoại này.
• voice.tts được hợp nhất lên trên messages.tts; các nhà cung cấp hỗ trợ truyền phát đưa dữ liệu trực tiếp vào trình phát, nếu không thì tệp âm thanh kết quả sẽ được phát trong kênh đã tham gia.

Ví dụ về phiên kênh thoại proxy tác tử mặc định:

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

Khi không có khối voice.agentSession, mỗi kênh thoại sẽ có một phiên OpenClaw được định tuyến riêng. Ví dụ, /vc join channel:234567890123456789 giao tiếp với phiên của kênh thoại Discord đó. Mô hình thời gian thực chỉ là giao diện giọng nói; các yêu cầu thực chất được chuyển cho tác tử OpenClaw đã cấu hình. Nếu mô hình thời gian thực tạo ra bản chép lời cuối cùng mà không gọi công cụ tham vấn, OpenClaw sẽ buộc thực hiện tham vấn như một phương án dự phòng để hành vi mặc định vẫn giống như đang nói chuyện với tác tử.

Ví dụ STT cộng TTS cũ:

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

Ví dụ hai chiều thời gian thực:

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

Giọng nói như phần mở rộng của một phiên kênh Discord hiện có:

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

Ở chế độ agent-proxy, bot tham gia kênh thoại đã cấu hình, nhưng các lượt của tác tử OpenClaw sử dụng tác tử và phiên được định tuyến thông thường của kênh đích. Phiên giọng nói thời gian thực đọc kết quả trả về trong kênh thoại. Tác tử giám sát vẫn có thể sử dụng các công cụ nhắn tin thông thường theo chính sách công cụ của nó, bao gồm gửi một tin nhắn Discord riêng nếu đó là hành động phù hợp.

Trong khi một lượt chạy OpenClaw được ủy quyền đang hoạt động, các bản chép lời giọng nói Discord mới được xem là lệnh điều khiển trực tiếp cho lượt chạy trước khi bắt đầu một lượt tác tử khác. Các cụm từ như "trạng thái", "hủy việc đó", "dùng bản sửa nhỏ hơn" hoặc "khi xong cũng hãy kiểm tra các bài kiểm thử" được phân loại là đầu vào trạng thái, hủy, điều hướng hoặc tiếp nối cho phiên đang hoạt động. Kết quả trạng thái, hủy, điều hướng được chấp nhận và tiếp nối được đọc lại trong kênh thoại để người gọi biết OpenClaw có xử lý yêu cầu hay không.

Các dạng đích hữu ích:

• target: "channel:123456789012345678" định tuyến qua phiên của một kênh văn bản Discord.
• target: "123456789012345678" được xem là đích kênh.
• target: "dm:123456789012345678" hoặc target: "user:123456789012345678" định tuyến qua phiên tin nhắn trực tiếp tương ứng.

Ví dụ OpenAI Realtime có nhiều tiếng vọng:

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

Dùng cấu hình này khi mô hình nghe thấy âm thanh Discord do chính nó phát qua micrô đang mở, nhưng bạn vẫn muốn ngắt lời bằng cách nói. OpenClaw ngăn OpenAI tự động ngắt khi nhận âm thanh đầu vào thô, trong khi bargeIn: true cho phép các sự kiện bắt đầu nói của người dùng Discord và âm thanh của người nói đang hoạt động hủy các phản hồi thời gian thực đang hoạt động trước khi lượt thu tiếp theo đến OpenAI. Các tín hiệu ngắt lời quá sớm có audioEndMs thấp hơn minBargeInAudioEndMs được xem là tiếng vọng hoặc nhiễu có khả năng xảy ra và bị bỏ qua để mô hình không bị ngắt ngay ở khung phát đầu tiên.

Nhật ký giọng nói dự kiến:

• Khi tham gia: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
• Khi bắt đầu thời gian thực: discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...
• Khi có âm thanh người nói: discord voice: realtime speaker turn opened ..., discord voice: realtime input audio started ... outputAudioMs=... outputActive=... và discord voice: realtime speaker turn closed ... chunks=... discordBytes=... realtimeBytes=... interruptedPlayback=...
• Khi bỏ qua lời nói cũ: discord voice: realtime forced agent consult skipped reason=incomplete-transcript ... hoặc reason=non-actionable-closing ...
• Khi hoàn tất phản hồi thời gian thực: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
• Khi dừng/đặt lại phát âm thanh: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• Khi tham vấn thời gian thực: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• Khi tác tử trả lời: discord voice: agent turn answer ...
• Khi xếp hàng lời nói chính xác: discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=..., tiếp theo là discord voice: realtime exact speech dequeued reason=player-idle ...
• Khi phát hiện ngắt lời: discord voice: realtime barge-in detected source=speaker-start ... hoặc discord voice: realtime barge-in detected source=active-speaker-audio ..., tiếp theo là discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...
• Khi ngắt thời gian thực: discord voice: realtime model interrupt requested client:response.cancel reason=barge-in, tiếp theo là discord voice: realtime model audio truncated client:conversation.item.truncate reason=barge-in audioEndMs=... hoặc discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...
• Khi bỏ qua tiếng vọng/nhiễu: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
• Khi tính năng ngắt lời bị tắt: discord voice: realtime capture ignored during playback (barge-in disabled) ...
• Khi phát âm thanh ở trạng thái chờ: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

Để gỡ lỗi âm thanh bị ngắt, hãy đọc nhật ký giọng nói thời gian thực theo trình tự thời gian:

1. realtime audio playback started nghĩa là Discord đã bắt đầu phát âm thanh của trợ lý. Từ thời điểm này, cầu nối bắt đầu đếm các đoạn đầu ra của trợ lý, số byte PCM của Discord, số byte thời gian thực của nhà cung cấp và thời lượng âm thanh tổng hợp.
2. realtime speaker turn opened đánh dấu một người nói trên Discord bắt đầu hoạt động. Nếu quá trình phát âm thanh đã hoạt động và bargeIn được bật, sau đó có thể xuất hiện barge-in detected source=speaker-start.
3. realtime input audio started đánh dấu khung âm thanh thực tế đầu tiên nhận được cho lượt nói đó. outputActive=true hoặc outputAudioMs khác 0 tại đây nghĩa là micrô đang gửi đầu vào trong khi âm thanh của trợ lý vẫn đang được phát.
4. barge-in detected source=active-speaker-audio nghĩa là OpenClaw phát hiện âm thanh trực tiếp của người nói trong khi âm thanh của trợ lý đang được phát. Điều này hữu ích để phân biệt một lần ngắt thực sự với sự kiện bắt đầu nói của Discord nhưng không có âm thanh hữu ích.
5. barge-in requested reason=... nghĩa là OpenClaw đã yêu cầu nhà cung cấp thời gian thực hủy hoặc cắt ngắn phản hồi đang hoạt động. Dòng này bao gồm outputAudioMs, outputActive và playbackChunks để bạn có thể biết lượng âm thanh trợ lý thực sự đã được phát trước khi bị ngắt.
6. realtime audio playback stopped reason=... là thời điểm đặt lại quá trình phát cục bộ trên Discord. Lý do cho biết tác nhân đã dừng phát: barge-in, player-idle, provider-clear-audio, forced-agent-consult, stream-close hoặc session-close.
7. realtime speaker turn closed tóm tắt lượt đầu vào đã thu. chunks=0 hoặc hasAudio=false nghĩa là lượt nói đã mở nhưng không có âm thanh sử dụng được nào đến cầu nối thời gian thực. interruptedPlayback=true nghĩa là lượt đầu vào đó trùng với đầu ra của trợ lý và kích hoạt logic ngắt lời.

Các trường hữu ích:

• outputAudioMs: thời lượng âm thanh trợ lý do nhà cung cấp thời gian thực tạo ra trước dòng nhật ký.
• audioMs: thời lượng âm thanh trợ lý mà OpenClaw đã đếm trước khi dừng phát.
• elapsedMs: thời gian thực tế trôi qua giữa lúc mở và đóng luồng phát hoặc lượt nói.
• discordBytes: số byte PCM stereo 48 kHz được gửi đến hoặc nhận từ kênh thoại Discord.
• realtimeBytes: số byte PCM theo định dạng của nhà cung cấp được gửi đến hoặc nhận từ nhà cung cấp thời gian thực.
• playbackChunks: các đoạn âm thanh trợ lý được chuyển tiếp đến Discord cho phản hồi đang hoạt động.
• sinceLastAudioMs: khoảng thời gian giữa khung âm thanh cuối cùng thu được từ người nói và lúc đóng lượt nói.

Các mẫu thường gặp:

• Việc bị ngắt ngay lập tức với source=active-speaker-audio, outputAudioMs nhỏ và cùng người dùng ở gần thường cho thấy tiếng vọng từ loa đi vào micrô. Hãy tăng voice.realtime.minBargeInAudioEndMs, giảm âm lượng loa, dùng tai nghe hoặc đặt voice.realtime.providers.openai.interruptResponseOnInputAudio: false.
• source=speaker-start theo sau bởi speaker turn closed ... hasAudio=false nghĩa là Discord đã báo bắt đầu có người nói nhưng không có âm thanh nào đến OpenClaw. Đây có thể là một sự kiện thoại Discord tạm thời, hành vi của cổng nhiễu hoặc máy khách kích hoạt micrô trong thời gian rất ngắn.
• audio playback stopped reason=stream-close mà không có lần ngắt lời hoặc provider-clear-audio gần đó nghĩa là luồng phát Discord cục bộ đã kết thúc ngoài dự kiến. Hãy kiểm tra các nhật ký trước đó của nhà cung cấp và trình phát Discord.
• capture ignored during playback (barge-in disabled) nghĩa là OpenClaw cố ý bỏ đầu vào trong khi âm thanh của trợ lý đang hoạt động. Bật voice.realtime.bargeIn nếu bạn muốn lời nói ngắt quá trình phát.
• barge-in ignored ... outputActive=false nghĩa là VAD của Discord hoặc nhà cung cấp đã báo có lời nói, nhưng OpenClaw không có quá trình phát nào đang hoạt động để ngắt. Điều này không được làm âm thanh bị ngắt.

Thông tin xác thực được phân giải theo từng thành phần: xác thực tuyến LLM cho voice.model, xác thực STT cho tools.media.audio, xác thực TTS cho messages.tts/voice.tts và xác thực nhà cung cấp thời gian thực cho voice.realtime.providers hoặc cấu hình xác thực thông thường của nhà cung cấp.

Tin nhắn thoại

Tin nhắn thoại Discord hiển thị bản xem trước dạng sóng và yêu cầu âm thanh OGG/Opus. OpenClaw tự động tạo dạng sóng, nhưng cần có ffmpeg và ffprobe trên máy chủ Gateway để kiểm tra và chuyển đổi.

• Cung cấp một đường dẫn tệp cục bộ (URL bị từ chối).
• Bỏ qua nội dung văn bản (Discord từ chối văn bản và tin nhắn thoại trong cùng một tải trọng).
• Mọi định dạng âm thanh đều được chấp nhận; OpenClaw chuyển đổi sang OGG/Opus khi cần.

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

Khắc phục sự cố

openclaw doctoropenclaw channels status --probeopenclaw logs --follow

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

{channels: {defaults: {  botLoopProtection: {    maxEventsPerWindow: 20,    windowSeconds: 60,    cooldownSeconds: 60,  },},discord: {  // Ghi đè tùy chọn trên toàn Discord. Các khối tài khoản ghi đè từng  // trường và kế thừa các trường bị lược bỏ từ đây.  botLoopProtection: {    maxEventsPerWindow: 4,  },  accounts: {    alpha: {      // Alpha chỉ lắng nghe các bot khác khi chúng đề cập đến nó.      allowBots: "mentions",    },    bravo: {      // Bravo lắng nghe tất cả tin nhắn Discord do bot gửi.      allowBots: true,      mentionAliases: {        // Cho phép Bravo viết một đề cập Discord đến Alpha bằng ID người dùng đã cấu hình.        Alpha: "ALPHA_DISCORD_USER_ID",      },      botLoopProtection: {        // Cho phép tối đa năm tin nhắn mỗi phút trước khi chặn cặp.        maxEventsPerWindow: 5,        windowSeconds: 60,        cooldownSeconds: 90,      },    },  },},},}

Tham chiếu cấu hình

Tham chiếu chính: Tham chiếu cấu hình - Discord.

An toàn và vận hành

• Xem token bot là thông tin bí mật (ưu tiên DISCORD_BOT_TOKEN trong các môi trường được giám sát).
• Chỉ cấp các quyền Discord tối thiểu cần thiết.
• Nếu trạng thái/triển khai lệnh đã lỗi thời, hãy khởi động lại Gateway và kiểm tra lại bằng openclaw channels status --probe.

Nội dung liên quan