infiniti-weixin-bridge

Production-oriented Weixin OpenClaw/iLink bridge for infiniti-agent live.

Usage

infiniti-weixin-bridge login
infiniti-agent live --port 8080
infiniti-weixin-bridge start --live-ws ws://127.0.0.1:8080 --bot-name Infiniti,小因

Run infiniti-weixin-bridge start from the same infiniti-agent working directory you use for infiniti-agent live. The bridge automatically watches that directory's .infiniti-agent/inbox and sends generated image/video attachments back to Weixin. Use --agent-cwd <path> only when the bridge must run from a different directory, or --no-watch-inbox to disable media outbox forwarding.

Useful commands:

infiniti-weixin-bridge accounts
infiniti-weixin-bridge status
infiniti-weixin-bridge logout --account <id>

Group chat is enabled in mention-only mode by default. A group message is handled only when the text contains one of the configured @ names, for example @Infiniti 帮我总结一下. Use --group-mode ignore to disable group chats or --group-mode all for trusted groups where every text message should be sent to the agent.

Voice input uses the ASR engine already configured in infiniti-agent live. When Weixin provides voice_item.text, the bridge sends that text directly. Otherwise it downloads the encrypted Weixin voice media, decrypts it, converts SILK to WAV, sends MIC_AUDIO to live, and waits for the normal assistant reply stream.

Image and file input is forwarded to infiniti-agent live as USER_INPUT.data.attachments. The bridge downloads Weixin CDN media, decrypts AES-128-ECB media when aes_key is present, infers a MIME type from Weixin metadata or the file extension, and includes a short generated prompt when the Weixin message contains only media.

Generated media output uses the agent inbox as a lightweight outbox. When infiniti-agent writes unread messages with image/video/file attachments under .infiniti-agent/inbox, the bridge uploads those files through iLink getuploadurl, sends them to the most recent Weixin chat target, and marks the inbox message as read after a successful send.

Credentials are stored under ~/.infiniti-weixin-bridge by default. Tokens and context tokens are treated as secrets and are redacted from logs.

See SPEC.md for the product protocol and development plan.