wechat-cli

Automate WeChat iLink bot login, token retrieval, and message delivery via CLI.

23|8|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/systemxlabs/wechat-cli --skill wechat-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wechat-cli
Source: https://github.com/systemxlabs/wechat-cli/tree/main
Command: npx skills add https://github.com/systemxlabs/wechat-cli --skill wechat-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the need to interact with a WeChat iLink bot by handling authentication (QR login), credential storage, token retrieval, and message sending without building custom integrations.

Core Features & Use Cases

  • Non-interactive QR login for agents: Request a QR code and poll its status until the bot credentials are confirmed.
  • Account management: Save multiple accounts locally and switch between them using indexes.
  • Context-token retrieval: Wait for the next inbound message and extract the required context_token for downstream sends.
  • Send text, images, and files: Send messages to a bound WeChat user using either saved accounts or explicit credentials.

Quick Start

Ask the assistant to log in and send a message to your saved account by running: wechat-cli get-context-token --account <index> && wechat-cli send --account <index> --context-token <token> --text "hello"

Frequently Asked Questions about wechat-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate WeChat bot login and message sending?

Automating WeChat bot login and message sending requires QR code retrieval, polling for authentication confirmation, and using a context token for delivery. This process handles credential storage and token acquisition without custom integrations.

What is a context token and why do I need it to send WeChat messages?

A context token is a mandatory credential extracted from an inbound message required to send text or media. You retrieve it by waiting for the next inbound message, providing the authorization needed for downstream delivery.

Can I manage multiple WeChat bot accounts locally?

You can manage multiple WeChat bot accounts locally by saving them with specific indexes. This allows you to switch between different accounts and send messages using either stored or explicit credentials.

How do I send images and files to a bound WeChat user?

To send images and files to a bound WeChat user, you use CLI commands with a valid context token and account credentials. The operation supports text, image, and file delivery to a fixed bound user ID.

Does WeChat message automation work without interactive QR code scanning?

WeChat message automation supports non-interactive QR login for agents by requesting a QR code and polling its status until credentials are confirmed. This enables automated workflows without manual intervention.

What is required to configure WeChat bot CLI modes for saved accounts?

Configuring WeChat bot CLI modes requires YAML-defined discovery metadata and validated command structures. It distinguishes between saved accounts and explicit credentials, applying a mandatory context token for send operations.