背景：本文源自一次耗时 7 小时的踩坑实录。为了让后来者能在 30 分钟内顺利上线，不再重蹈覆辙，特整理此“保姆级”实战指南。本文涵盖从插件安装、配置文件修改、网关绑定到内网穿透的全流程。
在开始之前，请务必牢记以下 3 个致死坑点，90% 的失败都源于此：
- 大小写由不得你：配置文件中必须使用 （小驼峰命名），绝对不要直接复制企业微信后台的全大写 作为 Key 名。
- 配置结构要完整：不能只在 里配参数，必须同时在 里启用插件。
- 网关绑定有讲究：OpenClaw 网关默认绑定 (127.0.0.1)，这会导致 FRP 等外部工具连不上。必须修改为 ，而不能用习惯的 。
确保你已经安装了 Node.js 环境。
1. 安装 OpenClaw
2. 安装企业微信插件
注意：旧插件 已废弃，请使用官方推荐的新插件。
安装完成后，运行 确认列表中包含 。
强烈建议直接编辑 JSON 配置文件，而不是使用 CLI 命令行工具设置，因为 CLI 容易弄乱复杂的嵌套结构。
打开配置文件：
✅ 正确的配置结构如下：
🔍 细节点拨：
- plugins.entries: 这一段必不可少，用于显式启用插件。
- token: 对应企业微信后台的 Token。
- encodingAesKey: 注意这里是 Aes (小写)，不是 AES。
- webhookPath: 不需要手动配置，默认就是 。不要画蛇添足改成 。
默认情况下，OpenClaw 只监听本地回环地址，导致 FRP 客户端（即使在同一台机器）可能因识别问题无法连接。
修改绑定为 LAN
验证状态
运行以下命令：
确保输出中包含 或类似表示已监听外部接口的信息，而不是 。
假设你有一台公网服务器（服务端）和本地 Mac（客户端）。
1. 公网服务器端 (frps.toml)
启动服务端：
2. openclaw 本地 Mac 客户端 (frpc.toml)
启动客户端：
验证：看到 字样即代表穿透成功。此时，你的公网访问地址为：
- 登录 企业微信管理后台。
- 进入 应用管理 -> 自建应用（或从“接收消息”进入）。
- 找到 API接收消息 部分，点击“设置 API 接收”。
填写参数：
- URL:
- 排错提示：如果是 HTTPS 且有证书问题，可能导致握手失败，建议先用 HTTP + 明文模式调通。
- Token: 填入你配置文件中的 Token。
- EncodingAESKey: 填入你配置文件中的 Key（43位）。
验证过程：
点击“保存”时，企业微信会发送一个 GET 请求到你的 URL 进行验证。
- 如果提示 “请求成功”：恭喜你，通了！🎉
- 如果提示 “echostr校验失败”：检查 Token/Key 是否完全一致，或者先在后台将“消息加解密方式”改为“明文模式”尝试。
Q: 访问 URL 返回 502 Bad Gateway? A: FRP 隧道未打通，或者 OpenClaw 网关未启动。检查 日志和 。
Q: 访问 URL 返回 Internal Server Error? A: 这是正常的！直接浏览器访问 是 GET 请求，且缺少微信签名参数，OpenClaw 会报错。只要不是 404 或 Connection Refused，说明服务是通的。请去企业微信后台点击“保存”进行真实测试。
Q: 只有 能通， 不通？ A: 官方插件默认注册路径就是 ，不要加前缀。
Q: FRP 连不上本地 OpenClaw (Connection refused)? A: 再次检查第三步，确保 设置为了 。
后记：配置过程虽然繁琐，但只要每一步都核对清楚配置结构和参数命名，还是非常顺利的。希望这份指南能帮你节省那 7 个小时！
发布者：Ai探索者，转载请注明出处：https://javaforall.net/255690.html原文链接：https://javaforall.net
