Discord 集成
将 ClawdBot 添加到你的 Discord 服务器
概述
Discord 是一个流行的社区和团队协作平台。通过 ClawdBot 的 Discord 集成, 你可以在服务器中创建一个智能 AI 助手,帮助社区成员回答问题、管理任务等。
ClawdBot 使用 Discord Bot API,支持私信、频道消息、斜杠命令等功能。
创建 Discord 应用
步骤 1: 访问开发者门户
- 访问 Discord Developer Portal
- 登录你的 Discord 账号
- 点击 "New Application"
- 输入应用名称(例如:ClawdBot)
步骤 2: 创建 Bot
- 在左侧菜单点击 "Bot"
- 点击 "Add Bot"
- 确认创建
步骤 3: 获取 Token
- 在 Bot 页面点击 "Reset Token"
- 复制生成的 Token
- 请妥善保存,Token 只显示一次!
步骤 4: 配置权限
在 Bot 设置页面:
- 开启 MESSAGE CONTENT INTENT
- 开启 SERVER MEMBERS INTENT(可选)
配置 ClawdBot 连接
方法 1: 使用命令行
clawdbot discord setup按提示输入 Bot Token。
方法 2: 使用配置文件
# ~/.clawdbot/config.yaml
channels:
discord:
enabled: true
token: "YOUR_DISCORD_BOT_TOKEN"
# 可选配置
prefix: "!" # 命令前缀
allowed_guilds: # 只在特定服务器响应
- 123456789012345678邀请 Bot 到服务器
生成邀请链接:
- 在开发者门户点击 "OAuth2" → "URL Generator"
- 选择 scopes:
bot,applications.commands - 选择权限(见下方权限设置)
- 复制生成的链接并访问
- 选择要添加的服务器
启动验证
# 重启 Gateway
clawdbot gateway restart
# 验证连接
clawdbot channels list权限设置
推荐的 Bot 权限:
| 权限 | 说明 | 必需 |
|---|---|---|
| Read Messages/View Channels | 读取频道消息 | ✅ |
| Send Messages | 发送消息 | ✅ |
| Embed Links | 发送富文本消息 | ✅ |
| Attach Files | 发送文件 | 推荐 |
| Read Message History | 读取历史消息 | 推荐 |
| Add Reactions | 添加表情反应 | 可选 |
| Use Slash Commands | 使用斜杠命令 | 推荐 |
功能特性
支持的消息类型
- 文本消息 - 普通对话
- 嵌入消息 - 富文本卡片
- 文件附件 - 图片和文件
- 表情反应 - 消息反应
激活方式
在 Discord 中,ClawdBot 可以通过以下方式激活:
- @mention - 在消息中 @ClawdBot
- 私信 - 直接发送私信给 Bot
- 斜杠命令 - 使用 /clawdbot 命令
- 前缀命令 - 使用配置的前缀(如 !ask)
斜杠命令
/clawdbot ask [question] - 向 ClawdBot 提问
/clawdbot status - 查看状态
/clawdbot help - 显示帮助故障排查
Bot 在线但不响应
- 确认已开启 MESSAGE CONTENT INTENT
- 检查 Bot 在该频道是否有权限
- 尝试使用 @mention 或斜杠命令
无法邀请 Bot
- 确认你有服务器的管理权限
- 检查邀请链接的权限设置
斜杠命令不显示
- 等待几分钟,Discord 同步需要时间
- 确保邀请时选择了
applications.commandsscope - 尝试重新邀请 Bot
查看日志
clawdbot logs --channel discord