跳转至

Discord

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

配对

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

斜杠命令

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

频道故障排除

跨频道诊断和修复流程。

每个页面涵盖的内容

每个章节迁移到的位置

来自之前单页版本的每个章节标题都会在此保留其锚点,因此现有链接(例如 /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 工具发布可在 Discord 内打开的自包含 HTML 组件。该配置块为可选启用。Discord 会静态注册 Activity 管道,但在已启用账户拥有可用的 bot token、已解析的 client secret 和 application ID 之前,当前频道展示器仍不可用,并且 /discord/activity 仍通过常规 404 对外隐藏。有关开发者门户、隧道、安全和故障排除设置,请参阅 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 还会使用该源进行 Gateway 发现、 WebSocket 连接、媒体、webhooks、OAuth 和命令注册;在设置覆盖期间,请求不会回退 到公共 Discord。仅在 loopback 上接受纯 HTTP/WS,并且设置覆盖后 Discord 语音传输 不可用。请将其设置在 Gateway 进程环境或全局运行时 dotenv 中,而不是工作区 .env。
  • 授予最小权限的 Discord 权限。
  • 如果命令部署/状态已过期,请重启网关并使用 openclaw channels status --probe 重新检查。

Discord 模型选择器偏好和线程绑定使用 SQLite。它们旧的 discord/model-picker-preferences.json 和 discord/thread-bindings.json 文件 早于 2026 年 7 月的升级支持窗口。Doctor 会保留这些文件, 并报告恢复指导,而不是导入它们。请保留更新前备份, 通过 OpenClaw 2026.9.5 升级, 并在安装最新版本前运行 openclaw doctor --fix。 7 月的 SQLite 状态和 7 月的命令部署缓存仍受支持。

Discord 活动

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

配对

将 Discord 用户配对到网关。

表情回应

message 工具的表情回应语义。

群组

群组聊天和允许列表行为。

频道路由

将入站消息路由到代理。

安全

威胁模型和加固。

多代理路由

将服务器和频道映射到代理。

斜杠命令

原生命令行为。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw