首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
文档导航 聊天渠道
聊天渠道 3 个部分 3 条关键信息

Discord Bot API

Discord

Discord 适合团队、社区和频道协作。OpenClaw 已支持私信与服务器文本频道通信,但你需要正确处理 bot token、Message Content Intent、权限和 guild / channel 级规则。

快速设置

1. 在 Discord Developer Portal 创建应用与 bot,复制 token。

2. 打开 Message Content Intent;如果你要做成员查找或更细 allowlist,再打开 Server Members Intent

3. 用消息权限邀请机器人进入目标服务器。

4. 通过配置 channels.discord.token 或环境变量 DISCORD_BOT_TOKEN 交给 OpenClaw。

常见配置片段

最小配置

{
  channels: {
    discord: {
      enabled: true,
      token: "YOUR_BOT_TOKEN"
    }
  }
}

单服务器、仅指定频道 + 用户

{
  channels: {
    discord: {
      dm: { enabled: false },
      guilds: {
        YOUR_GUILD_ID: {
          users: ["YOUR_USER_ID"],
          requireMention: true,
          channels: {
            help: { allow: true, requireMention: true }
          }
        }
      }
    }
  }
}

使用要点

Routing

私信和频道会话是分开的

私信折叠到主会话,服务器频道则按 channel:<channelId> 保持隔离,适合团队频道类场景。

Safety

别默认给机器人看所有消息

共享频道建议继续保留 requireMention,避免机器人在高流量频道被持续无意触发。