> 内容来源：Onevium 官方文档
> 文章: 连接 Discord 机器人（预览创建流程）
> 原文: https://onevium.com/zh/docs/channels/discord
> 语言：简体中文
> 更新于: 2026-09-09
> 适用版本: 1.1.23-beta.7
> 功能状态: 开发预览

---

# 连接 Discord 机器人（预览创建流程）

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

## 连接 Discord 机器人

本页区分平台设置与 Onevium 创建界面。**下方 Token 验证创建流程适用于 1.1.23-beta.7 开发预览。** 1.1.22 已有 Discord 适配器，但新建渠道的注册接口会对 Discord 返回 `Invalid channel type`，这不代表 Token 错误。

已有 1.1.22 连接可按下方检查平台设置。需要新建时，应有意识地使用预览环境，或等待包含创建修复的正式版本。

## 创建应用和 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 预览版连接

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

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

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

## 验证消息与范围

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

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

## 常见问题

| 现象                                | 检查方法                                |
| --------------------------------- | ----------------------------------- |
| 1.1.22 注册时 `Invalid channel type` | 属于已知创建界面限制；预览版才新增 Discord 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)。