Skip to content

[Bug] ZCode WeChat connector fails with "Please upgrade WeChat interface version in OpenClaw" on latest WeChat release #816

Open

Description

@romangalaxys10-spec

Summary & Impact

When attempting to connect or bind ZCode with WeChat, the WeChat integration gateway blocks connection and displays an error dialog:

"Please upgrade WeChat interface version in OpenClaw"

The client encountered this error directly while attempting to establish the WeChat connection via ZCode. This occurs even when running the latest version of the WeChat app, preventing users from completing the WeChat agent pairing and communication workflow in ZCode.


Screenshot & Verification

  • Error Dialog Displayed: Please upgrade WeChat interface version in OpenClaw (with a single "Done" action button).
  • Client / User Flow: Client initiated WeChat connection through ZCode and received this blocking error.
  • Independent Verification: Roman (Ambassador / Mod) independently tested and verified reproduction of the exact same error via ZCode on the latest official WeChat app build.
  • Client / User: Min [Z.ai]
  • Discord Report Thread: https://discord.com/channels/1346756824233148527/1552954009512321035

Analysis & Root Cause

  1. WeChat Protocol / Interface Version Bump: The latest update to the WeChat mobile/desktop application expects a newer interface API/protocol version from third-party connectors.
  2. OpenClaw Interface Outdated in ZCode: The OpenClaw integration layer utilized by ZCode has not yet been bumped to match the latest WeChat interface specifications, causing WeChat to reject the binding handshake with the error message shown.

Proposed Resolution

  • Update the OpenClaw WeChat interface bridge in ZCode/gateway to the latest protocol version required by modern WeChat builds.
  • Ensure backwards/forward compatibility with recent WeChat app updates.

Reported on behalf of the community by Roman M. (Volunteer / Ambassador).

Activity

  1. github-actions commented on Sep 25, 2026

    @github-actions

    👋 感谢你的反馈,我们已经收到。

    • 维护者看到后会尽快回复你。
    • 状态保持为 status: 待评估,你可以随时补充信息。
    • 信息不全时我们会打上 needs: 更多信息 标签并 @ 你。

    👋 Thanks — we've received your issue.

    • A maintainer will get back to you as soon as we can.
    • Status stays at status: 待评估 (Triage); feel free to add context.
    • If we need more details, we'll add needs: 更多信息 and ping you.
  2. changed the title [-][Bug] ZCode WeChat connector fails with "Please upgrade WeChat interface version in OpenClaw" on latest client release[/-] [+][Bug] WeChat connector fails with "Please upgrade WeChat interface version in OpenClaw" on latest WeChat release[/+] on Sep 25, 2026
  3. changed the title [-][Bug] WeChat connector fails with "Please upgrade WeChat interface version in OpenClaw" on latest WeChat release[/-] [+][Bug] ZCode WeChat connector fails with "Please upgrade WeChat interface version in OpenClaw" on latest WeChat release[/+] on Sep 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions