本文介绍了基于 ClawdBot (OpenClaw) 框架在 Discord 平台部署 AI 对话机器人的完整流程。内容包括:Discord Application 与 Bot 的创建配置、OAuth2 权限管理、pnpm 全局安装、Daemon 服务配置、多模型 API 接入(支持智谱 GLM 等主流大模型)、Gateway 服务启动与调试等核心环节。
网络环境要求
- 确保网络能够访问 Discord 服务
- 建议使用 TUN 模式
Discord 平台配置
访问 Discord 开发者平台
访问地址:https://discord.com/developers/applications
创建应用程序
- 登录 Discord 开发者平台
- 点击 New Application 创建新应用
- 输入应用名称并确认创建
创建 Bot
- 在应用设置页面,找到 Bot 选项卡
- 点击 Add Bot 创建机器人
- 确认创建 Bot
- 找到 Token 部分
- 点击 Copy 复制 Token
注意:请妥善保管 Token,不要泄露
配置 Bot 权限
- 在 Bot 设置页面中,配置所需的权限
- 根据实际需求勾选相应的权限选项
保存配置
生成邀请链接
- 进入 OAuth2 → URL Generator
- 选择所需的作用域 (Scopes)
- 选择 Bot 权限
复制生成的邀请链接
添加 Bot 到服务器
- 打开生成的邀请链接
- 选择要添加 Bot 的 Discord 服务器
- 确认授权
- Bot 将自动加入到指定的服务器
ClawdBot (OpenClaw) 安装配置
ClawdBot (OpenClaw) 开发者平台:https://docs.openclaw.ai/
全局安装 ClawdBot
pnpm add -g clawdbot@latest
说明:官方已将项目改名为 openclaw,但 clawdbot 命令仍然可以正常使用。
初始化配置
执行初始化命令:
clawdbot onboard --install-daemon
配置参数
按照提示依次填写以下信息:
配置 AI 模型
- 选择您使用的 AI 模型提供商
- 示例:智谱 GLM(根据实际使用的模型自行调整)
- 输入对应的 API Key
提前准备:确保已获取对应 AI 服务的 API Key,确认 API Key 的有效性和配额。
配置 Discord Bot Token
确保 Token 正确无误
启动 Gateway 服务
执行以下命令启动服务:
clawdbot gateway --port 18789 --verbose
参数说明:
--port 18789:指定服务端口为 18789
--verbose:启用详细日志输出
使用机器人
与机器人对话
- 打开 Discord 应用
- 进入已添加 Bot 的服务器
- 在频道中@机器人名称
- 输入您的消息即可开始对话
示例:
@机器人名称 你好,你是谁?
常见问题与排查
故障排查
- Bot 无法响应
- 检查网络连接是否正常
- 确认 Gateway 服务是否正在运行
- 验证 Bot Token 是否正确
- API 调用失败
- 检查 API Key 是否有效
- 确认 API 配额是否充足
- 查看 verbose 日志获取详细错误信息
- 权限问题
- 确认 Bot 在 Discord 服务器中拥有必要的权限
- 检查频道权限设置
安全与配置提示
- 安全提醒
- 切勿将 Bot Token 和 API Key 泄露给他人
- 建议定期更换 Token 和密钥
- 网络要求
- 始终保持网络稳定
- 确保网络能够访问 Discord 和 AI 服务
参考资料