> 内容来源：Onevium 官方文档
> 文章: 连接 Discord 机器人
> 原文: https://onevium.com/zh/docs/channels/discord
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.23+

---

# 连接 Discord 机器人

创建 Discord 应用、授予测试频道权限并连接 Onevium，检查消息与会话范围。

## 连接 Discord 机器人

创建 Discord 机器人并接入 Onevium 项目，再用两轮频道消息验证连接。

## 创建应用和 Token

1. 打开 [Discord Developer Portal](https://discord.com/developers/applications)，点击 **New Application**。
2. 打开 **Bot**，按需创建/重置 Bot Token，稍后填入 Onevium 的 **Bot Token** 字段。
3. 准备你有管理权的测试服务器和文字频道，不使用个人账号 Token。

重置会使旧 Token 失效；之后需要更新 Onevium 凭据并重新连接。

## 配置 intents 与安装权限

在 **Bot → Privileged Gateway Intents** 开启 **Message Content Intent**。Onevium 请求 Guilds、GuildMessages、DirectMessages 和 MessageContent；基础流程不需要 Server Members 或 Presence。已认证应用如需平台审批，应先完成审批。请求了未获准的特权 intent，Gateway 可能以 `4014` 断开，见[官方 Gateway 文档](https://docs.discord.com/developers/events/gateway)。

在 **OAuth2 → URL Generator** 选择 `bot` scope 和下列权限，打开生成链接，把机器人加入测试服务器：

| 权限                   | 用途       |
| -------------------- | -------- |
| View Channels        | 查看目标文字频道 |
| Send Messages        | 发送回复     |
| Read Message History | 读取相关频道消息 |
| Embed Links          | 展示富文本回复  |
| Attach Files         | 发送文件产物   |

还要检查频道自己的覆盖权限，不能只看机器人角色。本例不需要 Administrator。权限机制见[官方权限参考](https://docs.discord.com/developers/topics/permissions)。

## 创建 Onevium 连接

在 Onevium 打开**渠道 → 新建渠道 → 单个机器人 → Discord**，粘贴 **Bot Token** 并完成验证。此步骤检查机器人身份，不消费 Gateway 消息。

| 字段     | 首次选择                       |
| ------ | -------------------------- |
| 机器人名称  | `文档助手`                     |
| 工作目录   | 演示项目                       |
| 模型     | Onevium 中已可正常对话的提供商/模型     |
| 会话模式   | 每人独立会话                     |
| 聊天范围   | 仅群聊                        |
| 自动批准操作 | 每项操作前询问                    |
| 系统提示词  | `回答演示项目的问题；在当前会话记住连接测试代号。` |

保存并启动连接。Onevium 的“角色描述”是助手信息，不是 Discord 服务器角色，也不会授予频道权限。

## 验证消息与范围

在测试频道 @机器人发送“测试代号 gamma-27”，第二轮再 @它询问代号。核对答案及 Onevium 中的对应会话。

私聊需要在**聊天范围**中开放，并明确选择**私聊策略**。白名单填写平台用户 ID，每行一个。当前 Onevium 版本支持的命令作为普通文字消息发送；此集成不会注册 Discord 原生斜杠菜单。文字跑通后再单独测试附件。

## 常见问题

| 现象                           | 检查方法                                |
| ---------------------------- | ----------------------------------- |
| 创建时提示 `Invalid channel type` | 先核对顶部适用版本，不要因此反复更换 Token            |
| Gateway `4014`               | 开启/审批 Message Content Intent 后重启连接  |
| 在线却不回复                       | 检查 @方式、查看/发送权限、频道覆盖权限和 Onevium 聊天范围 |
| 重置后 Token 失败                 | 替换已保存 Token，重新连接                    |
| 私聊被拒绝                        | 检查私聊策略及发送者的平台用户 ID                  |

## 下一步

会话行为见[渠道概览](https://onevium.com/zh/docs/team-channels)，助手操作见[权限](https://onevium.com/zh/docs/permissions)。其他平台的配置可参考[飞书](https://onevium.com/zh/docs/channels/feishu)。