ClawdBot (OpenClaw) 结合 Discord 机器人部署实战指南
一、前置环境与网络要求
在开始之前，请确保你的开发环境能够访问 Discord 服务。由于网络限制，可能需要配置代理或 TUN 模式以保证连接稳定。
二、Discord 开发者平台配置
1. 创建应用与机器人
登录 Discord 开发者平台，点击 New Application 创建新应用。进入 Bot 选项卡，添加机器人并复制 Token。务必妥善保管 Token，切勿泄露。
2. 权限与邀请链接
在 Bot 设置中勾选所需权限。随后进入 OAuth2 → URL Generator，选择 scopes 和 bot 权限，生成邀请链接。将该链接发送给目标服务器并完成授权，Bot 即可上线。
三、ClawdBot 安装与配置
1. 全局安装
使用 pnpm 进行全局安装（官方项目已更名为 openclaw，但命令仍兼容）：
pnpm add -g clawdbot@latest
2. 初始化与参数配置
执行初始化命令以安装 Daemon 服务：
clawdbot onboard --install-daemon
按提示填写配置信息：
- AI 模型：选择提供商（如智谱 GLM），输入有效的 API Key。
- Discord Token：填入步骤二中复制的 Bot Token。
3. 启动网关服务
配置完成后，启动 Gateway 服务：
clawdbot gateway --port 18789 --verbose
其中 --port 指定监听端口，--verbose 开启详细日志以便调试。
四、使用与故障排查
1. 交互测试
在 Discord 频道中 @机器人名称并发送消息，例如 @机器人名称 你好，你是谁？，观察响应情况。
2. 常见问题
- 无法响应：检查网络代理是否生效，确认 Gateway 服务进程存活，验证 Token 是否正确。
- API 调用失败：核对 API Key 有效性及配额，查看 verbose 日志中的具体错误堆栈。
- 权限不足：确认 Bot 在服务器内拥有必要的管理权限及频道访问权限。
五、安全建议
定期更换 Token 和密钥，避免将敏感信息上传至公共代码库。保持网络环境稳定是服务持续运行的基础。
