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 创建应用程序

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

2.3 创建Bot

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

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

2.4 配置Bot权限

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

保存配置

2.5 生成邀请链接

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

复制生成的邀请链接

2.6 添加Bot到服务器

1. 打开生成的邀请链接
2. 选择要添加Bot的Discord服务器
3. 确认授权
4. 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 与机器人对话

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

示例：

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

故障排查

常见问题

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

注意事项

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

附录

相关链接

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