Discord

OpenClaw 通过官方 Discord 网关以机器人身份连接到 Discord。支持私信和服务器频道。

配对

Discord 私信默认使用配对模式。

斜杠命令

原生命令行为和命令目录。

频道故障排查

跨频道诊断和修复流程。

每个页面涵盖的内容¶

Discord 设置 — 安装应用、邀请机器人、完成配对，并准备服务器工作区。
Discord 访问控制 — 私信策略、服务器允许列表、提及门控、角色路由和操作门控。
Discord 消息行为 — 运行时模型、回复标签、链接预览、确认表情回应和提及别名。
Discord 线程与会话 — 论坛线程、历史记录限制、子代理线程和 ACP 绑定。
Discord 组件与审批 — components v2 容器、交互和执行审批。
Discord 事件与操作 — 表情回应和在线状态唤醒、机器人在线状态、代理以及 PluralKit。
Discord 语音频道 — 实时语音对话、自动加入和语音消息附件。
Discord 语音转录与会议记录 — 持续捕获、转录存储和自动记录。
在 Discord 语音中跟随用户 — 让机器人跟随选定用户加入、移动和离开语音频道。
Discord 故障排查 — 被阻止的消息、意图错误、网关超时、机器人循环和 STT 中断。

每个章节迁移到了哪里¶

之前单页版本中的每个章节标题都会在此保留其锚点，因此现有链接（例如 /channels/discord#voice-channels）仍然可以解析。每个条目都指向当前承载该内容的页面。

配置参考¶

主要参考：配置参考 - Discord。

高信号 Discord 字段

启动/认证：enabled、token、applicationId、accounts.*、allowBots
策略：groupPolicy、dmPolicy、allowFrom、dm.*、guilds.*、guilds.*.channels.*
群组介绍：joinIntro、accounts.*.joinIntro（默认：true）
命令：commands.native、commands.allowFrom（全局）、configWrites、slashCommand.ephemeral
网关：proxy
回复/历史：replyToMode、historyLimit、dmHistoryLimit、dms.*.historyLimit
投递：textChunkLimit（默认 2000）、maxLinesPerMessage（默认 17）
流式：streaming.mode、streaming.chunkMode、streaming.preview.*、streaming.progress.*、streaming.block.*（旧版扁平 streamMode、draftChunk、blockStreaming、blockStreamingCoalesce、chunkMode 键由 openclaw doctor --fix 迁移到 streaming.*）
媒体：mediaMaxMb（限制出站 Discord 上传，默认 100）
操作：actions.*
在线状态：activity、status、activityType、activityUrl、autoPresence.*
功能：threadBindings、顶层 bindings[]（type: "acp"）、pluralkit、execApprovals、intents、agentComponents.enabled、agentComponents.ttlMs、activities、heartbeatVisibility、responsePrefix

Discord 活动¶

设置 channels.discord.activities，让核心 show_widget 工具发布自包含的 HTML 小组件，并在 Discord 内打开。该块为可选启用。Discord 会静态注册 Activity 管道，但在已启用账户拥有可用的 bot token、已解析的 client secret 和 application ID 之前，当前频道展示器保持不可用，并且 /discord/activity 在外部仍隐藏在常规 404 之后。有关 Developer Portal、隧道、安全和问题排查设置，请参阅 Discord 活动。

activities.clientSecret：Discord 应用的 OAuth2 client secret；回退到 DISCORD_CLIENT_SECRET
activities.applicationId：可选的 Activity application ID；默认为网关启动时学习到的 bot application ID

安全与运维¶

将 bot token 视为机密（在受监督环境中优先使用 DISCORD_BOT_TOKEN）。
DISCORD_API_URL 会覆盖进程级、带版本的 Discord REST 基础地址（例如， https://discord.example.com/api/v10）。OpenClaw 还会使用该源进行网关发现、 WebSocket 连接、媒体、webhooks、OAuth 和命令注册；在设置覆盖期间，请求不会回退到公共 Discord。仅在回环地址上接受纯 HTTP/WS，并且设置覆盖时 Discord 语音传输不可用。请在网关进程环境或全局运行时 dotenv 中设置，而不是工作区 .env。
授予最小权限的 Discord 权限。
如果命令部署/状态已过期，请重启网关并使用 openclaw channels status --probe 重新检查。

Discord 活动

在 Discord 内启动交互式 HTML 小组件。

配对

将 Discord 用户配对到网关。

表情回应

message 工具的表情回应语义。

群组

群聊和允许列表行为。

频道路由

将入站消息路由到代理。

安全

威胁模型和加固。