第 15 章：Discord 通道 🎮

适合人群：想在 Discord 服务器里用 AI 助手的你 本章目标：创建 Discord Bot 应用，配置 Intents，绑定到 OpenClaw Agent

---

15.1 创建 Discord Bot

Discord Bot 是所有游戏社区、开发者群组、兴趣小组的标配。把 OpenClaw 接上 Discord，你的服务器成员就能用 @ 命令召唤 AI 了。

第一步：进入 Discord 开发者门户

打开浏览器，访问：

https://discord.com/developers/applications

用你的 Discord 账号登录。

第二步：创建新应用

点右上角的 「New Application」，输入一个名字，比如「我的 AI 助手」。

[截图：Discord 开发者门户的 New Application 按钮]

第三步：创建 Bot

在左侧菜单点 「Bot」，然后点 「Add Bot」，确认。

[截图：Bot 页面中的 Add Bot 按钮]

现在页面会显示你的 Bot 信息，包括一个头像和名字。

第四步：拿到 Bot Token（最重要！）

在 Bot 页面，点 「Reset Token」（重置令牌），然后 复制 这串长长的字符串。

MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.GxYzAb.ABCDefGHIjklmnOPQrstUVwxyz1234567890

⚠️ 绝对不要把 Token 分享给任何人！ 拿到 Token 的人可以在你的 Discord 服务器上以 Bot 身份为所欲为。如果不小心泄露了，马上点 「Reset Token」 生成新的。

[截图：Bot Token 位置，Token 打码]

---

15.2 配置 Intents（意图）

Discord 要求 Bot 必须声明它"想要"哪些权限。Intents（意图）就是权限声明——告诉 Discord："我这个 Bot 需要读消息内容、需要知道谁上线了"等等。

关键 Intents

你至少需要开启以下两个意图：

Intent	作用	是否必须
Message Content Intent	让 Bot 能读取消息的文字内容	✅ 必须开启
Server Members Intent	让 Bot 能读取服务器成员列表	✅ 推荐开启
Presence Intent	让 Bot 能追踪用户在线状态	❌ 可选

[截图：Discord Bot 设置页面的 Privileged Gateway Intents 区域]

开启方法：

1. 在 Bot 页面往下翻，找到 「Privileged Gateway Intents」
2. 把 「Message Content Intent」 开成绿色
3. 把 「Server Members Intent」 也开成绿色
4. 点 「Save Changes」

配置 OAuth2 邀请链接

点击左侧 「OAuth2」→「URL Generator」：

1. Scopes（范围）：勾选 bot 和 applications.commands
2. Bot Permissions（权限）：
   • View Channels（查看频道）
   • Send Messages（发送消息）
   • Read Message History（读取消息历史）
   • Mention Everyone（可选，如果你想让 Bot 能被 @）

下面会自动生成一个邀请链接。复制它：

https://discord.com/api/oauth2/authorize?client_id=123456789012345678&permissions=...

邀请 Bot 进服务器

把这个链接在浏览器中打开，选择你要添加的 Discord 服务器（需要你有服务器的「管理服务器」权限），然后点 「授权」。

[截图：邀请 Bot 到服务器的授权页面]

好了，Bot 现在已经在你服务器上了（但还不能说话，因为我们还没把它连上 OpenClaw）。

---

15.3 绑定 Agent

配置 OpenClaw

有了 Bot Token 和 Bot ID，就可以配置 OpenClaw 了。

命令行方式：

# 设置 Discord Bot Token
openclaw config set channels.discord.botToken "MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.GxYzAb.ABCDefGHIjklmnOPQrstUVwxyz1234567890"

# 绑定到指定 Agent（可选，默认用 default）
openclaw config set channels.discord.agent "my-agent"

配置文件方式：

// ~/.openclaw/openclaw.json
{
  channels: {
    discord: {
      botToken: "MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.GxYzAb.ABCDefGHIjklmnOPQrstUVwxyz1234567890",
      agent: "default",
    },
  },
}

重启 Gateway

openclaw gateway restart

让 Bot 上线

重启后，你会看到 Discord 服务器里你的 Bot 头像变成了 「在线」 状态（绿色小圆点）。这说明 Bot 已经成功连接到 Discord 并准备好接收消息了。

[截图：Discord 服务器角色列表中 Bot 显示在线状态]

---

15.4 群组 @提及

基本用法

在 Discord 服务器里，用 @Bot 的方式召唤 AI：

你：@我的AI助手 帮我总结一下这几天的讨论
Bot：来梳理一下最近讨论的重点：
1. 项目延期到 7 月 15 日 —— 因服务器资源不足
2. 需要增加两名后端开发
3. 周五下午 3 点开复盘会

[截图：Discord 频道中 @Bot 的对话]

💡 关键规则：Discord 通道默认只有 @提及 时 Bot 才会响应。这避免了 Bot 在频道里"偷听"所有对话。

私信 Bot

也可以直接给 Bot 发私信（DM）。私信默认不需要 @，直接发文字就行：

你：今天天气怎么样？
Bot：北京今天 28°C，多云转晴，适合出门。

频道级别策略

你可以控制 Bot 在哪些频道响应：

{
  channels: {
    discord: {
      channelPolicy: {
        // "open": 所有频道都响应
        // "allowlist": 只在指定频道响应
        // "disabled": 禁用所有频道
        mode: "allowlist",
        allowlist: ["123456789012345678", "876543210987654321"],  // 频道 ID
      },
    },
  },
}

如何获取频道 ID？在 Discord 中，右键频道名称 → 「复制 ID」。如果看不到这个选项，先去 用户设置 → 高级 → 开发者模式 打开它。

用户配对

第一次有人跟 Bot 对话时，终端会出现配对请求：

[discord] New pairing request from user "张三" (123456789012345678)
  Code: 7392
  Use: openclaw pairing approve discord 7392

批准：

openclaw pairing approve discord 7392

设置默认配对策略

如果想让服务器里的所有人都能直接用 Bot，可以把配对关掉：

openclaw config set channels.discord.pairing false
openclaw gateway restart

⚠️ 如果你在一个大型公开服务器里用 Bot，建议保留配对模式，否则任何人都能消耗你的 API 额度。

管理员模式

如果你想设置 Bot 只有服务器管理员可以管理，可以指定管理员角色 ID：

{
  channels: {
    discord: {
      adminRoles: ["123456789012345678"],  // 管理员角色 ID
    },
  },
}

---

15.5 Discord 的独特优势

为什么 Discord 是开发者最爱的通道？

特性	说明
Slash 命令	支持 /skill、/clear 等斜杠命令（需额外配置）
富文本	支持 Markdown（加粗、代码块、链接等），回复特别漂亮
线程	Bot 可以在线程中回复，不打扰主频道
嵌入消息	Agent 可以发送带格式和按钮的嵌入卡片
私密频道	可以创建只有你和 Bot 能看到的「AI 专属频道」
多服务器	一个 Bot 可以同时在多个服务器工作

创建 AI 专属频道（推荐）

在 Discord 服务器中，创建一个只有特定角色能看到、只有 @Bot 能回复的频道。方法：

1. 右键服务器名 → 创建频道
2. 选「文字频道」，取名 ai-assistant 或 🤖-ai
3. 在频道权限里，只给 Bot 和特定角色「查看频道」权限
4. 在这个频道里不需要 @ 就能直接跟 Bot 聊天

---

本章小结

步骤	操作
1️⃣ 创建 Bot	在 Discord Developer Portal 创建应用并添加 Bot
2️⃣ 获取 Token	在 Bot 页面点 Reset Token → 复制
3️⃣ 开启 Intents	在 Bot 页面开启 Message Content Intent
4️⃣ 生成邀请链接	OAuth2 → URL Generator → 勾选 bot 权限
5️⃣ 邀请入服	在浏览器打开邀请链接，选服务器
6️⃣ 配置	openclaw config set channels.discord.botToken "..."
7️⃣ 重启	openclaw gateway restart
8️⃣ @Bot	在频道发 @Bot 你好

Discord 通道非常适合技术团队和游戏社群。它丰富的消息格式和频道管理功能，让 AI 助手可以深度融入你的 Discord 社区。

下一章，我们来盘点其他通道——飞书、iMessage、Signal、Slack、Google Chat、Matrix，总有一款适合你！

---