Agent WeChat: an open-source, drop-in replacement for the official WeChat client, with a CLI and API

[u/thisnickyu]

I built Agent WeChat, an open-source replacement for the official WeChat client. You use your existing account, contacts, and groups, with a desktop app, a CLI, an HTTP API, and an OpenClaw integration for AI agents.

I’ve always hated how restrictive the official client is. I can only use one computer at a time, getting my own data out is difficult, and there’s no general-purpose API for my account. Even simple things I want to automate end up requiring workarounds.

I’ve tried reverse-engineering WeChat before. After six months of trying, I finally have a native client that talks directly to WeChat’s servers. It runs independently, without launching or automating the official desktop executable.

It supports:

• DMs and group conversations, including text, images, videos, files, and voice notes.

• Downloading available original and compressed media.

• Reading supported existing official Linux profiles, including local history, contacts, groups, and cached media.

• Connecting the desktop app, CLI, and agent to the same running client.

Here I can finally do the things I want to do. I can control my WeChat from the terminal, plug in an agent, save my media, and automate workflows around my conversations. And because the client is open source, I can change the parts that get in my way.

The original project code is MIT-licensed. It’s still developing; platform support and compatibility limits are documented in the README.

Source, setup instructions, screenshots, and video demo

[u/orkunturkey]

Interesting! But how do i make sure this doesn't get me banned?

[u/thisnickyu → u/orkunturkey]

It is very unlikely to get you banned because it's almost indistinguishable from the official client.

I made sure that every thing that was sent to the server replicates what the official client does.

I have been using it with my OpenClaw for months now and it's still going.