wechat-ai

微信 AI 机器人 — 一条命令连接微信与任意 AI 模型。

基于微信官方 iLink Bot API 构建，合规、稳定、不怕封号。

特性

• 一条命令启动 — npx wechat-ai，扫码即用，零配置门槛
• 8+ 内置模型 — Claude、GPT、Gemini、Qwen、DeepSeek、MiniMax、GLM，一键切换
• 300+ 第三方模型 — 通过 OpenRouter 接入，/model vendor/model 随时切换
• 微信官方协议 — 基于 iLink Bot API（ilinkai.weixin.qq.com），非逆向、非第三方
• 全模型 Agent 能力 — 不只是聊天，所有模型均支持搜索网页、读写文件、执行代码（由 claw-agent-sdk 驱动）
• 语音收发 — 语音消息自动转文字 (Whisper ASR)，支持语音回复 (TTS)
• 图片生成 — /画 <描述> 直接在微信里生图
• 图片理解 — 发图片自动切换到视觉模型分析
• MCP 工具扩展 — 通过 Model Context Protocol 接入任意外部工具
• Function Calling — 所有模型均支持工具调用
• 中间件系统 — Koa 风格洋葱模型，方便二次开发
• Skills 人设系统 — 预设翻译官、程序员、写手等角色，一键切换
• Webhook API — HTTP 接口主动推送消息，方便集成外部系统
• 后台运行 — Daemon 模式，支持开机自启
• 可编程 API — 同时作为 npm 库导出，支持嵌入你自己的项目

快速开始

1. 安装

npm i -g wechat-ai

2. 设置 API Key（任选一个模型）

# macOS / Linux
wechat-ai set qwen sk-xxx        # 通义千问
wechat-ai set deepseek sk-xxx    # DeepSeek
wechat-ai set gemini AIza-xxx    # Gemini

# Windows（Key 需要加引号，避免特殊字符被 cmd 解析）
wechat-ai set qwen "sk-xxx"
wechat-ai set deepseek "sk-xxx"

3. 启动

wechat-ai                        # 首次启动会弹出微信扫码

扫码登录后，给微信机器人发消息即可开始对话。

其他安装方式

# 免安装体验
npx wechat-ai

# 从源码运行
git clone https://github.com/anxiong2025/wechat-ai.git
cd wechat-ai && npm install && npm run build && node dist/cli.js

命令

wechat-ai                        # 启动（首次自动弹出二维码）
wechat-ai set <模型> <key>        # 保存 API Key
wechat-ai use <模型>              # 设置默认模型
wechat-ai config                 # 查看配置（Key 已脱敏）
wechat-ai start                  # 后台运行（daemon 模式）
wechat-ai stop                   # 停止后台进程
wechat-ai logs                   # 查看后台日志
wechat-ai update                 # 更新到最新版

支持模型

| 模型 | 默认版本 | 设置 Key | 获取 Key | |------|---------|---------|---------| | 通义千问 (Qwen) | qwen-plus | wechat-ai set qwen <key> | 申请 | | DeepSeek | deepseek-chat | wechat-ai set deepseek <key> | 申请 | | Claude | claude-opus-4-6 (Agent) | wechat-ai set claude <key> | 申请 | | GPT | gpt-4o | wechat-ai set gpt <key> | 申请 | | Gemini | gemini-2.0-flash | wechat-ai set gemini <key> | 申请 | | MiniMax | MiniMax-Text-01 | wechat-ai set minimax <key> | 申请 | | 智谱 (GLM) | glm-4-plus | wechat-ai set glm <key> | 申请 | | OpenRouter | 300+ 第三方模型 | wechat-ai set openrouter <key> | 申请 |

支持任何 OpenAI 兼容 API，编辑 ~/.wai/config.json 即可添加。

所有模型均通过 claw-agent-sdk 获得 Agent 能力，支持搜索网页、读写文件、执行代码。Claude 另外通过 Agent SDK 接入，提供最强质量。

第三方模型 (OpenRouter)

配置一个 OpenRouter Key 即可使用 300+ 模型，无需逐个申请：

wechat-ai set openrouter sk-or-xxx

在微信中通过 /model vendor/model 切换：

/model google/gemini-2.5-pro         Google Gemini
/model anthropic/claude-sonnet-4     Anthropic Claude
/model meta-llama/llama-4-maverick   Meta Llama

更多模型见 OpenRouter Models。

微信内指令

/model                               查看当前模型
/model qwen                          切换内置模型
/model google/gemini-2.5-pro         切换第三方模型
/cc /qwen /deepseek /gpt             快捷切换
@指南                                 查看快捷指南
/help                                显示全部指令
/ping                                检查状态

Agent 能力（所有模型）

v0.4.0 起，所有模型均具备 Agent 能力：搜索网页、查天气资讯、读写文件、执行命令。由 claw-agent-sdk 驱动，无需额外配置。

详见 完整使用指南。

高级配置

配置文件位于 ~/.wai/config.json，以下为可选的高级功能。

Webhook（HTTP 消息推送）

启用后可通过 HTTP API 主动向微信用户发送消息：

{
  "webhook": {
    "enabled": true,
    "port": 4800,
    "secret": "your-secret"
  }
}

curl -X POST http://localhost:4800 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-secret" \
  -d '{"targetId": "wxid_xxx", "text": "Hello from API"}'

语音消息 (ASR / TTS)

{
  "asr": {
    "provider": "whisper",
    "apiKey": "sk-xxx"
  },
  "tts": {
    "provider": "openai",
    "apiKey": "sk-xxx",
    "voice": "alloy"
  }
}

• ASR：收到语音消息自动转文字，支持 Whisper
• TTS：AI 回复自动合成语音，支持 OpenAI / Gemini

MCP 工具

通过 MCP 协议接入外部工具，所有模型均可调用：

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "@weather/mcp-server"]
    },
    "remote-api": {
      "transport": "streamable-http",
      "url": "https://api.example.com/mcp"
    }
  }
}

支持 stdio、sse、streamable-http 三种传输方式。

Skills 人设

预设不同 AI 角色，在微信中通过 /skill 切换：

{
  "skills": {
    "translator": {
      "description": "英汉翻译",
      "systemPrompt": "你是一个专业翻译，用户发中文你翻英文，发英文你翻中文。"
    },
    "coder": {
      "description": "编程助手",
      "systemPrompt": "你是一个资深程序员，用简洁的代码和清晰的解释回答问题。",
      "provider": "claude"
    }
  }
}

架构

微信用户
  │
  ▼
微信服务器
  │
  ▼ (iLink Bot API — 微信官方协议)
  │
wechat-ai 网关
  ├── 会话管理（per-user 独立上下文）
  ├── 消息聚合（防抖合并连续消息）
  ├── 中间件链（Koa 风格洋葱模型）
  ├── MCP 工具管理
  ├── ASR / TTS 语音处理
  └── 模型路由
        │
        ├── Claude Agent SDK（Claude 专属，最强质量）
        └── claw-agent-sdk（Qwen, DeepSeek, GPT, Gemini, OpenRouter 300+）
              └── 内置工具: 搜索, 文件读写, 命令执行, 网页抓取

技术栈

| 组件 | 技术 | |------|------| | 语言 | TypeScript (ESM) | | 运行时 | Node.js 22+ | | 微信协议 | iLink Bot API（官方） | | AI 接入 | Claude Agent SDK + claw-agent-sdk | | 工具扩展 | Model Context Protocol (MCP) | | 构建 | tsup |

项目结构

src/
├── cli.ts                    命令行入口
├── gateway.ts                消息网关 & 会话管理 & Webhook 服务
├── config.ts                 配置管理 (~/.wai/config.json)
├── types.ts                  核心接口定义
├── mcp.ts                    MCP 客户端管理
├── asr.ts                    语音转文字 (Whisper)
├── tts.ts                    文字转语音 (OpenAI / Gemini)
├── channels/
│   └── weixin.ts             微信 iLink 协议实现
└── providers/
    ├── claude-agent.ts       Claude Agent SDK 接入
    ├── claw-agent.ts         claw-agent-sdk 接入（全模型 Agent）
    └── openai-compatible.ts  通用 OpenAI 兼容 API（兼容旧版）

作为库使用

wechat-ai 同时导出为 npm 库，可嵌入你自己的项目：

npm install wechat-ai

import { Gateway } from "wechat-ai";

const gw = new Gateway(config);
gw.use(async (ctx, next) => {
  console.log(`收到消息: ${ctx.message.text}`);
  await next();
});
await gw.start();

计划

• [x] 微信 iLink 官方协议
• [x] 多模型切换 (/model)
• [x] 输入状态提示（正在输入...）
• [x] 8 个内置模型 + OpenRouter 300+
• [x] npm 发布 (CLI + Library)
• [x] 中间件系统
• [x] MCP 客户端 & 全模型 Function Calling
• [x] 后台运行 (daemon 模式)
• [x] Webhook HTTP API
• [x] Skills 人设系统
• [x] 语音消息 (ASR / TTS)
• [x] 图片理解（自动切换视觉模型）
• [x] 图片生成 (/画)
• [x] 全模型 Agent 能力 (claw-agent-sdk)
• [ ] Web 管理面板
• [ ] Telegram / Discord 渠道
• [ ] 群聊支持

协议

MIT