Skip to content

WeChat ClawBot (iLink) adapter

Connects to WeChat extension / iLink Bot HTTP. This is not the WeChat Official Account adapter (wechat), WeCom (wecom), or WeCom Customer Service (wecom-kf).

vs. Official Account adapter

@onebots/adapter-wechat@onebots/adapter-wechat-clawbot
Use casePublic account webhookiLink HTTP API, QR login, long polling
Configapp_id, token, etc.Mainly account_id; endpoints are conventional
Platform idwechatwechat-clawbot

Quick start

Select WeChat ClawBot in the Web Extensions view or the TUI setup wizard. The manager installs the adapter and its required peers into a new immutable runtime generation, verifies it, and waits for explicit activation:

bash
onebots ui --data-dir /path/to/onebots-data --setup
yaml
wechat-clawbot.my_bot: {}

Capabilities and limits

  • QR login, persistent sessions, automatic re-login, cancellable infinite polling, and exponential backoff.
  • Bidirectional text, image, video, and file messages; lossless voice and unknown-item reception.
  • Composite items retain their original order and every event retains raw_event.
  • send_typing and download_media are available through callAction.
  • Replies require a valid context_token; iLink does not expose contacts, groups, message recall, or history APIs.

Full details: see the adapter README in the monorepo.