OpenClaw Discord 指南

OpenClaw 与 Discord 的实用平台指南,包含 Bot 创建、频道配置和首次闭环验证。
2026/03/12

OpenClaw Discord 指南

这个页面教你怎么把 OpenClaw 接入 Discord,并验证你的第一个可用闭环。

Discord 是大多数新手的第一个推荐渠道,因为:

  • Bot 搭建流程文档完善
  • 测试很容易(在 channel 发一条消息就行)
  • 可见性好(你能看到所有发生的事)
  • 个人和团队 workflow 都适用

开始之前

请先确认你已经完成:

在 Gateway 正在运行且基本安装通过 health check 之前,不要连接 Discord。


第一步:创建 Discord 应用和 Bot

  1. 前往 Discord Developer Portal
  2. 点击 "New Application",给它起个名字
  3. 在左侧栏进入 "Bot" 部分
  4. 点击 "Add Bot" 或 "Reset Token" 获取 bot token
  5. 复制 token——你需要它来配置 OpenClaw

注意:bot token 是机密。不要分享,也不要提交到代码仓库。


第二步:配置 Bot 权限

在 Developer Portal 中,进入 "OAuth2" → "URL Generator":

  1. 在 Scopes 下,选择 bot
  2. 在 Bot Permissions 下,至少选择:
    • Read Messages/View Channels
    • Send Messages
    • Read Message History
  3. 复制生成的 URL,在浏览器中打开
  4. 选择你要添加 Bot 的服务器
  5. 授权 Bot

Bot 现在应该出现在你的 Discord 服务器成员列表中(在 Gateway 连接之前会显示为离线)。


第三步:获取 channel 和 server ID

你需要 Bot 运行所在频道的 ID:

  1. 在 Discord 中,进入 设置 → 高级 → 开启"开发者模式"
  2. 右键点击目标频道 → "复制频道 ID"
  3. 右键点击服务器名称 → "复制服务器 ID"

你需要把这些 ID 添加到 OpenClaw 配置中。


第四步:将 Discord 配置添加到 OpenClaw

在 OpenClaw workspace 配置中添加 Discord channel 配置:

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "你的-bot-token",
      "guildId": "你的服务器-id",
      "channelId": "你的频道-id"
    }
  }
}

把占位符替换成你实际的 bot token、服务器 ID 和频道 ID。


第五步:重启 Gateway 并验证

保存配置后:

  1. 重启 Gateway(openclaw gateway restart 或通过 app)
  2. 确认 Bot 在 Discord 服务器中显示为"在线"
  3. 在配置的频道中发送一条测试消息
  4. 等助手回复

如果 Bot 没有上线:

  • 验证 token 是否正确
  • 检查 Gateway 是否正在运行
  • 查看 Gateway 日志中的连接错误

如果 Bot 上线了但不回复:

  • 确认 channel ID 和你发消息的频道匹配
  • 检查 Bot 是否有在该频道读取和发送消息的权限
  • 验证你的模型提供商 API key 是否有效

第六步:验证第一条闭环

发一条简单的消息,比如"你好"或"你能做什么?",确认:

  • 助手收到了消息
  • 助手生成了回复
  • 回复出现在了 Discord 频道中

如果这一步能通,你的 Discord 配置就完成了。


Discord 跑通后下一步

  1. OpenClaw Heartbeat 指南 —— 加一个周期性健康检查
  2. OpenClaw for Discord Support Workflows —— 搭建真实的客服 workflow
  3. OpenClaw Use Cases —— 探索更多 workflow 模板

常见问题

Bot 显示离线

  • Gateway 没在运行,或者 token 错了
  • 检查 openclaw gateway status 并验证配置中的 token

Bot 在线但不回复

  • Channel ID 不匹配(Bot 监听的是另一个频道)
  • Bot 缺少在目标频道读取/发送消息的权限
  • 模型提供商 API key 无效或没有额度

Bot 回复到了错误的频道

  • 配置的 channelId 和你发消息的频道不一致
  • 更新配置并重启 Gateway

限流或回复慢

  • Discord 对 Bot 消息有限流
  • 如果有延迟,检查是模型提供商响应慢还是 Discord 在限流 Bot

相关页面

下一步