docs/usage/messenger/discord.zh-CN.mdx
Discord 接入分两步:服务器管理员把 LobeHub 机器人加入 Discord 服务器(每个服务器一次),然后 每位成员把自己的 Discord 账号关联到 LobeHub。两步都在 设置 → Messenger → Discord 里完成。
Discord 安装审计是按服务器记录的,但你的 个人关联是全局的,挂在你的 Discord 账号下 —— 只需关联一次,所有装了机器人的服务器里它都生效。
在 LobeHub 中打开 设置 → Messenger,点击 Discord 卡片,再点右上角的 连接。
页面跳转到 Discord 添加机器人页面。选择目标服务器,点击 Authorise(授权)。
授权成功后跳回 LobeHub。该服务器会以 server 行的形式出现在 Connections 中。
服务器已被他人连接? LobeHub 会提示「Server already connected」。你不需要再次添加机器人,只要在 Discord 里私聊 LobeHub 机器人完成个人账号关联即可。
</Steps>
在 Discord 中打开 LobeHub 机器人 —— Discord 详情页(或 pending 状态的 user 行)上的 在 Discord 中打开 按钮可以直接跳过去。
在机器人 DM 里发送任意一条消息触发关联流程。机器人会回复一个一次性确认链接。
点击链接,必要时登录 LobeHub,然后选择一个 默认 Agent。之后你在 Discord 任意服务器里私聊 LobeHub 机器人的每条消息都会路由到这个 Agent。
关联完成后会在 Connections 里以 user 行的形式出现。 </Steps>
两种等价方式:
/agents,挑一个新的 Agent。切换会对你发送的下一条消息立即生效。
Discord 也有两种含义不同的断开操作,有一处和 Slack 不同需要特别注意:
| 操作 | 效果 |
|---|---|
| 在 user 行点 断开 | 解除 你自己 的 LobeHub 账号与 Discord 账号的关联。机器人不再接收你的 DM,直到你再次发消息并完成关联。 |
| 在 server 行点 断开 | 只移除安装审计记录。机器人会继续留在 Discord 服务器里,直到 Discord 服务器管理员手动把它踢出。其他人的个人关联不受影响。 |
任何时候都可以重新走对应阶段把机器人加回服务器、或重新建立个人关联。
<原因>) —— 常见原因:用户取消授权、安装会话过期(重新打开弹窗再试)、Discord 返回的数据不完整(重试;持续失败请联系支持)。