本页内容

本页内容

主流消息传递

Discord

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

每页涵盖的内容

各部分移动的地方

先前单页版本的每个部分标题都保留其锚点,因此现有链接(例如 /channels/discord#voice-channels)仍然可以解析。每个条目都指向现在保存内容的页面。

配置参考

主要参考:配置参考 - 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_SECRET
  • activities.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 月命令部署缓存仍受支持。

相关内容

本页有帮助吗?