Weixin Bot

---

⚠️ 兼容性说明

**iOS**：支持微信 8.0.70 版本。更新到最新版后需**在后台关掉微信再重新打开**，才能正常对接 Bot。

**安卓**：已支持！扫码提示更新微信，更新完重新扫码即可，可能有部分 Bug 建议自测（部分安卓首页看不到 Bot，需要搜索或者在功能页面显示）。

---

📖 从零开始（小白教程）

完全没用过终端？没关系，跟着下面一步步来：

第 1 步：安装 Node.js

去 [nodejs.org](https://nodejs.org) 下载 **LTS 版本**（绿色按钮），双击安装，一路下一步就行。

怎么确认装好了？打开终端，输入：

node -v

看到类似 `v22.x.x` 就说明装好了。

**怎么打开终端？**

• Mac：按 Command + 空格，输入"终端"，回车
• Windows：按 Win + R，输入 cmd，回车（或搜索"PowerShell"）
• Linux：按 Ctrl + Alt + T

第 2 步：一条命令启动

在终端里输入：

npx wx-ai-bot

`npx` 是 Node.js 自带的工具，会自动下载并运行 wx-ai-bot，不需要你手动安装任何东西。

第 3 步：选择 AI 提供商

终端会显示菜单，输入数字选择：

  AI 提供商：
    1) OpenAI        ← 最常用，需要 API key
    2) Claude
    3) Gemini        ← Google 的，有免费额度
    4) Ollama        ← 本地运行，完全免费
    ...
    9) Echo mode     ← 测试用，不需要任何 key

**新手建议**：先选 `9`（回声模式）测试一下流程，确认能跑通再换成真正的 AI。

第 4 步：扫码登录

终端会显示一个二维码，用**微信扫一扫**扫它。

扫完在手机上确认，终端显示 `✅ 登录成功` 就 OK 了。

第 5 步：开始聊天

现在用另一个微信号给你的 Bot 发消息试试！Bot 会自动回复。

按 `Ctrl + C` 可以随时停止。

常见问题

| 问题 | 解决 |