前提条件
- 一个 Discord 账号
- 一个您拥有 管理服务器 权限的 Discord 服务器
- 一个 LemonClaw 实例:
- 托管版:创建一个 Claw 实例
- 私有部署:安装 LemonClaw
设置指南
创建 Discord 应用
- 前往 Discord 开发者门户
- 点击 New Application
- 为其命名(例如 “My AI Bot”)并点击 Create
创建机器人
- 在您的应用中,前往 Bot 选项卡
- 点击 Add Bot → Yes, do it!
- 在 Privileged Gateway Intents 下,启用:
- Message Content Intent(必选)
- Server Members Intent(推荐)
- 点击 Reset Token 以生成机器人 token
- 复制该 token — 您稍后会用到它
邀请机器人到您的服务器
- 前往 OAuth2 选项卡 → URL Generator
- 在 Scopes 下,选择:
bot,applications.commands - 在 Bot Permissions 下,选择:
Send Messages,Read Message History - 复制生成的 URL 并在浏览器中打开
- 选择您的服务器并点击 Authorize
打开 LemonClaw WebUI
- 如果您使用的是托管版 Claw,请前往您的 Claw 控制面板 并点击 Open WebUI
- 如果您是私有部署 LemonClaw,请打开您自己的 WebUI(例如
http://your-ip:18789)并使用您的 token 登录 - 在 WebUI 中,导航至 Settings → Channels
- 展开 Discord 部分
- 粘贴您的 Bot Token
- 点击 Save
在服务器中使用
群组设置
在 LemonClaw WebUI 的 Channels 设置中配置服务器(guild)行为:| 设置 | 选项 | 描述 |
|---|---|---|
| Group Policy | Open (默认) / Allowlist / Disabled | 控制对服务器频道的访问权限 |
| Require @mention | On / Off | 机器人仅在被 @ 时响应(推荐) |
| Group IDs | Guild ID 列表 | 限制在特定服务器中(留空 = 所有服务器) |
Discord 使用基于每个服务器的用户白名单,而不是全局群组白名单。如需进行高级的单服务器用户过滤,请直接在 LemonClaw 配置文件中进行配置。
私信(DM)策略
控制谁可以向您的机器人发送私信:| 策略 | 行为 |
|---|---|
| Pairing (默认) | 新用户将获得配对码 — 在 WebUI 中输入以进行授权 |
| Allowlist | 仅限您指定的 ID 用户可以向机器人发送私信 |
| Open | 任何人都可以向机器人发送私信(请谨慎使用) |
故障排除
机器人在线但不响应
机器人在线但不响应
- 确保在开发者门户中启用了 Message Content Intent
- 验证机器人 token 是否正确
- 检查机器人是否拥有在该频道读取和发送消息的权限
机器人显示为离线
机器人显示为离线
- 在控制面板中检查您的实例状态(应为绿色/运行中)
- 尝试重启实例
- 验证 token 是否在开发者门户中被重置
日志中出现 409 Conflict 错误
日志中出现 409 Conflict 错误
- 当两个实例尝试使用同一个机器人 token 时会发生这种情况
- 确保只有一个 LemonClaw 实例配置了此 token