Skip to content
A WeChat chat where an agent replies from the owner's account with a requested file

agent-wechat

Run your WeChat account on a server, without the WeChat app. Read chats and send messages and files from the command line, let an OpenClaw agent reply for you, or build your own integration on the HTTP API.
wx CLI OpenClaw Other agents and apps wx serve WeChat servers Your WeChat profile

wx serve talks to WeChat directly; no WeChat app or desktop runs. It stores everything in WeChat’s own data format, and can pick up an existing WeChat for Linux profile with its history. Every client goes through its HTTP API: the wx CLI, the OpenClaw plugin, and anything you build. A native desktop app is on the way.

Terminal window
npm install -g --allow-scripts=@agent-wechat/cli @agent-wechat/cli
wx serve # terminal 1
wx accounts create --alias me # terminal 2
wx auth login # scan the QR with WeChat on your phone
wx chats list

Set it up

Install, log in, run it in the background, or move from the old container. What you need →

Use it

From the CLI, as an OpenClaw channel, or from your own agent or app. CLI recipes →

See how it works

The daemon, the message flow, sends and where your data lives. Architecture →