What you need

You need	Why
A computer to run the daemon: Linux, macOS (Apple Silicon) or Windows	wx serve runs there and stays connected to WeChat. On Linux, glibc 2.36+ (Debian 12, Ubuntu 24.04 or newer).
WeChat on your phone	You log in by scanning a QR code or approving on the phone.
FFmpeg and FFprobe	Used for voice and video sends and some image previews. The Docker image includes them.
Node 24.16+	Only if you install with npm or pnpm.
Optional: WeChat for Linux data	To keep your existing chat history, agent-wechat can use the data folder of WeChat for Linux. Without it, you start with a new profile.

Docker works too, on Linux or through Docker Desktop on macOS and Windows.

Next: install.

What works

Works	Not yet
Log in with a QR code or phone approval	Joining through invitation links, publishing announcements
Read history, contacts, groups and members	Fetching old history from WeChat’s servers
Receive new messages as they arrive	Sending stickers and files above the 512 MiB limit
Send text, images, files, video, voice and link cards	Using data from WeChat for macOS or Windows
Download images, files, video and voice	Proxy support for outgoing connections
Recall your own messages
Create and edit ordinary groups with an admin token	Automatic delivery of every phone-side group edit
Mark chats read and notify your other devices

Good to know

• History comes from your WeChat data, not the server. WeChat doesn’t resend old chats to a new login, so a new profile only fills up from now on.
• Your data stays in WeChat’s own format. agent-wechat reads and writes the same files WeChat for Linux uses, so it can pick up where that app left off.
• OpenClaw and other clients can run on any machine that can reach the daemon.
• See the capability checklist for what has been tested and how.
• Attachment limits differ by send kind; the larger ordinary-file path has a separate validation status.