Cloudo AgentsCloudo Agents

把你的智能体接入 Discord

大约 10 分钟。完成后，你的 Discord 服务器里会有一个机器人，与你的智能体对话。 比 Telegram 步骤多一些，因为 Discord 把机器人创建拆成了开发者门户和邀请流程两部分—— 不过仍然只是一次性的设置。

开始之前

  • 已经部署好、并在门户中显示为 active（在线）的智能体
  • 一个 Discord 账号
  • 一个你拥有 Manage Server 或 Administrator 权限的 Discord 服务器（你不能把机器人加到你没有管理权限的服务器）
  • 大约 10 分钟
核心概念

和 Telegram 不同，Discord 没有“与机器人聊天来创建机器人”的流程。 你需要在浏览器里打开 Discord 的开发者门户，注册一个 application（应用），把一个 bot（机器人）挂到这个应用上，生成一个 邀请 URL，点击该 URL 把机器人加入你的服务器，最后把机器人的 token 粘贴到 OpenClaw。 听起来步骤不少——其实总共只有 10 来次点击。

步骤 1 — 创建 Discord 应用

  1. 打开 discord.com/developers/applications。如果没登录，先登录。
  2. 点击右上角的 New Application。
  3. 起个名字。它会显示在开发者门户里以及 Discord 内部——直接用你智能体的名字就行。 例如：Acme Support。
  4. 接受开发者条款，点击 Create。

步骤 2 — 配置机器人

  1. 现在你应该在应用的设置页面。在左侧栏点击 Bot。
  2. 在 Privileged Gateway Intents 下，启用：
    • Server Members Intent — 如果你的智能体会按用户做个性化，则必需
    • Message Content Intent — 让机器人能读取消息内容（大多数智能体都需要）
    出于隐私考虑，Discord 默认把它们设为 关闭；如果不开启，机器人只能看到对它的提及， 看不到完整的消息内容。
  3. 点击 Save Changes。

步骤 3 — 复制机器人的 token

  1. 仍然在 Bot 页面，点击 Reset Token（如果有的话也可以点View Token）。Discord 会生成 token 并只显示一次。
  2. 复制这个 token。它长这样：
    MTAxNjMwODc4ODI3MTQ1NDgwMA.GxYz_a.AbCdEfGhIjKlMnOpQrStUvWxYz1234567890ABCD
请像对待密码一样对待这个 token

拥有这个 bot token 的人都能在它所在的任何服务器里以你的机器人身份收发消息。 不要把它粘贴到公开频道、截图、gist 或 git 提交里。一旦泄漏，到 Bot 页面点 Reset Token 把它作废；之后你需要在 OpenClaw 里更新成新的 token。

步骤 4 — 生成邀请 URL

  1. 在左侧栏点击 OAuth2，然后选 URL Generator。
  2. 在 Scopes 下，勾选：
    • bot
    • applications.commands（让你以后能注册斜杠命令）
  3. 会出现第二个框（Bot Permissions）。至少勾选：
    • Read Messages/View Channels
    • Send Messages
    • Embed Links
    • Read Message History
    • Use Slash Commands
    不要勾选 Administrator。机器人几乎从不需要它，而授予后一旦 token 泄漏， 影响范围会大得多。
  4. Discord 会在页面底部生成一个邀请 URL。复制它。

步骤 5 — 把机器人邀请进你的服务器

  1. 把邀请 URL 粘贴到浏览器地址栏，回车。
  2. Discord 会询问把机器人加到哪个服务器。选择目标服务器（你必须拥有 Manage Server 或 Administrator 权限）。
  3. 核对申请的权限与步骤 4 里勾选的一致。点击 Authorize。
  4. Discord 会显示一个验证码，然后是成功页面。机器人现已加入你的服务器， 在成员侧边栏可以看到，但是离线的（它还没有软件在运行——这就是下一步要做的）。

步骤 6 — 把 token 粘贴到 OpenClaw

  1. 在 Cloudo 门户里，对你要连接的智能体点击 Open my OpenClaw。
  2. 打开 Channels 标签页。
  3. 点击 Discord，然后点击 Connect。
  4. 把步骤 3 得到的 bot token 粘贴到 Bot Token 字段。
  5. 点击 Save。OpenClaw 会连接到 Discord 的网关，并显示类似这样的信息：
    Connected as Acme Support#1234 (in 1 server: My Server)

几秒内，机器人在 Discord 成员侧边栏里的状态会从离线变成在线。

步骤 7 — 发送第一条消息

在你的 Discord 服务器中，任意一个机器人有权访问的频道里，提及该机器人：

@Acme Support hi, what can you do?

你的智能体应该在几秒内以它配置好的语气回复。如果你没有 @-提及它，它就不会响应—— 除非你修改设置，Discord 默认让机器人只对提及做响应（参见下文）。

可选润色

斜杠命令

OpenClaw 可以注册斜杠命令，例如 /help、/reset、 /contact-human。在 OpenClaw 的 Discord 频道配置里定义它们； Discord 会在约 30 分钟内将它们全局注册（或在单个服务器内立即注册）。

限定频道范围

默认情况下，机器人会在它能看到的所有频道里监听。要限定到特定频道， 可在 Discord 中调整每个频道的角色权限，或配置 OpenClaw 只在你设定的白名单中响应。

机器人头像和描述

回到开发者门户中该应用的根设置页面：上传头像（方形图片）， 设置一段简短描述（查看机器人个人资料的用户能看到）。

故障排查

机器人在线，但被提及时没反应

最可能的原因是：Message Content Intent 没开。

  1. 回到开发者门户 → 你的应用 → Bot 标签。
  2. 滚动到 Privileged Gateway Intents。
  3. 启用 Message Content Intent（如果智能体会按用户做个性化， 也启用 Server Members Intent）。
  4. 保存。
  5. 在 OpenClaw 里重启连接（断开后用同一个 token 重新连接）。

如果 intents 已开机器人还是不响应，检查机器人在该频道的权限——有时频道级别的角色覆盖会移除View Channel 或 Send Messages。

“401 Unauthorized” 或 “invalid token”

token 错误，或已经被重置。到开发者门户 → Bot → Reset Token，复制新的 token，粘贴到 OpenClaw，保存。

保存 token 后机器人仍然离线

按顺序检查：

  1. OpenClaw 显示连接状态为 connected（而不是 error）—— 如果显示 error，说明 token 错了。
  2. 你的额度余额大于零——连接会保持在线，但额度耗尽后智能体不会回复。
  3. 机器人确实被邀请进了服务器（步骤 5）。Bot 标签页和 OAuth2 邀请是两个独立步骤； 很容易跳过邀请步骤然后纳闷为什么机器人不在服务器里。

我想把机器人从服务器移除

在 Discord 成员侧边栏右键点击机器人 → Kick。机器人会离开， 但应用和 token 仍然有效；你可以重新邀请它（步骤 5），不需要重新注册。

我想完全删除这个机器人

开发者门户 → 你的应用 → General Information → 底部的 Delete App。这会永久作废该 token。

完成。你的智能体现在能在 Discord 上以你配置好的语气回应，拥有和其它每一个渠道完全一样的灵魂与技能。 一个智能体，所有渠道。

下一步：连接 Slack， 如果还没设置 Telegram，请回到 Telegram。或者回到 文档首页。

接入 Discord — Cloudo 文档