zlab-weixin-bridge

WeChat bot bridge for pi — QR login, message polling, auto-reply via WeChat ilink API

Package details

extension

Install zlab-weixin-bridge from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:zlab-weixin-bridge

Pi manifest JSON

{
  "extensions": [
    "./weixin-bridge.ts"
  ],
  "image": "https://img.shields.io/badge/pi-weixin--bridge-green",
  "video": ""
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

WeChat bot bridge for pi — QR login, message polling, and auto-reply via the WeChat ilink API.

✅ QR code login — scan with your phone, no password
✅ Message polling — receive WeChat messages in real-time
✅ Auto-reply — pi auto-replies to WeChat messages through the normal conversation flow
✅ Active push — send WeChat messages proactively via tools
✅ Contact persistence — auto-save contacts who message you
✅ Session continuity — context tokens preserved across restarts
✅ Token caching — no need to re-scan every time

pi install npm:zlab-weixin-bridge

Or test without installing:

pi -e npm:zlab-weixin-bridge

Run the login command in pi:

/weixin-login

If it's the first time, you'll get a URL. Open it in your browser, scan the QR code with your phone's WeChat, and confirm.

On subsequent runs, cached tokens are reused automatically — no re-scan needed.

The LLM can use the weixin_send tool to push messages to anyone who has messaged the bot:

to: "xxx@im.wechat" (user ID, obtained automatically when they message you)

Command / Tool	Description
`weixin_contacts`	List all known contacts and their IDs
`weixin_alias`	Set a nickname for a contact
`weixin_status`	Check connection status

Tool	Description
`weixin_login`	QR code login (or cached token recovery)
`weixin_send`	Send text message to a WeChat user
`weixin_status`	Check connection status
`weixin_contacts`	List known contacts
`weixin_alias`	Set alias for a contact

Command	Description
`/weixin-login`	Login or recover session
`/weixin-status`	Quick status check

MIT