← Back to Skills Marketplace
johnsonxuan

Weixin Runtime Fix

by johnsonxuan · GitHub ↗ · v2.4.2 · MIT-0
cross-platform ✓ Security Clean
30
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install weixin-runtime-fix
Description
修复 @tencent-weixin/[email protected] 在 OpenClaw 2026.5.4+ 上的两个关键 bug: 1. Runtime 模块隔离导致 waitForWeixinRuntime 超时 2. undici 8.2.0 拒绝手动设置的 Content-Length 头...
README (SKILL.md)

openclaw-weixin-fix

修复 @tencent-weixin/[email protected] 在 OpenClaw 2026.5.4+ 上的关键 bug。

问题

  1. Runtime 模块隔离runtime.ts 被加载两次,waitForWeixinRuntime() 读取的实例与 setWeixinRuntime() 写入的实例不同,导致超时
  2. Content-Length 拒绝:undici 8.2.0 不允许手动设置 Content-Length

修复内容

改动1:channel.js — 传递 channelRuntime

  return monitorWeixinProvider({
      ...
      setStatus: ctx.setStatus,
+     channelRuntime: ctx.channelRuntime,
  });

改动2:monitor.js — 优先使用传入的 channelRuntime

  let channelRuntime;
- try {
-     const pluginRuntime = await waitForWeixinRuntime();
-     channelRuntime = pluginRuntime.channel;
- }
+ if (opts.channelRuntime) {
+     channelRuntime = opts.channelRuntime;
+ } else {
+     try {
+         const pluginRuntime = await waitForWeixinRuntime();
+         channelRuntime = pluginRuntime.channel;
+     }
+     catch (err) { ... }
+ }

改动3:api.js — 删除 Content-Length 头

删除 buildHeaders() 中手动设置 Content-Length 的代码。

验证结果

  • ✅ 微信消息接收正常
  • ✅ 微信回复发送成功
  • ✅ 文件上传正常
  • openclaw health --json 显示 lastError: null

注意事项

  • 每次 openclaw plugins install 重装插件后,需要重新运行此修复
  • 备份文件:channel.js.bakmonitor.js.bak

相关链接

Usage Guidance
Install only if you use the affected @tencent-weixin/openclaw-weixin version and want to patch it locally. Review install.sh, confirm the target files are correct, preserve the .bak backups, and be prepared to reinstall or restore the plugin if the patch does not work.
Capability Analysis
Type: OpenClaw Skill Name: weixin-runtime-fix Version: 2.4.2 The skill is a specialized patch designed to fix compatibility issues between the OpenClaw gateway and the WeChat plugin. It uses an installation script (install.sh) to modify local JavaScript files within the plugin's directory, specifically addressing module isolation and HTTP header restrictions. The operations are transparent, include file backups, and are strictly scoped to the plugin's path (~/.openclaw/npm/node_modules/@tencent-weixin/openclaw-weixin) as defined in SKILL.md.
Capability Assessment
Purpose & Capability
The stated purpose and included script align: the skill patches @tencent-weixin/openclaw-weixin files to fix runtime and Content-Length issues. The capability is sensitive because it changes installed OpenClaw plugin code.
Instruction Scope
The SKILL.md and README describe the intended file changes, backup behavior, and affected plugin path. No hidden network calls, credential use, or unrelated tasks are shown.
Install Mechanism
There is no declarative install spec, but README instructs users to run bash install.sh. The script uses local shell, sed, and python3 to patch files, so users should review and run it intentionally.
Credentials
Requested write access is limited to ~/.openclaw/npm/node_modules/@tencent-weixin/openclaw-weixin/**, matching the repair purpose. This is still a persistent change to the local OpenClaw runtime environment.
Persistence & Privilege
The patch persists until restored, overwritten, or the plugin is reinstalled. The artifacts disclose .bak backups and do not show background processes, credential access, or autonomous persistence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install weixin-runtime-fix
  3. After installation, invoke the skill by name or use /weixin-runtime-fix
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.4.2
- Fixes two major bugs affecting @tencent-weixin/[email protected] on OpenClaw 2026.5.4+: - Resolves runtime module isolation causing waitForWeixinRuntime timeout. - Removes manual Content-Length header that undici 8.2.0 rejects. - Ensures Weixin channel can send and receive messages normally. - Simple installation: patches plugin files directly and backs up originals with .bak extension. - No additional configuration required.
Metadata
Slug weixin-runtime-fix
Version 2.4.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Weixin Runtime Fix?

修复 @tencent-weixin/[email protected] 在 OpenClaw 2026.5.4+ 上的两个关键 bug: 1. Runtime 模块隔离导致 waitForWeixinRuntime 超时 2. undici 8.2.0 拒绝手动设置的 Content-Length 头... It is an AI Agent Skill for Claude Code / OpenClaw, with 30 downloads so far.

How do I install Weixin Runtime Fix?

Run "/install weixin-runtime-fix" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Weixin Runtime Fix free?

Yes, Weixin Runtime Fix is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Weixin Runtime Fix support?

Weixin Runtime Fix is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Weixin Runtime Fix?

It is built and maintained by johnsonxuan (@johnsonxuan); the current version is v2.4.2.

💬 Comments