这个页面教你怎么把 OpenClaw 接入 Discord,并验证你的第一个可用闭环。
Discord 是大多数新手的第一个推荐渠道,因为:
- Bot 搭建流程文档完善
- 测试很容易(在 channel 发一条消息就行)
- 可见性好(你能看到所有发生的事)
- 个人和团队 workflow 都适用
请先确认你已经完成:
在 Gateway 正在运行且基本安装通过 health check 之前,不要连接 Discord。
- 前往 Discord Developer Portal
- 点击 "New Application",给它起个名字
- 在左侧栏进入 "Bot" 部分
- 点击 "Add Bot" 或 "Reset Token" 获取 bot token
- 复制 token——你需要它来配置 OpenClaw
注意:bot token 是机密。不要分享,也不要提交到代码仓库。
在 Developer Portal 中,进入 "OAuth2" → "URL Generator":
- 在 Scopes 下,选择
bot
- 在 Bot Permissions 下,至少选择:
- Read Messages/View Channels
- Send Messages
- Read Message History
- 复制生成的 URL,在浏览器中打开
- 选择你要添加 Bot 的服务器
- 授权 Bot
Bot 现在应该出现在你的 Discord 服务器成员列表中(在 Gateway 连接之前会显示为离线)。
你需要 Bot 运行所在频道的 ID:
- 在 Discord 中,进入 设置 → 高级 → 开启"开发者模式"
- 右键点击目标频道 → "复制频道 ID"
- 右键点击服务器名称 → "复制服务器 ID"
你需要把这些 ID 添加到 OpenClaw 配置中。
在 OpenClaw workspace 配置中添加 Discord channel 配置:
{
"channels": {
"discord": {
"enabled": true,
"token": "你的-bot-token",
"guildId": "你的服务器-id",
"channelId": "你的频道-id"
}
}
}
把占位符替换成你实际的 bot token、服务器 ID 和频道 ID。
保存配置后:
- 重启 Gateway(
openclaw gateway restart 或通过 app)
- 确认 Bot 在 Discord 服务器中显示为"在线"
- 在配置的频道中发送一条测试消息
- 等助手回复
如果 Bot 没有上线:
- 验证 token 是否正确
- 检查 Gateway 是否正在运行
- 查看 Gateway 日志中的连接错误
如果 Bot 上线了但不回复:
- 确认 channel ID 和你发消息的频道匹配
- 检查 Bot 是否有在该频道读取和发送消息的权限
- 验证你的模型提供商 API key 是否有效
发一条简单的消息,比如"你好"或"你能做什么?",确认:
- 助手收到了消息
- 助手生成了回复
- 回复出现在了 Discord 频道中
如果这一步能通,你的 Discord 配置就完成了。
- OpenClaw Heartbeat 指南 —— 加一个周期性健康检查
- OpenClaw for Discord Support Workflows —— 搭建真实的客服 workflow
- OpenClaw Use Cases —— 探索更多 workflow 模板
- Gateway 没在运行,或者 token 错了
- 检查
openclaw gateway status 并验证配置中的 token
- Channel ID 不匹配(Bot 监听的是另一个频道)
- Bot 缺少在目标频道读取/发送消息的权限
- 模型提供商 API key 无效或没有额度
- 配置的
channelId 和你发消息的频道不一致
- 更新配置并重启 Gateway
- Discord 对 Bot 消息有限流
- 如果有延迟,检查是模型提供商响应慢还是 Discord 在限流 Bot