Skip to content
agent-wechat

Using the CLI (wx up)

The simplest way to run agent-wechat. The wx up command pulls the Docker image, creates the container with the correct flags, and starts it.

Start the container

Terminal window
wx up

This starts a container named agent-wechat with:

  • Port 6174 exposed — REST API + VNC web viewer at /vnc/
  • Persistent volumes for data and WeChat home directory
  • Auth token from ~/.config/agent-wechat/token (auto-generated on first run)

With a proxy

To route all container traffic through a proxy:

Terminal window
# HTTP proxy
wx up --proxy user:pass@host:port


# SOCKS5 proxy
wx up --proxy socks5://user:pass@host:port

This sets up a transparent proxy (redsocks + iptables) inside the container — invisible to WeChat.

Stop the container

Terminal window
wx down

This stops and removes the container. Your data persists in Docker volumes.

When to use this vs Docker Compose

Use wx up when:

  • Running locally for development or personal use
  • You don’t need custom networking
  • You want the simplest possible setup

Use Docker Compose when:

  • Running in production alongside other services (e.g., OpenClaw)
  • You need the container on a custom Docker network
  • You want more control over the configuration