📋 OpenClaw微信插件安装问题总结

🔍 问题现象

运行 openclaw channels login --channel openclaw-weixin 时持续报错：

Failed to start login: TypeError: fetch failed

🧐 排查过程

1. 网络连通性正常 - curl https://ilinkai.weixin.qq.com 可以成功建立 TLS 连接
2. 插件安装正确 - 插件文件已正确安装到 ~/.openclaw/extensions/openclaw-weixin/
3. 配置正确 - plugins.allow 和 plugins.entries.openclaw-weixin 已正确配置
4. Node.js 版本 - v23.11.0（较新版本）

✅ 根本原因

TLS 证书验证失败 - Node.js 原生 fetch 在验证微信 API 服务器的 SSL 证书时失败，可能是：

• Node.js 23.x 的 TLS 验证更严格
• 微信 API 服务器证书与 Node.js 23 的验证不兼容
• 本地网络环境导致证书链验证问题

🛠️ 解决方案

# 临时方案（当前终端会话）
export NODE_TLS_REJECT_UNAUTHORIZED=0
openclaw channels login --channel openclaw-weixin

# 永久方案（添加到 ~/.zshrc）
echo 'export NODE_TLS_REJECT_UNAUTHORIZED=0' >> ~/.zshrc
source ~/.zshrc

📝 后续步骤

1. 登录微信 - 运行上述命令后扫码登录
2. 验证插件 - 运行 openclaw channels status 确认微信渠道在线
3. 可选 - 如果担心安全问题，可以：
   • 仅在有 .openclaw 目录的终端设置此环境变量
   • 或等待微信插件/Node.js 更新修复兼容性问题

⚠️ 安全提示

NODE_TLS_REJECT_UNAUTHORIZED=0 会禁用 TLS 证书验证，仅建议在可信网络环境下使用。生产环境建议：

• 使用 Node.js LTS 版本（22.x）
• 或等待插件更新使用兼容的 TLS 配置

现在可以运行以下命令完成微信登录：

export NODE_TLS_REJECT_UNAUTHORIZED=0
openclaw channels login --channel openclaw-weixin

扫码后机器人就上线了！🤖