# Discord 频道接入 OpenClaw 安装调试总结 ## 一、安装过程 ### 1. 创建 Discord Bot **步骤：** 1. 访问 Discord Developer Portal: https://discord.com/developers/applications 2. 创建新应用（如 "OpenClaw Bot"） 3. 添加 Bot 到应用 4. 配置特权权限： - Message Content Intent（必需） - Server Members Intent（推荐） 5. 获取 Bot Token 6. 配置 OAuth2 URL Generator： - Scopes: `bot` + `applications.commands` - Permissions: 查看频道、发送消息、阅读消息历史、嵌入链接、附加文件 - Integration Type: 服务器安装（Guild Install） **生成的授权 URL：** ``` https://discord.com/oauth2/authorize?client_id=&permissions=2262240812596336&scope=bot%20applications.commands&integration_type=0 ``` ### 2. 添加 Bot 到服务器 1. 浏览器打开授权 URL 2. 选择目标服务器 3. 点击授权 4. 检查服务器成员列表，确认 Bot 已添加 ### 3. 配置 OpenClaw **编辑配置文件：** `~/.openclaw/openclaw.json` ```json { "plugins": { "allow": [ "telegram", "weibo-openclaw-plugin", "feishu", "discord" ] }, "channels": { "discord": { "enabled": true, "token": "", "groupPolicy": "allowlist", "guilds": { "": { "requireMention": false, "users": [""] } }, "streaming": "off", "proxy": "http://127.0.0.1:7890" } } } ``` **关键配置项：** - `token`: Discord Bot Token（注意保密，不要泄露） - `groupPolicy`: `allowlist`（白名单模式） - `guilds`: 允许的服务器配置 - `proxy`: HTTP 代理端口（用于 Discord Gateway 连接） ### 4. 重启 OpenClaw 网关 ```bash openclaw gateway restart ``` --- ## 二、踩坑点总结 ### 坑 1：插件未启用 **问题：** Discord 频道没启动，日志里完全没有 Discord 相关信息。 **原因：** `plugins.allow` 里没有 `discord`。 **解决：** ```json { "plugins": { "allow": [ "telegram", "weibo-openclaw-plugin", "feishu", "discord" ] } } ``` --- ### 坑 2：代理配置错误（SOCKS5 不兼容 WebSocket） **问题：** ``` discord gateway error: Error: Proxy connection ended before receiving CONNECT response ``` **原因：** Discord Gateway 使用 WebSocket 连接，SOCKS5 代理不兼容 WebSocket 升级。 **解决：** 改用 HTTP 代理 ```json "discord": { "proxy": "http://127.0.0.1:7890" // 而不是 socks5://127.0.0.1:7891 } ``` --- ### 坑 3：应用程序命令部署失败 **问题：** Slash Command（`/model`）显示 "应用程序未响应" **原因：** Discord 应用程序命令（`applications.commands`）部署失败，网络请求超时。 **日志错误：** ``` discord startup [default] deploy-rest:put:error ... error=fetch failed ``` **解决：** 1. 确保 Discord Bot 的 OAuth2 URL 包含 `applications.commands` scope 2. 等待 Discord 同步命令（2-3 分钟） 3. 检查网络连接（代理是否正常） --- ### 坑 4：TUN 模式配置问题 **问题：** 以为需要 TUN 模式才能让 Discord 走代理。 **实际：** - Mihomo 的手动代理模式已经可以代理 Discord 流量 - 只要在 OpenClaw 配置里指定 `proxy` 即可 - TUN 模式是全局代理，不是必需的 --- ### 坑 5：配置热重载 **问题：** 修改配置后需要手动重启网关。 **实际：** OpenClaw 支持配置热重载（hot reload），修改 `openclaw.json` 后会自动重新加载频道。 **日志证据：** ``` config hot reload applied (channels.discord.proxy) ``` --- ### 坑 6：用户 ID 格式 **问题：** 配置里的 `users` 字段应该用 Discord 用户 ID，不是 Telegram 用户 ID。 **检查方法：** 1. Discord 设置 → 高级 → 开启开发者模式 2. 右键自己 → 复制用户 ID 3. 对比配置里的 ID --- ## 三、验证步骤 ### 1. 检查网关状态 ```bash openclaw gateway status ``` ### 2. 检查 Discord 日志 ```bash tail -100 /tmp/openclaw/openclaw-2026-04-01.log | grep -i discord ``` **成功标志：** ``` logged in to discord ``` ### 3. 检查 Discord 服务器 1. 服务器成员列表里能看到 Bot 2. 输入 `/` 看命令列表 3. 尝试 `/model` 命令 --- ## 四、最终配置 ### OpenClaw 配置（成功状态） ```json { "plugins": { "allow": [ "telegram", "weibo-openclaw-plugin", "feishu", "discord" ] }, "channels": { "discord": { "enabled": true, "token": "", "groupPolicy": "allowlist", "guilds": { "": { "requireMention": false, "users": [""] } }, "streaming": "off", "proxy": "http://127.0.0.1:7890" } } } ``` **注意：** 配置中的 ``、``、`` 需要替换为你自己的实际值。 ### Mihomo 配置要点 - HTTP 代理端口：`7890` - SOCKS5 代理端口：`7891` - 手动代理模式（无需 TUN） - 确保 Discord 域名走代理规则 --- ## 五、总结 ### 成功关键点 1. ✅ 启用 Discord 插件（`plugins.allow` 添加 `discord`） 2. ✅ 使用 HTTP 代理而非 SOCKS5（WebSocket 兼容性） 3. ✅ OAuth2 URL 包含 `applications.commands` scope 4. ✅ 配置热重载自动生效 5. ✅ 确保网络代理正常工作 ### 核心问题 - **WebSocket 代理兼容性**：SOCKS5 不支持 WebSocket 升级，改用 HTTP 代理 - **应用程序命令部署**：需要 `applications.commands` scope 和稳定的网络连接 - **配置热重载**：OpenClaw 自动检测配置变化并重新加载- ### 建议 1. 优先使用 HTTP 代理（端口 7890） 2. 确保 Discord Bot 的 OAuth2 URL 包含 `applications.commands` 3. 等待 Discord 同步命令（2-3 分钟） 4. 检查日志确认连接状态 5. **注意：Bot Token 等敏感信息务必保密，不要公开分享**

标签: Bot

Discord 频道接入 OpenClaw 安装调试总结