openclaw配置discord踩坑

openclaw配置discord踩坑

错误信息


根本原因
中国大陆网络环境下,Discord API 和 Gateway 均被屏蔽,需要特殊网络配置。

解决思路
Discord 需要同时连接 REST API(HTTPS)和 WebSocket(WSS),普通 HTTP 代理无法处理 WebSocket,需使用 TUN 模式全局代理。


  1. 访问 Discord Developer Portal
  2. 创建 Application → Bot 页面
  3. 开启 openclaw Privileged Intents
    • Message Content Intent(必需,用于读取消息内容)
    • Server Members Intent(如需白名单功能)
  4. 复制 Bot Token(格式类似 ,很长一串,不是 Client ID)
  5. 通过 OAuth2 URL Generator 将 Bot 邀请至服务器
  1. Discord 设置 → 高级 → 开启「开发者模式」
  2. 右键点击服务器名称 → 「复制服务器 ID」(18-19位数字)
  • 安装 * Verge 或其他支持 TUN 模式的代理工具
  • 确保有稳定的海外节点

⚠️ 版本要求:OpenClaw >= 2026.2.12

从 2026.2.12 版本开始,OpenClaw 支持为 Discord 频道单独配置代理,无需开启 TUN 模式。

编辑 OpenClaw 配置文件():


关键新增字段

  • : HTTP/SOCKS5 代理地址,Discord 会通过此代理连接

优势

  • 无需开启 TUN 模式
  • 不影响其他应用程序的网络
  • 配置简单,即配即用

如果 OpenClaw 版本低于 2026.2.12,或方法 1 无法使用,可采用 TUN 模式。

步骤 1:配置 OpenClaw

编辑 OpenClaw 配置文件( 或项目目录下的配置):


关键字段说明

  • : Bot Token,不是 Client ID
  • : Bot 的应用 ID(通过 curl 测试或 Developer Portal 查看)
  • : (白名单模式)或 (开放所有服务器)
  • : 是否需要 @Bot 才能触发对话

步骤 2:开启 TUN 模式(关键步骤)

为什么需要 TUN 模式?

  • Discord REST API 可走 HTTP 代理
  • Discord Gateway(WebSocket)必须走 TUN 虚拟网卡

* Verge 配置

  1. 设置 → 系统服务 → 安装 Service Mode(服务模式)
  2. 首页 → 开启 TUN 模式(TUN Mode)
  3. 确认 TUN 网卡已创建(网络连接中会出现 * 虚拟网卡)

⚠️ 重要:删除环境变量
如果之前设置过 或 ,必须删除:


步骤 3:验证并启动

  1. 测试网络连通性(验证 Token 有效性):

  1. 启动 OpenClaw

成功标志



阶段 现象 原因 解决 初期 网络不通,无法验证 Token 配置 字段(推荐)或开启 TUN 模式 中期 REST API 通(curl 成功),但 WebSocket 未走代理 升级到 >= 2026.2.12 使用 配置,或开启 TUN 模式 后期 TUN 模式与环境变量冲突 删除 HTTP_PROXY/HTTPS_PROXY 环境变量



使用代理模式(方法 1)

使用 TUN 模式(方法 2)


  1. 推荐配置:OpenClaw >= 2026.2.12 时,优先使用 配置,无需 TUN 模式
  2. 代理稳定性:使用 模式时,如果 * 重启或切换节点,OpenClaw 会自动重连
  3. TUN 模式稳定性:使用 TUN 模式时,如果 * 重启或切换节点,可能需要重启 OpenClaw
  4. Token 安全:不要将真实 Token 提交到 Git,使用环境变量或 文件
  5. Intent 权限:如果 Bot 收不到消息,检查 Discord Developer Portal 中的 Message Content Intent 是否开启
  6. 日志查看:遇到问题使用 查看详细日志

配置完成时间:2026-02-07
最后更新时间:2026-02-26
OpenClaw 版本:>= 2026.2.12 (推荐) / 旧版本需 TUN 模式
操作系统:Windows 11
代理工具:* Verge (HTTP 代理 / TUN Mode)



版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:Ai探索者,转载请注明出处:https://javaforall.net/256579.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 上午11:01
下一篇 2026年3月13日 上午11:01


相关推荐

关注全栈程序员社区公众号