ClawdBot (OpenClaw) 结合 Discord 机器人部署与配置指南
本文介绍了基于 ClawdBot(OpenClaw)框架在 Discord 平台部署 AI 对话机器人的完整流程。内容包括:Discord Application 与 Bot 的创建配置、OAuth2 权限管理、pnpm 全局安装、Daemon 服务配置、多模型 API 接入(支持智谱 GLM 等主流大模型)、Gateway 服务启动与调试等核心环节。
一、网络环境要求
- 网络访问:确保网络能够访问 Discord 服务。
- TUN 模式:建议使用 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,确认 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 服务。
附录
相关链接