wechat-ai

多渠道 AI 机器人 — 一条命令连接微信、Discord、WhatsApp 与任意 AI 模型。

基于微信官方 iLink Bot API 构建，合规、稳定、不怕封号。同时支持 Discord Bot 和 WhatsApp 渠道。

特性

• 多渠道支持 — 微信、Discord、WhatsApp 三合一，统一管理
• 一条命令启动 — 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 logout                 # 退出所有渠道登录
wechat-ai logout <渠道>           # 退出指定渠道（weixin / whatsapp）
wechat-ai start                  # 后台运行（daemon 模式）
wechat-ai stop                   # 停止后台进程
wechat-ai logs                   # 查看后台日志
wechat-ai update                 # 更新到最新版

支持模型

支持任何 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，以下为可选的高级功能。

Discord 渠道

在 ~/.wai/config.json 中启用并填入 Bot Token：

{
  "channels": {
    "discord": {
      "type": "discord",
      "enabled": true,
      "token": "your-bot-token"
    }
  }
}

Bot Token 在 Discord Developer Portal 创建应用后获取。需开启 Message Content Intent。

WhatsApp 渠道

在 ~/.wai/config.json 中启用：

{
  "channels": {
    "whatsapp": {
      "type": "whatsapp",
      "enabled": true
    }
  }
}

首次启动会弹出二维码，用 WhatsApp 扫码绑定。如需重新绑定：wechat-ai logout whatsapp。

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"
    }
  }
}

架构

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

技术栈

项目结构

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 协议实现
│   ├── discord.ts            Discord Bot 渠道
│   └── whatsapp.ts           WhatsApp 渠道 (Baileys)
└── 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();

计划

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

协议

MIT