一、网络要求
- 网络环境
- 确保网络能够访问 Discord 服务
- TUN 模式(关键)
二、Discord 平台配置
2.1 访问 Discord 开发者平台
访问地址:https://discord.com/developers/applications
2.2 创建应用程序
- 登录 Discord 开发者平台
- 点击'New Application'创建新应用
- 输入应用名称并确认创建

2.3 创建 Bot
- 在应用设置页面,找到'Bot'选项卡
- 点击'Add Bot'创建机器人
- 确认创建 Bot
- 找到'Token'部分
- 点击'Copy'复制 Token
安全提示:请妥善保管 Token,不要泄露

2.4 配置 Bot 权限
- 在 Bot 设置页面中,配置所需的权限
- 根据实际需求勾选相应的权限选项
保存配置

2.5 生成邀请链接
- 进入'OAuth2' → 'URL Generator'
- 选择所需的作用域(Scopes)
- 选择 Bot 权限
复制生成的邀请链接

2.6 添加 Bot 到服务器
- 打开生成的邀请链接
- 选择要添加 Bot 的 Discord 服务器
- 确认授权
- Bot 将自动加入到指定的服务器

三、clawdbot (openclaw) 安装配置
clawdBot (openclaw) 开发者平台:https://docs.openclaw.ai/
3.1 全局安装 ClawdBot
pnpm add -g clawdbot@latest
说明:官方已将项目改名为
openclaw,但clawdbot命令仍然可以正常使用。
3.2 初始化配置
执行初始化命令:
clawdbot onboard --install-daemon
3.3 配置参数
按照提示依次填写以下信息:
3.3.1 配置 AI 模型
- 选择您使用的 AI 模型提供商
- 示例:智谱 GLM(根据实际使用的模型自行调整)
- 输入对应的 API Key
提前准备:确保已获取对应 AI 服务的 API Key
3.3.2 配置 Discord Bot Token
- 输入在步骤 2.3 中复制的 Bot Token
确保 Token 正确无误


3.4 启动 Gateway 服务
执行以下命令启动服务:
clawdbot gateway --port 18789 --verbose
参数说明:
--port 18789:指定服务端口为 18789--verbose:启用详细日志输出

四、使用机器人
4.1 与机器人对话
- 打开 Discord 应用
- 进入已添加 Bot 的服务器
- 在频道中@机器人名称
- 输入您的消息即可开始对话
示例:
@机器人名称 你好,你是谁?

故障排查
常见问题
- Bot 无法响应
- 检查网络连接是否正常
- 确认 Gateway 服务是否正在运行
- 验证 Bot Token 是否正确
- API 调用失败
- 检查 API Key 是否有效
- 确认 API 配额是否充足
- 查看 verbose 日志获取详细错误信息
- 权限问题
- 确认 Bot 在 Discord 服务器中拥有必要的权限
- 检查频道权限设置
注意事项
- 安全提醒
- 切勿将 Bot Token 和 API Key 泄露给他人
- 建议定期更换 Token 和密钥
- 网络要求
- 始终保持网络连接稳定
- 确保网络能够访问 Discord 和 AI 服务
附录
相关链接
- clawdBot (openclaw) 开发者平台:https://docs.openclaw.ai/
- Discord 开发者平台:https://discord.com/developers/applications


