设置
运行 Discord 机器人所需的一切:创建应用、授予 Intents、邀请它加入服务器、完成配对,并准备一个服务器(Guild)工作区。
快速设置¶
创建一个带机器人的 Discord 应用,将机器人添加到你的服务器,并让它与 OpenClaw 配对。如果可以,请使用私人服务器;如有需要,先创建一个(Create My Own > For me and my friends)。
1. 创建 Discord 应用和机器人
在 Discord Developer Portal 中,点击 New Application 并为其命名(例如“OpenClaw”)。
在侧边栏打开 Bot,将 Username 设置为你的智能体的名称。
2. 启用特权 Intents
仍在 Bot 页面,在 Privileged Gateway Intents 下启用:
- Message Content Intent(处理普通服务器消息所必需)
- Server Members Intent(推荐;角色白名单、名称转 ID 的匹配以及频道受众访问组都需要)
- Presence Intent(可选;仅用于在线状态更新)
3. 复制你的 Bot Token
在 **Bot** 页面,点击 **Reset Token** 并复制 Token。
Note
虽然按钮叫“Reset Token”,但这里实际生成的是你的第一个 Token——并不是在“重置”什么。
4. 生成邀请链接并将机器人添加到服务器
在侧边栏打开 OAuth2。在 OAuth2 URL Generator 中,启用以下 Scopes:
botapplications.commands
在出现的 Bot Permissions 部分中,至少启用:
General Permissions - View Channels
Text Permissions - Send Messages - Read Message History - Embed Links - Attach Files - Add Reactions(可选)
以上是普通文本频道所需的最低权限。如果机器人要在帖子中发消息——包括创建或延续帖子的论坛频道或媒体频道工作流——还要启用 Send Messages in Threads。
复制生成的 URL,在浏览器中打开,选择你的服务器,然后点击 Continue。机器人现在应该会出现在你的服务器中。
5. 启用开发者模式并获取你的 ID
在 Discord 应用中,启用开发者模式(Developer Mode),以便复制 ID:
- User Settings(齿轮图标)→ Developer → 打开 Developer Mode 开关 (移动端:App Settings → Advanced)
- 右键点击你的服务器图标 → Copy Server ID
- 右键点击你自己的头像 → Copy User ID
请将 Server ID 和 User ID 与你的 Bot Token 放在一起;下一步你需要用到这三项。
6. 允许服务器成员向你发送私信
配对要成功,Discord 必须允许机器人向你发送私信。右键点击你的服务器图标 → Privacy Settings → 打开 Direct Messages 开关。
如果你通过 OpenClaw 使用 Discord 私信,请保持此选项开启。如果只用服务器频道,配对完成后即可将其关闭。
7. 安全地设置你的 Bot Token(不要通过聊天发送)
Bot Token 是机密信息。在向你的智能体发送消息之前,先在运行 OpenClaw 的机器上设置好它:
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" },
},
},
}
JSON5
openclaw config patch --file ./discord.patch.json5 --dry-run
openclaw config patch --file ./discord.patch.json5
openclaw gateway
如果 OpenClaw 已作为后台服务运行,请通过 OpenClaw Mac 应用重启它,或停止并重启 `openclaw gateway run` 进程。
对于托管服务安装,请在已设置 `DISCORD_BOT_TOKEN` 的 shell 中运行 `openclaw gateway install`;也可以将变量写入 `~/.openclaw/.env`,以便服务在重启后能解析该 env SecretRef。
如果你的主机被 Discord 的启动应用查询阻止或限流,请从 Developer Portal 设置 application/client ID,以便启动时跳过该 REST 调用:默认账户使用 `channels.discord.applicationId`,或按机器人分别设置 `channels.discord.accounts.<accountId>.applicationId`。
8. 配置 OpenClaw 并配对
在现有频道(例如 Telegram)上与你的 OpenClaw 智能体对话并告诉它。如果 Discord 是你的第一个频道,请改用 CLI / 配置选项卡。
“我已经在配置中设置了我的 Discord Bot Token。请使用 User ID
<user_id>和 Server ID<server_id>完成 Discord 设置。”
基于文件的配置:
{
channels: {
discord: {
enabled: true,
token: {
source: "env",
provider: "default",
id: "DISCORD_BOT_TOKEN",
},
},
},
}
默认账户的 Env(环境变量)回退:
对于脚本化或远程设置,请用 `openclaw config patch --file ./discord.patch.json5 --dry-run` 写入相同的 JSON5 块,然后去掉 `--dry-run` 重新运行。纯文本的 `token` 字符串同样有效;`channels.discord.token` 在 env/file/exec/store 这些 provider 下均支持 SecretRef 值。参见 [机密管理](../../gateway/secrets.md)。
对于多个 Discord 机器人,请将每个 Bot Token 和 application ID 放在各自的账户下。顶层的 `channels.discord.applicationId` 会被各账户继承,因此只有在所有账户都使用同一个 application ID 时,才应在此处设置。
{
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",
},
},
},
},
}
9. 批准首次私信配对
Gateway 启动后,在 Discord 中给你的机器人发私信,它会回复一个配对码。
在你现有的频道上,将配对码发送给你的智能体:
"批准此 Discord 配对代码:
<CODE>"
如果 Discord 无法授予 Message Content Intent,OpenClaw 仍可在私聊以及用户明确提及机器人的服务器频道中运行。设置
channels.discord.intents.messageContent: false,以便 Gateway 不请求不可用的特权意图,并在每个已配置的服务器频道上保持
requireMention: true。在此模式下,Discord 会省略其他服务器消息中用户创建的内容。
Note
Token 解析是账户感知的。配置中的 token 值优先于环境变量回退值,且 DISCORD_BOT_TOKEN 仅用于默认账户。
如果两个已启用的 Discord 账户解析到同一个 bot token,OpenClaw 只会为该 token 启动一个 Gateway 监视器:来自配置的 token 优先于环境变量回退值;否则第一个已启用账户生效,重复账户会被报告为已禁用,原因为 duplicate bot token。
对于高级出站调用(message tool/频道操作),该调用会显式使用 per-call token。这适用于 send 以及 read/check 类操作(read/search/fetch/thread/pins/permissions)。账户策略/重试设置仍然来自当前运行时快照中选定的账户。
推荐:设置服务器工作区¶
一旦私聊可用,你就可以将你的服务器变成一个完整的工作区,其中每个频道都拥有自己的智能体会话和独立上下文。推荐用于只有你和机器人的私人服务器。
1. 将你的服务器添加到服务器允许列表
这可以让你的智能体在服务器上的任意频道中回复,而不仅仅是私聊。
2. 允许无需 @提及 即可回复
默认情况下,智能体仅在服务器频道中被 @提及 时才会回复。在私人服务器上,你可能希望它对每条消息都进行回复。
在服务器频道中,普通回复默认自动发布。对于共享的常驻房间,启用 `messages.groupChat.visibleReplies: "message_tool"`,以便智能体可以静默观察,并只在它认为频道回复有用时才发布。这与最新一代、工具调用可靠的模型(如 GPT-6 Astra)搭配效果最佳。除非工具发送,否则环境房间事件保持静默。有关完整的潜伏模式配置,请参阅 [环境房间事件](../ambient-room-events.md)。
如果 Discord 显示正在输入,且日志显示 token 使用量但没有已发布的消息,请检查该回合是否被配置为环境房间事件,或是否启用了 message-tool 可见回复。
会话繁忙通知也遵循此回复策略。对于环境事件和 message-tool 回复,Discord 会在 Gateway 日志中记录失败和被抑制的通知,而不会发布到房间。
3. 规划服务器频道中的记忆
长期记忆(MEMORY.md)仅在私聊会话中自动加载;服务器频道不会加载它。
"当我在 Discord 频道中提问时,如果你需要来自 MEMORY.md 的长期上下文,请使用 memory_search 或 memory_get。"
对于每个频道共享的上下文,请将稳定指令放在 AGENTS.md 或 USER.md 中(每个会话都会注入)。将长期笔记保存在 MEMORY.md 中,并使用记忆工具按需访问。
现在创建频道并开始聊天。智能体可以看到频道名称,并且每个频道都是一个隔离的会话——设置 #coding、#home、#research 或适合你工作流的任何频道。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw