OpenClaw入门：第9讲：Discord通道连接与Slash命令，开发者社区首选平台

github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好，我是正在实战各种AI项目的程序员晚枫。

今天我们来连接Discord，这是全球开发者和技术社区最流行的交流平台。GitHub、开源项目、技术团队几乎都在用Discord。

为什么选择Discord？

优势说明
开发者友好丰富的Bot API，完善的文档
功能强大支持Markdown、代码块、线程、角色权限
免费稳定无消息限制，服务器稳定
生态丰富大量现成的Bot和集成

创建Discord Bot

第一步：进入开发者门户

  1. 访问 https://discord.com/developers/applications
  2. 登录你的Discord账号
  3. 点击 “New Application”

第二步：创建应用

输入应用名称（如：OpenClaw Assistant），点击Create。

第三步：添加Bot

  1. 左侧菜单选择 “Bot”
  2. 点击 “Add Bot” → “Yes, do it!”
  3. 在Bot页面找到 Token，点击 “Reset Token” 并复制保存

⚠️ 重要：Token只显示一次，务必保存好！

第四步：设置权限

在Bot页面开启以下选项：

  • ✅ MESSAGE CONTENT INTENT（读取消息内容）
  • ✅ SERVER MEMBERS INTENT（获取成员列表）
  • ✅ PRESENCE INTENT（获取在线状态）

第五步：邀请Bot到服务器

  1. 左侧菜单选择 “OAuth2” → “URL Generator”
  2. 在Scopes中选择 bot 和 applications.commands
  3. 在Bot Permissions中选择：
    • Send Messages
    • Read Message History
    • Use Slash Commands
    • Embed Links
    • Attach Files
  4. 复制生成的URL，在浏览器中打开
  5. 选择要添加的服务器，点击授权

配置OpenClaw

编辑 ~/.openclaw/openclaw.json：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_DISCORD_BOT_TOKEN",
      "applicationId": "YOUR_APPLICATION_ID",
      "allowFrom": [],
      "guilds": {
        "allowedGuilds": [],
        "requireMention": false,
        "allowedChannels": []
      }
    }
  }
}

参数说明：

  • token: Bot的Token
  • applicationId: OAuth2页面的Application ID
  • guilds: 服务器（Discord中称Guild）配置

连接Discord

执行命令：

1
openclaw channels connect discord

看到以下输出表示成功：

1
2
3
4
[discord] Connecting...
[discord] Logged in as OpenClaw Assistant#1234
[discord] Connected to X guilds
[discord] Connected ✓

测试对话

私聊测试

  1. 在Discord中找到你的Bot
  2. 发送私信：
    1
    你好，请介绍一下自己

频道测试

在服务器频道中：

1
@OpenClaw Assistant 帮我写个Python函数

或直接使用Slash命令：

1
/ask 什么是机器学习？

Slash命令配置

Discord的Slash命令提供了更好的用户体验。

注册命令

在Discord开发者门户的 “OAuth2” → “URL Generator” 中已经启用了 applications.commands 权限。

常用命令示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
{
  "channels": {
    "discord": {
      "slashCommands": [
        {
          "name": "ask",
          "description": "向AI提问",
          "options": [
            {
              "name": "question",
              "description": "你的问题",
              "type": 3,
              "required": true
            }
          ]
        },
        {
          "name": "code",
          "description": "生成代码",
          "options": [
            {
              "name": "language",
              "description": "编程语言",
              "type": 3,
              "required": true
            },
            {
              "name": "task",
              "description": "任务描述",
              "type": 3,
              "required": true
            }
          ]
        },
        {
          "name": "reset",
          "description": "重置当前会话"
        }
      ]
    }
  }
}

高级功能

线程支持

Discord的线程（Thread）功能非常适合长对话：

1
2
3
4
5
6
7
8
9
10
11
{
  "channels": {
    "discord": {
      "threads": {
        "enabled": true,
        "autoCreate": true,
        "archiveAfter": 1440
      }
    }
  }
}

配置后，当对话变长时，Bot会自动创建线程继续对话。

角色权限控制

1
2
3
4
5
6
7
8
9
10
{
  "channels": {
    "discord": {
      "roles": {
        "allowedRoles": ["开发者", "管理员"],
        "blockedRoles": ["访客"]
      }
    }
  }
}

嵌入消息（Embeds）

Discord支持富文本消息，OpenClaw会自动将AI回复格式化为漂亮的Embed：

1
2
3
4
5
6
7
8
9
10
{
  "embeds": [{
    "title": "AI回复",
    "description": "回答内容...",
    "color": 3447003,
    "footer": {
      "text": "使用模型: Claude 3"
    }
  }]
}

生产环境配置

限制特定服务器

1
2
3
4
5
6
7
8
9
10
{
  "channels": {
    "discord": {
      "guilds": {
        "allowedGuilds": ["123456789012345678"],
        "allowedChannels": ["987654321098765432"]
      }
    }
  }
}

获取Guild ID和Channel ID

  1. 在Discord中开启开发者模式（设置→高级）
  2. 右键点击服务器名称→复制ID（Guild ID）
  3. 右键点击频道名称→复制ID（Channel ID）

常见问题

Q1: Bot显示在线但不回复

排查：

  • 检查Token是否正确
  • 确认MESSAGE CONTENT INTENT已开启
  • 查看日志：tail ~/.openclaw/state/logs/discord.log

Q2: Slash命令不显示

解决：

  • 重新邀请Bot，确保包含 applications.commands
  • 等待Discord同步（可能需要几分钟）
  • 检查命令是否已注册

Q3: 无法发送长消息

Discord单条消息限制2000字符，OpenClaw会自动分割长消息。

与其他通道对比

特性TelegramWhatsAppDiscord
目标用户通用通用开发者/社区
Markdown✅⚠️✅✅
代码高亮✅❌✅✅
线程讨论❌❌✅
角色权限❌❌✅
Slash命令❌❌✅

建议：技术团队优先选Discord，普通用户选Telegram。

下节预告

下一讲我们接入微信，这是国内最重要的平台。

👉 继续阅读：第10讲-微信通道接入实战

💬 加入学习交流群

Discord连接问题？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

🎁 限时福利：送《利用Python进行数据分析》实体书

👉 点击了解详情

—## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。

课程导航

上一篇： 第8讲-WhatsApp通道连接

下一篇： 第10讲-微信通道接入实战

PS：Discord的功能最丰富，特别适合技术团队使用。Slash命令的体验比纯文本@要好得多。

进群

嗨，扫码 进群

微信

扫一扫，分享到微信

微信分享二维码
本站总访问量次

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置：

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

编程博主，全网粉丝30w+，开源项目：python-office，我的微信：python-office