openclaw - 💡(How to fix) Fix [@tencent-weixin/openclaw-weixin] waitForWeixinRuntime() timeout in channel worker (v2.4.1, OpenClaw 2026.5.6) [1 comments, 2 participants]

Environment

• OpenClaw version: 2026.5.6
• Plugin version: @tencent-weixin/openclaw-weixin 2.4.1 (latest)
• Installation method: openclaw plugins install "@tencent-weixin/openclaw-weixin"
• OS: Windows/WSL (Linux environment)
• Node.js: via openclaw npm package

Problem Summary

The WeChat channel enters a crash loop: every ~10 seconds the channel worker restarts with a "Weixin runtime initialization timeout" error. The channel shows ON·OK in openclaw status but is never actually functional.

Exact Error

waitForWeixinRuntime() failed: Error: Weixin runtime initialization timeout after 10000ms

notifyStart failed during startup (ignored): TypeError: fetch failed
  cause:
    ConnectTimeoutError: Connection timed out connecting to ilinkai.weixin.qq.com

Reproduction Steps

1. openclaw channels enable openclaw-weixin
2. openclaw channels login --channel openclaw-weixin (QR scan, successful)
3. systemctl --user restart openclaw-gateway
4. After ~10 seconds: channel worker crashes and restarts in a loop

Root Cause Analysis

Confirmed through code inspection:

monitor.js calls waitForWeixinRuntime() which polls for a module-level global variable pluginRuntime. This variable is set only once — when the plugin calls setWeixinRuntime(api.runtime) during register() in the gateway main process.

However, startAccount() (which calls monitorWeixinProvider) runs in a separate channel worker process with a different module context. The worker's module-level pluginRuntime is always null, so waitForWeixinRuntime() always times out after 10 seconds.

The opts.runtime passed to startAccount is of type RuntimeEnv (from ChannelPluginContext), which does not contain channelRuntime. Attempting to access opts.runtime?.channelRuntime returns undefined.

Attempted Fix

Tried patching monitor.js to use opts.runtime?.channelRuntime as a fallback:

This did not work because opts.runtime (type RuntimeEnv) does not have a channelRuntime property.

Expected Behavior

The WeChat channel should initialize successfully and receive incoming messages without timing out.

Additional Context

• The WeChat account is already logged in (credentials saved in ~/.openclaw/openclaw-weixin/accounts/)
• Network access to ilinkai.weixin.qq.com times out from this environment — this may be a separate issue, but the runtime timeout occurs even when the network issue is bypassed
• Other channels (Feishu, etc.) work fine with the same OpenClaw installation
• Plugin version 2.3.1 exhibits the same issue
• No newer version available (npm view @tencent-weixin/openclaw-weixin dist-tags shows latest: 2.4.1)