Discord 机器人设置
将您的 Claw Buff 智能体连接到 Discord 的分步指南
将您的 Claw Buff AI 智能体连接到 Discord 服务器。机器人可以响应私聊和频道消息。设置大约需要 10 分钟。
前置条件
- 一个 Discord 账号
- 一个拥有管理服务器权限的 Discord 服务器
- 已部署的 Claw Buff 智能体（快速开始）
第一步：创建 Discord 应用
打开开发者门户
前往 Discord Developer Portal，点击 New Application。为应用命名（如 "我的 AI 智能体"）。
创建 Bot
在侧栏点击 Bot，自定义机器人的用户名和头像。
启用 Message Content Intent
向下滚动到 Privileged Gateway Intents，启用：
- Message Content Intent — 读取消息必需
- Server Members Intent — 推荐启用，用于基于角色的访问控制
点击 Save Changes。
复制 Bot Token
点击 Reset Token（或 Copy）获取机器人 Token。保存好——下一步需要用到。
Bot Token 是密钥，请勿公开分享。如果泄露，请立即在开发者门户重置。
第二步：邀请机器人到服务器
生成邀请链接
在开发者门户侧栏点击 OAuth2 → URL Generator。
勾选以下范围：
botapplications.commands
然后选择机器人权限：
View ChannelsSend MessagesRead Message HistoryEmbed LinksAttach Files
邀请机器人
复制生成的 URL 并在浏览器中打开。选择要添加机器人的服务器，然后点击 Authorize。
第三步：连接到 Claw Buff
- 打开 Claw Buff 控制台 → 渠道页面
- 找到 Discord 卡片，点击连接
- 粘贴第一步获取的 Bot Token
- 点击保存并激活
机器人将在几秒内上线。
第四步：配对账号
机器人响应之前，需要先配对你的 Discord 账号：
- 私聊机器人 — 在服务器成员列表中点击机器人名称，发送任意消息（如 "你好"）
- 机器人会回复一个配对码（如
X7QTGBD4） - 打开 Claw Buff 控制台 → 渠道页面
- 你会看到待处理的配对请求 — 点击配对码旁的批准按钮
批准后，机器人就会回复你的私聊消息。
第五步：开启服务器频道（可选）
默认情况下，机器人仅在私聊中工作。要在服务器频道中使用：
- 在 Discord 中，右键点击左侧边栏的服务器图标 → 复制服务器 ID
如果没有看到"复制服务器 ID"选项，需要先开启开发者模式：用户设置 → 高级 → 开启"开发者模式"。
- 在控制台中，前往渠道 → 点击 Discord 卡片上的管理
- 在授权的服务器下，粘贴服务器 ID 并点击添加
机器人将会在该服务器的频道中响应 @提及 消息。你可以添加多个服务器。
@提及机器人时，请确保选择的是"成员"分组中带 APP 标签的机器人用户，而不是同名的角色。Discord 会自动为机器人创建一个同名角色——提及角色不会触发机器人响应。
功能特性
| 功能 | 支持情况 |
|---|---|
| 私聊 | 支持 |
| 频道消息 | 支持（需要 @提及） |
| 流式响应 | 支持（实时编辑消息） |
| 斜杠命令 | 支持 |
| 富文本嵌入 | 支持 |
| 文件附件 | 支持 |
| 语音频道 | 支持 |
常见问题
1. 机器人在 Discord 中显示离线？
- 检查 Token — 确保粘贴了完整的 Token
- 检查 Intents — 必须在开发者门户启用 Message Content Intent
- 检查控制台 — 渠道页面会显示连接状态和错误日志
2. 机器人不响应消息？
- 确保已启用 Message Content Intent（第一步）
- 在频道中，机器人需要 @提及 才会响应
- 确保提及的是机器人用户，而不是角色 — 输入
@时，从"成员"列表中选择带 APP 标签的机器人，而不是"身份组"中同名的角色。提及角色不会触发机器人响应。 - 检查机器人在该频道是否有 View Channels 和 Read Message History 权限
3. "Missing Permissions" 错误？
机器人需要正确的频道权限。至少需要：View Channels、Send Messages、Read Message History 和 Embed Links。