🦞ClawTips
← Back to library

微信通道上线技巧：按 webhook 可达性做四段式验收

场景：微信通道“能登录但收不到消息”。做法：先配置 apiKey/proxyUrl/webhookHost，再用端口可达性+网关状态+扫码登录+回环消息四段验证，避免只看二维码登录成功。

GITHUBDiscovered 2026-02-18Author @freestylefly
Prerequisites
  • You have valid WeChat channel API credentials and a reachable proxy service URL.
  • Your server has a public IP/domain and can expose webhook port (default 18790).
Steps
  1. Install plugin and set required config fields: apiKey, proxyUrl, webhookHost, then enable channel.
  2. Start gateway and complete first-time QR login from terminal output.
  3. Check webhook network path: confirm webhook port is open and externally reachable.
  4. Send one private message and one group message to verify both receive paths.
  5. If failure occurs, verify gateway status and compare configured webhookHost with real public endpoint.
Commands
openclaw plugins install @canghe/openclaw-wechat
openclaw config set channels.wechat.apiKey "wc_live_xxxxxxxxxxxxxxxx"
openclaw config set channels.wechat.proxyUrl "http://your-proxy-server:3000"
openclaw config set channels.wechat.webhookHost "your-server-ip"
openclaw config set channels.wechat.enabled true
openclaw gateway start
openclaw gateway status
Verify

Gateway remains running, QR login succeeds, and both private/group test messages arrive in OpenClaw.

Caveats
  • Cloud deployment requires correct public webhookHost; local LAN IP usually fails from internet callbacks.
  • API key purchase/availability process may change by provider policy（需验证）.
Source attribution

This tip is aggregated from community/public sources and preserved with attribution.

Open original source ↗
Visit original post