一、准备工作

1.1 环境要求

• 一台能够访问Discord API的服务器或电脑（中国大陆用户需使用网络代理）
• 已安装OpenClaw
• Node.js环境

1.2 网络环境说明

<aside> ⚠️ 重要提醒：由于Discord服务器位于海外，中国大陆用户需要使用网络代理（如VPN）才能正常连接。这是成功配置的关键！

</aside>

二、创建Discord机器人

2.1 登录Discord开发者门户

1. 访问 Discord Developer Portal (https://discord.com/developers/applications)
2. 点击右上角的"New Application"按钮
3. 输入应用名称（如"OpenClaw助手"），点击"Create"

2.2 创建机器人

1. 在左侧菜单选择"Bot"
2. 点击"Add Bot"按钮
3. 确认创建，你会看到机器人的基本信息

2.3 配置机器人权限

1. 在Bot页面，找到"Privileged Gateway Intents"
2. 启用以下权限：

• Presence Intent
• Server Members Intent
• Message Content Intent

1. 这些权限对于OpenClaw正常工作至关重要

2.4 获取机器人Token

1. 在Bot页面，找到"Token"区域
2. 点击"Copy"按钮复制Token
3. 重要：妥善保管此Token，不要泄露给他人

三、邀请机器人到服务器

3.1 生成邀请链接

1. 在开发者门户左侧选择"OAuth2" → "URL Generator"
2. 在"Scopes"中勾选：

• bot
• applications.commands

1. 在"Bot Permissions"中至少勾选：

• View Channel
• Send Messages
• Manage Messages
• Embed Links
• Attach Files
• Read Message History
• Mention Everyone
• Connect（如果需要语音功能）
• Speak（如果需要语音功能）

3.2 完成邀请

1. 复制生成的URL
2. 在浏览器中打开该URL
3. 选择你要添加机器人的服务器
4. 点击"继续"并授权

四、配置OpenClaw

4.1 编辑配置文件

1. 打开OpenClaw配置文件 ~/.openclaw/openclaw.json
2. 找到 channels 部分，添加或修改Discord配置：

4.2 替换Token

• 将 YOUR_BOT_TOKEN_HERE 替换为你在第2.4步获取的Token
• 确保Token格式正确，通常以数字开头，包含点号和字母

4.3 保存配置

1. 保存配置文件
2. 重启OpenClaw服务

五、测试连接

5.1 启动OpenClaw

openclaw gateway start

5.2 检查日志

1. 查看日志文件 ~/.openclaw/logs/gateway.log
2. 寻找 [discord] logged in to discord as 相关信息
3. 如果看到类似信息，说明连接成功

5.3 测试交互

1. 在Discord服务器中 @ 你的机器人
2. 发送简单消息测试响应

六、常见问题及解决方案

6.1 连接失败

症状: [discord] channel exited: Failed to resolve Discord application id

解决方案:

• 检查网络代理是否正常工作
• 确认Token是否正确无误
• 检查机器人权限是否配置正确

6.2 无法发送消息

症状: 机器人在线但不回应

解决方案:

• 检查服务器权限设置
• 确认机器人在相应频道有读写权限
• 检查OpenClaw配置中的频道策略

6.3 消息延迟

症状: 机器人响应很慢

解决方案:

• 检查网络延迟
• 确认网络代理稳定性
• 检查服务器性能

七、高级配置选项

7.1 限制特定服务器

如果只想让机器人在特定服务器工作：

7.2 限制特定频道

如果只想让机器人在特定频道工作：

八、安全注意事项

• Token保护: 永远不要将Token暴露在公共代码库或分享给他人
• 权限最小化: 只给予机器人必要的权限
• 定期轮换: 建议定期更换Token
• 监控日志: 定期检查日志文件，发现异常情况

九、故障排除清单

• [ ] 网络代理是否正常工作
• [ ] Discord开发者门户设置是否正确
• [ ] 机器人Token是否正确
• [ ] 权限设置是否完整
• [ ] 邀请链接是否正确生成
• [ ] OpenClaw配置文件格式是否正确
• [ ] 服务器是否有足够的权限

十、进阶功能

10.1 自定义命令

你可以在OpenClaw中配置自定义命令，让机器人执行特定功能。

10.2 多服务器支持

配置完成后，机器人可以同时在多个服务器中工作。

10.3 自定义响应

根据需要定制机器人的响应行为和内容。

---

<aside> 💡 最后提醒：由于网络环境的特殊性，配置过程中可能需要多次尝试。保持耐心，并确保网络代理稳定运行。

</aside>