ClawdBot (OpenClaw) Discord 机器人部署实战指南
本文基于 ClawdBot（OpenClaw）框架，分享在 Discord 平台部署 AI 对话机器人的完整流程。涵盖应用创建、权限管理、环境配置及服务启动等核心环节。
一、网络与环境要求
部署前需确保本地网络能够稳定访问 Discord 服务。建议使用 TUN 模式代理，这对保持长连接稳定性至关重要。
二、Discord 平台配置
1. 创建应用程序
登录 Discord 开发者平台，点击 New Application 创建新应用，输入名称即可。
2. 添加 Bot 并获取 Token
进入应用设置页面的 Bot 选项卡，点击 Add Bot 创建机器人。随后找到 Token 区域，点击 Copy 复制密钥。
注意： Token 等同于密码，请务必妥善保管，切勿泄露。
3. 配置权限与邀请链接
在 Bot 设置中勾选所需的权限。接着进入 OAuth2 → URL Generator，选择对应的 Scopes 和 Bot 权限，生成邀请链接。
将链接发送给管理员，授权后即可将 Bot 加入指定服务器。
三、ClawdBot 安装与配置
官方文档地址：https://docs.openclaw.ai/
1. 全局安装
使用 pnpm 进行全局安装。注意命令格式，中间需有空格。
pnpm add -g clawdbot@latest
说明：项目已更名为
openclaw，但clawdbot命令依然可用。
2. 初始化 Daemon 服务
执行 onboard 命令完成初始化，该步骤会自动安装守护进程。
clawdbot onboard --install-daemon
3. 填写配置参数
按提示依次填入以下信息：
- AI 模型 API Key：以智谱 GLM 为例，提前准备好对应服务的 API Key 并确保配额充足。
- Discord Bot Token：粘贴第二步中复制的 Token。
四、启动与服务调试
运行 Gateway 服务，建议开启详细日志以便排查问题。
clawdbot gateway --port 18789 --verbose
--port 18789：指定服务监听端口。--verbose：启用详细日志输出。
五、使用与交互
打开 Discord 客户端，进入已添加 Bot 的服务器频道，@机器人名称即可开始对话。
@机器人名称 你好，你是谁？
六、常见问题排查
-
Bot 无法响应
- 检查网络代理是否稳定，TUN 模式是否生效。
- 确认 Gateway 服务进程是否存活。
- 核对 Bot Token 是否准确无误。
-
API 调用失败
- 验证 AI 服务商的 API Key 有效性。
- 查看账户配额是否耗尽。
- 通过 verbose 日志定位具体错误码。
-
权限不足
- 检查 Bot 在服务器内的角色权限。
- 确认频道级别的权限设置是否允许 Bot 发言或读取消息。
七、安全与维护
- 密钥管理：切勿将 Bot Token 和 API Key 公开分享，建议定期轮换密钥。
- 网络保障：始终保持稳定的网络连接，确保能同时访问 Discord 和 AI 服务接口。
