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 }
}
}
}
}
}
} 使用要点
私信和频道会话是分开的
私信折叠到主会话,服务器频道则按 channel:<channelId> 保持隔离,适合团队频道类场景。
别默认给机器人看所有消息
共享频道建议继续保留 requireMention,避免机器人在高流量频道被持续无意触发。