clawdbot (openclaw) + discord 机器人部署指南学习教程
本文介绍了基于 ClawdBot（OpenClaw）框架在 Discord 平台部署 AI 对话机器人的完整流程。内容包括：Discord Application 与 Bot 的创建配置、OAuth2 权限管理、pnpm 全局安装、Daemon 服务配置、多模型 API 接入（支持智谱 GLM 等主流大模型）、Gateway 服务启动与调试等核心环节。
一、网络要求
- 魔法
- 确保网络能够访问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
pnpmadd -g clawdbot@latest 说明：官方已将项目改名为openclaw，但clawdbot命令仍然可以正常使用。
3.2 初始化配置
执行初始化命令：
clawdbot onboard --install-daemon 3.3 配置参数
按照提示依次填写以下信息：
3.3.1 配置AI模型
- 选择您使用的AI模型提供商
- 示例：智谱GLM（根据实际使用的模型自行调整）
- 输入对应的API Key
提前准备：
- 确保已获取对应AI服务的API Key
确认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无法响应
- 检查VPN连接是否正常
- 确认Gateway服务是否正在运行
- 验证Bot Token是否正确
- API调用失败
- 检查API Key是否有效
- 确认API配额是否充足
- 查看verbose日志获取详细错误信息
- 权限问题
- 确认Bot在Discord服务器中拥有必要的权限
- 检查频道权限设置
注意事项
- 安全提醒
- 切勿将Bot Token和API Key泄露给他人哈
- 建议定期更换Token和密钥
- 网络要求
- 始终保持VPN连接稳定
- 确保网络能够访问Discord和AI服务
附录
相关链接
- clawdBot (openclaw) 开发者平台：https://docs.openclaw.ai/
- Discord开发者平台：https://discord.com/developers/applications