Skip to content
agent-wechat

OpenClaw Local Setup

When running OpenClaw and agent-wechat on the same machine (not in containers), the setup is straightforward — everything communicates over localhost.

Setup

1. Start agent-wechat

Terminal window
npm install -g @agent-wechat/cli
wx up

2. Install and configure the plugin

Terminal window
openclaw plugins install @agent-wechat/wechat
openclaw channels add --channel wechat

No additional configuration is needed — the defaults (http://localhost:6174 and the shared token file) work automatically.

3. Start OpenClaw

Terminal window
openclaw gateway start

4. Log in

Ask your bot to log in, or use the CLI:

Terminal window
openclaw channels login --channel wechat

How it works locally

  • The agent-wechat container exposes port 6174 on localhost
  • The token file at ~/.config/agent-wechat/token is shared between the CLI, the container, and OpenClaw
  • No Docker networking configuration is required

When to use container setup instead

Use the Container Setup when:

  • OpenClaw itself runs in a Docker container
  • You need both services on the same Docker network
  • You’re deploying to a server