本页内容
本页内容
主流消息传递
Discord
OpenClaw 通过官方 Discord 网关以机器人身份连接到 Discord。支持私信和服务器频道。
每页涵盖的内容
- Discord setup — 安装应用程序、邀请机器人、配对并准备公会工作区。
- Discord 访问控制 — DM 策略、行会白名单、提及门控、角色路由和操作门。
- Discord 消息行为 — 运行时模型、回复标签、链接预览、ack 反应和提及别名。
- Discord 线程和会话 — 论坛线程、历史记录限制、子代理线程和 ACP 绑定。
- Discord 组件和批准 — 组件 v2 容器、交互和执行批准。
- Discord 事件和操作 — 反应和存在唤醒、机器人存在、代理和 PluralKit。
- Discord 语音通道 — 实时语音对话、自动加入和语音消息附件。
- Discord 语音笔录和会议记录 — 连续捕获、笔录存储和自动笔记。
- 在 Discord 语音中关注用户 — 让机器人加入、移动和离开选定用户的语音频道。
- 不一致故障排除 — 消息被阻止、意图错误、网关超时、机器人循环和 STT 丢弃。
各部分移动的地方
先前单页版本的每个部分标题都保留其锚点,因此现有链接(例如 /channels/discord#voice-channels)仍然可以解析。每个条目都指向现在保存内容的页面。
- 快速设置
- 推荐:设置公会工作区
- 运行时模型
- 论坛频道
- 交互组件
- 访问控制和路由
- 公会频道地图属于白名单
- 应用访问策略更改
- 基于角色的代理路由
- 本机命令和命令授权
- 功能详情
- 工具和动作门
- 组件 v2 UI
- 语音
- 语音通道
- 捕获语音记录
- 会议记录
- 以语音方式关注用户
- 语音留言
- 故障排除
- 推荐:设置公会工作区
- 创建 Discord 应用程序和机器人
- 启用特权意图
- 复制您的机器人令牌
- 生成邀请 URL 并将机器人添加到您的服务器
- 启用开发者模式并收集您的 ID
- 允许服务器成员发DM
- 安全地设置您的机器人令牌(不要在聊天中发送)
- 配置OpenClaw并配对
- 询问您的智能体
- CLI / 配置
- 批准第一个 DM 配对
- 询问您的智能体
- CLI
- 将您的服务器添加到公会白名单
- 询问您的智能体
- Config
- 允许无 @mention 的响应
- 询问您的智能体
- Config
- 行会频道内存规划
- 询问您的智能体
- 手动
- DM 政策
- 访问组
- 行会政策
- 提及和分组 DM
- 加入服务器时介绍
- 回复标签和本机回复
- 链接预览
- 直播预览
- H历史、上下文和线程行为
- 子代理的线程绑定会话
- 持久 ACP 通道绑定
- 反应通知
- 在线出席活动
- 确认反应
- 配置写入
- 网关代理
- Plural套件支持
- 出站提及别名
- 存在配置
- Discord 的批准
- 使用了不允许的意图或机器人看不到公会消息
- 公会消息意外被阻止
- 要求提及错误但仍被阻止
- 长时间运行Discord轮或重复回复
- 网关元数据查找超时警告
- 网关READY超时重启
- 权限审核不匹配
- DM 和配对问题
- 机器人到机器人循环
- Voice STT 与 DecryptionFailed(...) 一起掉落
配置参考
主要参考:配置参考 - Discord。
高信号 Discord 字段
- startup/auth:
enabled,token,applicationId,accounts.*,allowBots - 政策:
groupPolicy、dmPolicy、allowFrom、dm.*、guilds.*、guilds.*.channels.* - 群组介绍:
joinIntro、accounts.*.joinIntro(默认:true) - 命令:
commands.native、commands.allowFrom(全局)、configWrites、slashCommand.ephemeral - 网关:
proxy - reply/history:
replyToMode,historyLimit,dmHistoryLimit,dms.*.historyLimit - delivery:
textChunkLimit(默认2000),maxLinesPerMessage(默认17) - streaming:
streaming.mode、streaming.chunkMode、streaming.preview.*、streaming.progress.*、streaming.block.*(旧版streamMode、draftChunk、blockStreaming、blockStreamingCoalesce、chunkMode密钥由openclaw doctor --fix迁移到streaming.*) - media:
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 工具发布在 Discord 内部打开的独立 HTML 小部件。该块是选择性加入的。 Discord 静态注册活动管道,但当前频道演示者保持不可用,并且 /discord/activity 仍然在外部隐藏在正常 404 后面,直到启用的帐户具有可用的机器人令牌、解析的客户端密钥和应用程序 ID。有关开发人员门户、隧道、安全性和故障排除设置,请参阅 Discord Activities。
activities.clientSecret:Discord 应用的 OAuth2 客户端密钥;若未设置,则回退为DISCORD_CLIENT_SECRETactivities.applicationId:可选的活动应用 ID;默认使用网关启动时获取到的机器人应用 ID
安全与运维
- 将机器人令牌视为机密(在受监督的环境中优先使用
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 权限。
- 如果命令 deploy/state 已过时,请重新启动网关并重新检查
openclaw channels status --probe。
Discord 模型选择器首选项和线程绑定使用 SQLite。他们的旧 discord/model-picker-preferences.json 和 discord/thread-bindings.json 文件早于 2026 年 7 月升级支持窗口。 Doctor 会保留这些文件并报告恢复指南,而不是导入它们。保留更新前备份,upgrade 到 OpenClaw 2026.9.5,并在安装最新版本之前运行 openclaw doctor --fix。 7 月 SQLite 状态和 7 月命令部署缓存仍受支持。
相关内容
本页有帮助吗?