连接 Discord 机器人
创建 Discord 应用、授予测试频道权限并连接 Onevium，检查消息与会话范围。
渠道连接 Discord 机器人#
创建 Discord 机器人并接入 Onevium 项目，再用两轮频道消息验证连接。
创建应用和 Token#
- 打开 Discord Developer Portal，点击 New Application。
- 打开 Bot，按需创建/重置 Bot Token，稍后填入 Onevium 的 Bot Token 字段。
- 准备你有管理权的测试服务器和文字频道，不使用个人账号 Token。
重置会使旧 Token 失效；之后需要更新 Onevium 凭据并重新连接。
配置 intents 与安装权限#
在 Bot → Privileged Gateway Intents 开启 Message Content Intent。Onevium 请求 Guilds、GuildMessages、DirectMessages 和 MessageContent；基础流程不需要 Server Members 或 Presence。已认证应用如需平台审批，应先完成审批。请求了未获准的特权 intent，Gateway 可能以 4014 断开，见官方 Gateway 文档。
在 OAuth2 → URL Generator 选择 bot scope 和下列权限，打开生成链接，把机器人加入测试服务器：
| 权限 | 用途 |
|---|---|
| View Channels | 查看目标文字频道 |
| Send Messages | 发送回复 |
| Read Message History | 读取相关频道消息 |
| Embed Links | 展示富文本回复 |
| Attach Files | 发送文件产物 |
还要检查频道自己的覆盖权限，不能只看机器人角色。本例不需要 Administrator。权限机制见官方权限参考。
创建 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 |