Agent skill · software engineering · aradotso
weixin-agent-sdk
Bridge any AI agent backend to WeChat using the weixin-agent-sdk framework with simple Agent interface, login, and message loop.
Why this skill is useful
Provides specific commands and patterns for integrating AI agents with WeChat using the weixin-agent-sdk framework, which the AI wouldn't reliably generate on its own.
What it needs
Requires weixin-agent-sdk installed locally. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
weixin-agent-sdk Skill by ara.so — Daily 2026 Skills collection. weixin-agent-sdk is a TypeScript framework that bridges any AI backend to WeChat (微信) via the Clawbot channel. It uses long-polling to receive messages — no public server required — and exposes a minimal Agent interface so you can plug in OpenAI, Claude, or any custom logic in minutes. --- Installation Node.js >= 22 required. --- Quick Start 1. Login (scan QR code once) 2. Implement the Agent interface --- Core API Agent Interface login() Triggers QR code scan and persists session to ~/.openclaw/. Only needs to run once. start(agent) Starts the message loop. Blocks until process exits. Automatically reconnects on session expiry. --- Common Patterns Multi-turn Conversation with History OpenAI Agent (Full Example) Send Image Response Send File Response --- ACP (Agent Client Protocol) Integration If you have an ACP-compatible agent (Claude Code, Codex, kimi-cli, etc.), use the weixin-acp package — no code needed. weixin-acp launches your agent as a subprocess and communicates via JSON-RPC over stdio. --- Environment Variables (OpenAI Example) Variable Required Description --- --- --- OPENAIAPIKEY Yes OpenAI API key OPENAIBASEURL No Custom API base URL (OpenAI-compatible services) OPENAIMODEL No Model name, default gpt-5.4 SYSTEMPROMPT No System prompt for the assistant --- Built-in Slash Commands Send these in WeChat chat to control the bot: Command Description --- --- /echo <message> Echoes back directly (bypasses Agent), shows channel latency /toggle-debug Toggles debug mode — appends full latency stats to each reply --- Supported Message Types Incoming (WeChat → Agent) Type media.type Notes --- --- --- Text — Plain text in request.text Image image Downloaded & decrypted, filePath = local file Voice audio SILK auto-converted to WAV (requires silk-wasm) Video video Downloaded & decrypted File file Downloaded & decrypted, original filename preserved Quoted message — Quoted text appended to request.text, q …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/weixin-agent-sdk