WeClawBot-ex is a standalone WeChat gateway that enables you to control Claude Code and Codex through direct WeChat messages.

Key Features

Simple Setup & Usage

  • Scan QR code with WeChat to link your account
  • Start chatting directly in WeChat
  • Claude Code replies in the same conversation
  • Pure Node.js implementation, no OpenClaw runtime dependency

Technical Highlights

  • Reuses the readable WeChat protocol layer
  • Per-user persistent sessions across restarts
  • Multi-turn conversation support
  • Echo adapter for protocol-only testing
  • Node.js >= 22 required

Quick Start

git clone git@github.com:ImGoodBai/WeClawBot-ex.git
cd WeClawBot-ex
npm install

# Login and scan QR in WeChat
npm run login

# Start the gateway
npm run start -- --cwd /absolute/path/to/your/project

Then just send a text message in WeChat, and Claude Code will respond!

Why WeClawBot-ex?

This project extends OpenClaw’s original WeChat ClawBot to support Claude Code & Codex backends, providing a more flexible development experience without requiring the full OpenClaw runtime.

Perfect for developers who want to leverage AI coding assistants directly through WeChat on mobile devices.

Current Status

  • ✅ Claude Code backend implemented and verified
  • ✅ Echo adapter for testing
  • 🚧 Codex backend (in progress)
  • 🚧 Group chat support (planned)
  • 🚧 Media message support (planned)

Check out the repository for more details and contribute!