Issue Station
Sign In
Tools hereToolbox

hermes - ✅(Solved) Fix Weixin iLink CHANNEL_VERSION outdated (2.2.0 → 2.4.3) — missing mobile "+" button and notifyStart/notifyStop [2 pull requests, 1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
NousResearch/hermes-agent#24989•Fetched 2026-05-14 03:49:55
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Author
canvascn00-cryptocanvascn00-crypto
Participants
canvascn00-cryptocanvascn00-crypto
Timeline (top)
labeled ×3cross-referenced ×2

The Weixin (WeChat) adapter uses iLink protocol version 2.2.0, while the official @tencent-weixin/openclaw-weixin package (v2.4.3) uses 2.4.3. This version gap may cause missing features on the WeChat mobile client, notably the "+" button for attaching files/images.

Root Cause

The Weixin (WeChat) adapter uses iLink protocol version 2.2.0, while the official @tencent-weixin/openclaw-weixin package (v2.4.3) uses 2.4.3. This version gap may cause missing features on the WeChat mobile client, notably the "+" button for attaching files/images.

Fix Action

Fixed

PR fix notes

PR #24995: fix(weixin): update iLink protocol version to 2.4.3 and add notifyStart/notifyStop

Description (problem / solution / changelog)

Summary

Update the Weixin iLink protocol constants to match @tencent-weixin/openclaw-weixin v2.4.3 and implement notifyStart/notifyStop lifecycle endpoints.

Root Cause

Hermes uses iLink protocol version 2.2.0 while the official OpenClaw package uses 2.4.3. This version gap causes the iLink server to potentially gate features — notably the mobile "+" button for attaching files/images only appears when entering the bot conversation via notification popup, not from the conversation list.

Fix

1 file changed, +33/-3 lines (gateway/platforms/weixin.py):

  1. Version constants: CHANNEL_VERSION 2.2.0 → 2.4.3, ILINK_APP_CLIENT_VERSION updated to match
  2. base_info payload: Added bot_agent field (empty string) per OpenClaw spec
  3. notifyStart: Called on connect() after session creation — non-fatal on failure
  4. notifyStop: Called on disconnect() before session teardown — non-fatal on failure

Both lifecycle calls use the existing _api_post helper with API_TIMEOUT_MS and are wrapped in try/except to prevent adapter startup/shutdown failures.

Testing

  • All 54 existing tests/gateway/test_weixin.py tests pass
  • Module imports cleanly
  • notifyStart/notifyStop failures are non-fatal (logged at DEBUG level)

References

  • Fixes #24989
  • OpenClaw source: @tencent-weixin/openclaw-weixin v2.4.3 packages/channel/src/weixin/constants.ts

Changed files

  • gateway/platforms/weixin.py (modified, +33/-3)

PR #25004: fix(weixin): update iLink protocol handshake

Description (problem / solution / changelog)

Summary

  • Update Weixin iLink protocol version/client header to 2.4.3
  • Include bot_agent in base_info for iLink requests
  • Add best-effort notifyStart/notifyStop lifecycle calls around the poll loop
  • Add protocol and lifecycle tests for the Weixin adapter

Test Plan

  • uv run pytest tests/gateway/test_weixin.py -q

Closes #24989

Changed files

  • gateway/platforms/weixin.py (modified, +46/-3)
  • tests/gateway/test_weixin.py (modified, +67/-0)
RAW_BUFFERClick to expand / collapse

Summary

The Weixin (WeChat) adapter uses iLink protocol version 2.2.0, while the official @tencent-weixin/openclaw-weixin package (v2.4.3) uses 2.4.3. This version gap may cause missing features on the WeChat mobile client, notably the "+" button for attaching files/images.

Evidence

Comparing gateway/platforms/weixin.py with @tencent-weixin/openclaw-weixin v2.4.3 (packages/channel/src/weixin/constants.ts):

FieldHermes (current)OpenClaw (2.4.3)
CHANNEL_VERSION"2.2.0""2.4.3"
ILINK_APP_CLIENT_VERSION(2 << 16) | (2 << 8) | 0(2 << 16) | (4 << 8) | 3
base_info{"channel_version": "..."}{"channel_version": "...", "bot_agent": "..."}
notifyStart / notifyStopNot implementedImplemented (ilink/bot/msg/notifystart, ilink/bot/msg/notifystop)

Missing features compared to OpenClaw

  1. notifyStart / notifyStop endpoints — OpenClaw calls ilink/bot/msg/notifystart on startup and ilink/bot/msg/notifystop on shutdown. Hermes does not call either.
  2. bot_agent field in base_info — OpenClaw includes "bot_agent" (string, can be empty) in every request's base_info payload. Hermes only sends {"channel_version": "2.2.0"}.
  3. Protocol version — iLink server may gate features based on channel_version / iLink-App-ClientVersion.

Impact

  • Mobile WeChat users report the "+" button (for attaching images/files) is missing when entering the bot conversation from the conversation list. It only appears when entering via notification popup.
  • This affects user experience significantly since image/file upload is a core feature.

Suggested Fix

  1. Update CHANNEL_VERSION to "2.4.3" and ILINK_APP_CLIENT_VERSION accordingly
  2. Add "bot_agent": "" to _base_info()
  3. Implement notifyStart call in WeixinAdapter.connect() (after session creation, before poll loop)
  4. Implement notifyStop call in WeixinAdapter.disconnect()

Happy to submit a PR if this approach sounds good.

References

  • OpenClaw source: @tencent-weixin/openclaw-weixin v2.4.3
  • Relevant file: gateway/platforms/weixin.py

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#batch processing#GPU compatibility#latency issue#model loading#dependency error

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - ✅(Solved) Fix Weixin iLink CHANNEL_VERSION outdated (2.2.0 → 2.4.3) — missing mobile "+" button and notifyStart/notifyStop [2 pull requests, 1 participants]