OpenClaw Discord 机器人部署指南

OpenClaw Discord 机器人部署指南

本文介绍了基于 OpenClaw 框架在 Discord 平台部署 AI 对话机器人的完整流程。内容包括：Discord Application 与 Bot 的创建配置、OAuth2 权限管理、pnpm 全局安装、Daemon 服务配置、多模型 API 接入（支持智谱 GLM 等主流大模型）、Gateway 服务启动与调试等核心环节。

一、Discord 平台配置

1.1 访问 Discord 开发者平台

访问地址：https://discord.com/developers/applications

1.2 创建应用程序

1. 登录 Discord 开发者平台
2. 点击"New Application"创建新应用
3. 输入应用名称并确认创建

1.3 创建 Bot

1. 在应用设置页面，找到"Bot"选项卡
2. 点击"Add Bot"创建机器人
3. 确认创建 Bot
4. 找到"Token"部分
5. 点击"Copy"复制 Token

注意：请妥善保管 Token，不要泄露

1.4 配置 Bot 权限

1. 在 Bot 设置页面中，配置所需的权限
2. 根据实际需求勾选相应的权限选项

保存配置

1.5 生成邀请链接

1. 进入"OAuth2" → 'URL Generator'
2. 选择所需的作用域（Scopes）
3. 选择 Bot 权限

复制生成的邀请链接

1.6 添加 Bot 到服务器

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

二、OpenClaw 安装配置

OpenClaw 开发者平台：https://docs.openclaw.ai/

2.1 全局安装 ClawdBot

pnpm add -g clawdbot@latest

说明：官方已将项目改名为 openclaw，但 clawdbot 命令仍然可以正常使用。

2.2 初始化配置

执行初始化命令：

clawdbot onboard --install-daemon

2.3 配置参数

按照提示依次填写以下信息：

2.3.1 配置 AI 模型

• 选择您使用的 AI 模型提供商
• 示例：智谱 GLM（根据实际使用的模型自行调整）
• 输入对应的 API Key

提前准备：

• 确保已获取对应 AI 服务的 API Key

确认 API Key 的有效性和配额!

2.3.2 配置 Discord Bot Token

• 输入在步骤 1.3 中复制的 Bot Token

确保 Token 正确无误

2.4 启动 Gateway 服务

执行以下命令启动服务：

clawdbot gateway --port 18789 --verbose

参数说明：

• --port 18789：指定服务端口为 18789
• --verbose：启用详细日志输出

三、使用机器人

3.1 与机器人对话

1. 打开 Discord 应用
2. 进入已添加 Bot 的服务器
3. 在频道中@机器人名称
4. 输入您的消息即可开始对话

示例：

@机器人名称 你好，你是谁？

四、故障排查

常见问题

1. Bot 无法响应
   • 检查网络连接是否正常
   • 确认 Gateway 服务是否正在运行
   • 验证 Bot Token 是否正确
2. API 调用失败
   • 检查 API Key 是否有效
   • 确认 API 配额是否充足
   • 查看 verbose 日志获取详细错误信息
3. 权限问题
   • 确认 Bot 在 Discord 服务器中拥有必要的权限
   • 检查频道权限设置

五、注意事项

1. 安全提醒
   • 切勿将 Bot Token 和 API Key 泄露给他人
   • 建议定期更换 Token 和密钥
2. 网络要求
   • 始终保持网络连接稳定
   • 确保网络能够访问 Discord 和 AI 服务

附录

相关链接

• OpenClaw 开发者平台：https://docs.openclaw.ai/
• Discord 开发者平台：https://discord.com/developers/applications