Skip to content

README_EN.md

Latest commit

 

History

History
85 lines (68 loc) · 3.39 KB

README_EN.md

File metadata and controls

85 lines (68 loc) · 3.39 KB

wxbot-skill

Cross-platform WeChat Desktop Automation Skill (Gemini / Claude / Antigravity / OpenClaw)
Pixel-level Layout Analysis · Human-like Interaction · Privacy-focused Local Data

Release License Stars

English · 中文

v0.2-beta New Features

  • Structural Layout Detection — Dynamically detects WeChat window boundaries, precisely identifying sidebars, message flows, and input fields.
  • Human-like Interaction — Uses Quartz-level events for character typing and rhythmic "Burst Typing" to simulate natural human input pace.
  • Enhanced Group Support — Automatic parsing of quotes, avatar-based sender identification, and multi-modal message (image/sticker) classification.
  • Navigation 2.0 — Restored section-header based search (Contacts/Groups) for precise target selection among duplicate names.
  • One-click Adaptation — Standardized adapter system for one-click installation into Gemini, Claude, Antigravity, OpenClaw, and more.

Supported Platforms

Platform Setup Command Recommended Model
Gemini CLI ./install.sh --platform gemini Gemini 1.5 Pro/Flash
Claude Code ./install.sh --platform claude Claude 3.5 Sonnet
Antigravity ./install.sh --platform antigravity Any SOTA LLM
OpenClaw ./install.sh --platform openclaw GPT-4o / Claude 3.5
Codex CLI ./install.sh --platform codex -
Cursor ./install.sh --platform cursor -

Requirements

  • macOS 13+ (Vision Framework, AppleScript)
  • Python 3.10+
  • WeChat Mac desktop app

macOS Permissions

Grant these in System Settings → Privacy & Security:

  • Accessibility — Your Terminal / IDE (for key/mouse control)
  • Screen Recording — Your Terminal / IDE (for OCR screenshots)

Quick Start

  1. Clone and Install

    git clone https://github.com/ScottSiu1983/wxbot-skill.git
cd wxbot-skill
pip install -r requirements.txt

  2. One-click Installation

    ./install.sh  # Interactive mode

  3. Run Tell your AI Agent:

    • "List my WeChat chats"
    • "Read messages from Project Team and suggest a reply"

Project Structure

wxbot-skill/
├── skills/wxbot-skill/       ← Core skill directory
│   ├── SKILL.md              ← Platform-agnostic skill definition
│   ├── scripts/              ← Implementation scripts (wechat.py, etc.)
│   └── config.json           ← Automation settings
├── adapters/                 ← Cross-platform adapter generator
├── install.sh                ← Integrated installation tool
└── RELEASE_NOTES.md          ← [NEW] Detailed v0.2-beta logs

License

Apache-2.0