前置准备
在开始之前，你需要：
- 已安装并运行 OpenClaw（参考安装部署教程）
- 一个 Discord 账号
- 你管理的 Discord 服务器（或有权限邀请机器人的服务器）
创建 Discord Bot
1. 创建应用程序
前往 Discord 开发者门户，点击 New Application 创建新应用。给它一个有意义的名字，比如 "OpenClaw Assistant"。
2. 创建 Bot 用户
在应用设置中，进入 Bot 页面，点击 Add Bot。在这里你可以设置 Bot 的头像和用户名。
复制 Bot Token——这是 OpenClaw 连接 Discord 的凭证，请妥善保管。
3. 开启必要权限
在 Bot 设置页面，找到 Privileged Gateway Intents 区域，开启以下两项：
- Message Content Intent：允许 Bot 读取消息内容
- Server Members Intent：允许 Bot 查询服务器成员信息
这两个权限是 OpenClaw 正常工作的必需项。
4. 生成邀请链接
进入 OAuth2 → URL Generator：
- Scopes 中勾选
bot和applications.commands - Bot Permissions 中勾选最小必要权限：
- View Channels（查看频道）
- Send Messages（发送消息）
- Read Message History（读取消息历史）
- Add Reactions（添加反应）
复制生成的链接，在浏览器中打开即可将 Bot 邀请到你的服务器。
5. 获取必要的 ID
在 Discord 中启用开发者模式：用户设置 → 高级 → 开发者模式。
启用后，你可以右键点击服务器、频道或用户，选择 复制 ID 获取数字 ID。记下你的服务器 ID，后续配置需要用到。
配置 OpenClaw
基础连接配置
编辑 ~/.openclaw/openclaw.json，添加 Discord 频道配置：
{
channels: {
discord: {
enabled: true,
token: "${DISCORD_BOT_TOKEN}" // 通过环境变量注入
}
}
}
将 Bot Token 写入环境变量文件 ~/.openclaw/.env：
DISCORD_BOT_TOKEN=your-bot-token-here
私信策略配置
控制谁能通过 Discord 私信与你的 AI 助手对话：
{
channels: {
discord: {
enabled: true,
token: "${DISCORD_BOT_TOKEN}",
dmPolicy: "pairing" // pairing | allowlist | open | disabled
}
}
}
推荐使用 pairing 模式，新用户需要通过配对审批才能使用。
服务器频道配置
你可以精细控制 Bot 在每个服务器中的行为：
{
channels: {
discord: {
enabled: true,
token: "${DISCORD_BOT_TOKEN}",
groups: {
"你的服务器ID": {
enabled: true,
requireMention: true, // 需要 @提及 才回复
channels: ["频道ID1", "频道ID2"] // 限制响应的频道
}
}
}
}
}
开启 requireMention 后，Bot 只在被 @ 提及时才会回复，避免在群聊中过度活跃。
验证与测试
重启 OpenClaw 网关后，检查连接状态：
# 查看频道连接状态
openclaw channels status --probe
# 运行诊断
openclaw doctor
如果一切正常，你应该能在 Discord 中 @ 你的 Bot 并收到 AI 回复。
常见问题
Bot 不响应消息？
- 检查是否开启了 Message Content Intent
- 确认 Bot 在目标频道有发送消息的权限
- 运行
openclaw doctor查看详细诊断
群聊中 Bot 回复太频繁？
- 开启
requireMention: true - 配置
channels数组限制响应的频道
如何支持多个服务器？
- 在
groups中为每个服务器 ID 添加独立配置 - 不同服务器可以设置不同的回复策略
Discord Bot 工具能力
OpenClaw 的 Discord 集成支持丰富的操作能力，在配置中默认开启了包括表情反应、消息管理、创建讨论帖等 30+ 项功能。角色管理和审核功能默认关闭，如有需要可手动开启。