教程

OpenClaw Discord Bot 完整搭建教程:让 Claude AI 进入你的 Discord 服务器

用 OpenClaw 搭建 Discord AI 机器人完整教程:创建 Discord 应用和 Bot Token、OpenClaw 配置步骤、频道权限设置、@提及触发、斜杠命令集成、多服务器部署,以及 Discord 频道 AI 工作流最佳实践。

2026/3/153分钟 阅读ClaudeEagle

通过 OpenClaw,你可以在 Discord 服务器里部署一个 Claude AI 机器人——回答问题、辅助代码审查、自动化工作流,让整个团队都能使用。

第一步:创建 Discord 应用

  1. 访问 discord.com/developers/applications
  2. 点击「New Application」,输入名称(例如:Claude Assistant)
  3. 左侧菜单点击「Bot
  4. 点击「Add Bot」-> 确认
  5. 点击「Reset Token」-> 复制并保存 Bot Token

必须开启的权限(Privileged Gateway Intents)

  • Message Content Intent ✅(读取消息内容)
  • Server Members Intent ✅(可选)

第二步:邀请 Bot 到服务器

  1. 左侧菜单点击「OAuth2」->「URL Generator」
  2. Scopes 选择:botapplications.commands
  3. Bot Permissions 选择:
    • Read Messages/View Channels
    • Send Messages
    • Read Message History
    • Add Reactions
  4. 复制生成的 URL,浏览器打开,选择你的服务器

第三步:配置 OpenClaw

bash
openclaw configure --section discord

按提示输入:

Discord Bot Token: 你的Bot Token Discord Application ID: 在 General Information 页面找 Allowed Guild IDs: 你的服务器ID(右键服务器图标->复制ID,需开启开发者模式)

或直接编辑 ~/.openclaw/config.json

json
{
  "channels": {
    "discord": {
      "enabled": true,
      "botToken": "你的Bot Token",
      "applicationId": "你的应用ID",
      "allowedGuilds": ["你的服务器ID"],
      "mentionRequired": true,
      "allowedChannels": ["频道ID1", "频道ID2"]
    }
  }
}

第四步:启动并测试

bash
openclaw start
# 看到:Discord channel: connected

在 Discord 频道里 @你的机器人:

@Claude Assistant 你好,介绍一下自己

触发模式配置

模式 1:@提及触发(默认,推荐)

json
{
  "mentionRequired": true
}

只有 @机器人 才会触发,不会响应所有消息。

模式 2:特定频道全响应

json
{
  "mentionRequired": false,
  "activeChannels": ["ai-assistant频道ID"]
}

#ai-assistant 频道里发任何消息都会触发。

模式 3:线程模式

json
{
  "threadMode": true
}

每次对话在独立的 Thread 里进行,不影响主频道。

常用 Discord AI 工作流

代码帮助频道

# SOUL.md 配置: 你是一个专注于代码帮助的 AI 助手。 在 Discord 服务器里,当开发者 @你 时: - 帮助 debug 他们分享的代码 - 解释复杂的技术概念 - 提供代码示例 回复要简洁(Discord 适合短回复),使用代码块格式

PR Review 通知频道

bash
# GitHub Webhook -> OpenClaw -> Discord
# 有新 PR 时自动通知 #code-review 频道并提供 AI 摘要
openclaw cron add \
  --schedule '*/15 * * * *' \
  --task '检查 GitHub 待 review 的 PR,发送摘要到 Discord #code-review 频道'

问答机器人

# CLAUDE.md 里加知识库路径 当有人提问时,先查找 docs/ 目录里的文档, 找到相关内容后回答,并引用具体文档页面。 没有相关文档时,明确说明。

常见问题

Q:Bot 在线但不响应消息 检查:1) Message Content Intent 是否开启;2) allowedGuilds 是否包含服务器 ID;3) 频道 ID 是否在 allowedChannels 里

Q:怎么开启开发者模式(复制 ID) Discord 设置 -> 高级 -> 开发者模式 ✅,然后右键任何元素就能复制 ID

Q:Bot 在多个服务器都能用吗? 可以,把所有服务器 ID 加入 allowedGuilds 数组。

Q:能限制只有特定角色的人使用吗? 在配置里加 allowedRoles 字段,只有该角色的成员 @机器人 才会响应。


来源:OpenClaw 官方文档 | Discord Developer Portal

相关文章推荐

教程OpenClaw Slack 集成完全指南:把 Claude AI 接入你的工作频道OpenClaw Slack Bot 完整配置教程:创建 Slack App 和 Bot Token、Slash Commands 设置、频道消息触发、@提及响应、工作流通知推送(部署/告警/报告)、Slack Workflow Builder 集成,以及企业版 Slack 的管理员权限配置要点。2026/3/16教程OpenClaw + Telegram 配置完全教程:5 分钟把 Claude 变成你的私人 Telegram 机器人OpenClaw 连接 Telegram 完整教程:BotFather 创建机器人、获取 Bot Token、OpenClaw 配置步骤、第一次对话测试、多用户权限控制、常见连接问题解决,以及 Telegram 频道和群组模式配置。2026/3/15教程OpenClaw + BlueBubbles:macOS iMessage AI 助手最佳方案完全指南OpenClaw 通过 BlueBubbles 接入 iMessage 的完整教程:为什么 BlueBubbles 是目前 iMessage 自动化的最佳方案(相比旧版 imsg CLI 的优势:支持消息编辑/撤回/Tapbacks/群组管理/稳定 REST API)、BlueBubbles macOS 服务器安装与配置、获取 Server URL 和密码、OpenClaw 最简配置(baseUrl + password)、DM 与群组访问控制、@ 提及触发、命令前缀触发、打字状态与已读回执、媒体消息处理,以及 macOS 26 Tahoe 上的已知限制。2026/3/23教程OpenClaw 接入 Zalo:越南最流行即时通讯 AI 助手完全配置指南OpenClaw 接入 Zalo 的完整教程:Zalo Bot API 与 Zalo Personal(个人账号)两种模式详解、插件安装(@openclaw/zalo)、在 Zalo Bot 平台创建 Bot 并获取 Token、最简配置示例、DM 配对与私信权限控制、群组消息处理、Long-polling vs Webhook 两种消息接收方式对比、支持的消息类型(文字/图片/文件/位置)、Zalo Personal QR 码登录方式,以及越南市场 AI 助手的典型使用场景。2026/3/23教程OpenClaw 接入 Mattermost:自托管团队聊天平台的 AI 助手配置完全指南OpenClaw 接入 Mattermost 的完整教程:插件安装方式(openclaw plugins install @openclaw/mattermost)、创建 Mattermost Bot 账户并获取 Token、最简配置(botToken + baseUrl + dmPolicy)、原生斜杠命令注册(oc_* 命令)、频道/群组/私信三种消息模式、线程会话管理、多账户配置、DM 白名单权限控制、交互式按钮支持,以及 Mattermost 与 Slack 的功能对比。2026/3/22教程OpenClaw Windows 安装完全指南:WSL2 配置、PowerShell 安装与常见问题OpenClaw 在 Windows 上的完整安装教程:为什么推荐 WSL2、WSL2 安装与配置步骤、PowerShell 一键安装脚本、Windows 防火墙与端口设置、Telegram/Discord 频道配置、开机自启动设置,以及 Windows 特有的常见问题排查(路径问题、权限问题、WSL 网络访问)。2026/3/17