WeiClaw

<p align="center"> <img src="docs/banner.png" alt="weiclaw" /> </p> <h1 align="center">weiclaw</h1> <p align="center"> <a href="https://www.npmjs.com/package/weiclaw"><img src="https://img.shields.io/npm/v/weiclaw?style=flat-square&color=cb3837" alt="npm" /></a> <a href="https://github.com/kellyvv/weiclaw"><img src="https://img.shields.io/github/stars/kellyvv/weiclaw?style=flat-square&color=yellow" alt="stars" /></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/kellyvv/weiclaw?style=flat-square" alt="license" /></a> <a href="https://github.com/kellyvv/weiclaw"><img src="https://img.shields.io/badge/node-%3E%3D22-brightgreen?style=flat-square" alt="node" /></a> </p> <p align="center"> <a href="#快速开始">快速开始</a> · <a href="#全模态支持矩阵">全模态</a> · <a href="#多媒体协议">多媒体协议</a> · <a href="#多-agent-模式">多 Agent</a> · <a href="#主动发送-api">主动发送</a> · <a href="#接入自己的-agent">自定义 Agent</a> </p> <p align="center"> 中文 | <a href="README.en.md">English</a> </p>

⭐ 如果这个项目对你有帮助，请给个 Star！

全网首个支持微信与任何 AI Agent 全模态双向通信的开源项目 —— 文本、图片、语音、视频、文件，发送和接收全覆盖。

<p align="center"> <img src="docs/wechat-image-send.png" width="250" alt="Agent 发送文件、图片、语音" /> <img src="docs/wechat-image-receive.png" width="250" alt="Agent 发送图片、视频、语音" /> <a href="https://github.com/kellyvv/weiclaw/raw/main/docs/wechat-voice-demo.mp4"> <img src="docs/wechat-voice-demo.gif" width="250" alt="语音演示（点击播放有声版）" /> </a> </p>

特性

• 🔌 零依赖接入 — npx 一条命令，无需 clone、无需配置
• 🧠 Agent 无关 — 支持任何 OpenAI 兼容 API（Codex / Gemini / Gemini / OpenCode / 自建）
• 📡 全模态 — 文本、图片、语音、视频、文件，双向全覆盖
• 🤖 多 Agent — 同时接入多个 Agent，@ 路由切换
• ⌨️ 打字指示器 — Agent 思考时显示"对方正在输入"
• 📤 主动发送 API — Agent 可推送多条消息，模拟真人打字节奏

全模态支持矩阵

模态	微信 → Agent	Agent → 微信
📝 文本	✅	✅
📷 图片	✅ 自动识别	✅ HD 原图
🎤 语音	✅ 语音转文字	✅ 语音气泡
🎬 视频	✅ 自动接收	✅ 带缩略图
📄 文件	✅ 提取内容	✅ 可下载
💬 引用消息	✅ 自动提取引用媒体	—

已支持的 Agent / 工具

| Agent | 接入方式 | 安装 | |----