Astrbot-wechat-bot- - GitLite

KO | EN

gitlite — search

#mysql #deep-learning #nextjs #c #mcp #large-language-models #agent #html #vue #rag

Astrbot-wechat-bot-

(★ 53)

微信 ↔ AstrBot 双端互通桥接。通过 wxauto 监听微信消息，调用 AstrBot Open API 与 LLM 对话，让微信小号变成 AI 机器人，与 QQ 机器人共享记忆。

Astrbot-wechat-bot- 최신버젼 다운로드

ZIP 다운로드

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일 경로 직접 입력

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`pip install`

설명 보기 ▼

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

🔍

`python`

설명 보기 ▼

Python 언어 인터프리터.
더 많은 정보: <https://docs.python.org/using/cmdline.html>.

python

REPL(대화형 셸) 시작:

python {{path/to/file.py}}

특정 Python 파일 실행:

python -i {{path/to/file.py}}

특정 Python 파일 실행 후 REPL 시작:

🔍

`reg add`

설명 보기 ▼

Add new keys and their values to the registry.

reg add {{key_name}}

Add a new registry key:

reg add {{key_name}} /v {{value}}

Add a new [v]alue under a specific key:

reg add {{key_name}} /d {{data}}

Add a new value with specific [d]ata:

🔍

`winget`

설명 보기 ▼

윈도우 패키지 매니저.
더 많은 정보: <https://learn.microsoft.com/windows/package-manager/winget>.

winget {{[add|install]}} {{package}}

패키지 설치:

winget {{[rm|uninstall]}} {{package}}

패키지 제거 (참고: `remove` 대신 `uninstall` 을 사용할 수 있음):

winget show {{package}}

패키지에 대한 정보 표시:

# 프로젝트 배지

Download ZIP 바로가기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

让你的 **AstrBot QQ 机器人** 与 **微信小号** 互通。同一个 LLM + 同一套记忆，用户在微信上发消息 = 跟 QQ 机器人聊天，反之亦然。

若在使用过程中有任何问题，可加qq群110345753进行反馈，但鉴于作者为高三学生，若有不及时之处，还请见谅

## 特性

- **微信小号本身就是机器人**，无需添加机器人好友
- **微信群聊仅 @回复**，不主动发言
- **共享记忆**：QQ 聊过的微信知道，微信聊过的 QQ 知道（AstrBot LivingMemory）
- **Web 控制面板**：浏览器管理启动/停止/暂停/恢复，实时状态和日志
- **焦点抑制**：发送消息时短暂激活微信窗口，发完自动归还焦点
- **微信号（wxid）稳定标识**：防止对方改名后上下文丢失
- **图片视觉识别**：支持接收图片并触发 LLM 视觉模型描述
- **支持文字、图片、表情包**

## 架构

```
Windows 桌面
├── WeChat 3.9.x          ← 小号登录
└── Python 桥接脚本
    ├── wxauto             ← 监听/发送微信消息
    └── requests           ← 调用 AstrBot API

Docker / 服务器（同一局域网或本机）
└── AstrBot (端口 6185)
    ├── /api/v1/chat       ← Open API，处理 LLM+记忆
    └── LivingMemory       ← 记忆存储（跨平台共享）
```

## 前置条件

| 依赖 | 说明 |
|------|------|
| Windows 系统 | 需要桌面微信 + Python 运行环境 |
| WeChat 3.9.x | wxauto **只支持 3.9.x** 版本，4.0+ 无效 |
| Python 3.9+ | 运行桥接脚本 |
| AstrBot | 已部署运行的 AstrBot 实例（Docker 或本地） |
| Ollama | 用于 embedding 模型（如 nomic-embed-text） |

## 快速开始

### 1. 获取微信 3.9.x

从 [tom-snow/wechat-windows-versions](https://github.com/tom-snow/wechat-windows-versions) 下载 3.9.x 版本（推荐 3.9.10.19）。

> **防自动更新**：WeChat 3.9.x 会自动升级到 4.x，装完后请做以下操作：
> 1. 登录后：左下角菜单 → 设置 → 通用设置 → 取消勾选"有更新时自动升级微信"
> 2. 重命名微信安装目录下的 `WeChatUpdate.exe` 为 `WeChatUpdate.exe.bak`
> 3. 注册表禁用：`reg add "HKEY_CURRENT_USER\Software\Tencent\WeChat" /v "NeedUpdateType" /t reg_dword /d "0" /f`

### 2. 安装依赖

**Step 1 — 先装 git（Windows 需要）**
```bash
winget install Git.Git
```
> 装完**关掉终端重新打开**，否则下一步会找不到 git。

**Step 2 — 安装 wxauto**
> wxauto **不在 PyPI 上**，必须从 GitHub 安装。

```bash
pip install git+https://github.com/cluic/wxauto.git
```

如果 GitHub 直连慢，可以用镜像加速：
```bash
pip install git+https://ghfast.top/https://github.com/cluic/wxauto.git
```

### 3. 配置 AstrBot

确保你的 AstrBot 实例正常运行，并且：

- Open API 端口已映射（默认 6185）
- 已创建 API 密钥（scope=chat）
- `unique_session = true`（跨平台上下文共享）
- 已移除 `group_chat` 插件（群聊由桥接脚本控制）
- LivingMemory 插件正常运行

### 4. 配置桥接脚本

编辑 `bridge.py`，修改以下配置：

```python
ASTRBOT_URL = "http://localhost:6185/api/v1/chat"    # AstrBot API 地址
API_KEY = "your_astrobot_api_key_here"                # AstrBot API 密钥
BOT_NICKNAMES = ["你的微信昵称"]                       # 机器人微信昵称（群聊 @ 检测用）
```

### 总结版
1.装好依赖（astrbot+内置所需的api本地模型等+python+所有库...）
2.下载项目文件（clone 或直接下载 zip）（全部拖到桌面就行）
3.改 bridge.py 三个配置项：
  API_KEY ← 你自己的 AstrBot 密钥
  BOT_NICKNAMES ← 你自己的微信昵称
  ASTRBOT_URL ← 你自己的 AstrBot 地址（端口可能不一样）
4.打开：python bridge.py 或 start_bot.bat
5.访问上面显示的 http://127.0.0.1:8765（反正现实的web）
6.点 "启动" 就开始跑了

## 使用

### 微信版本补丁（每次重启微信后必做）

微信 3.9.x 已被服务器端封禁，登录时会提示"版本过低"。使用内存补丁绕过：

```bash
python wechat_patcher.py
```

**扫码登录顺序（关键！）：**
1. 手机扫码
2. **不要点确认**
3. **再扫一次**
4. **点确认登录**

### 启动桥接

**方式一：Web 控制面板**
```bash
python bridge.py
# 浏览器打开 http://127.0.0.1:8765
# 点击"启动"按钮
```

**方式二：批处理文件**
```bash
# 启动控制面板
start_bot.bat

# 停止桥接
stop_bot.bat
```

### 验证

给微信小号发私聊消息，检查是否回复。查看 `bridge.log` 排查问题。

> 注意：第一次启动时，桥接脚本会自动读取好友列表构建微信号映射。如果对方改过微信昵称，上下文仍然关联到同一个 wxid，不会丢失。

## 项目文件

| 文件 | 说明 |
|------|------|
| `bridge.py` | 主桥接脚本（含 Web 控制面板） |
| `wechat_patcher.py` | 微信版本过低内存补丁 |
| `requirements.txt` | Python 依赖 |
| `start_bot.bat` | 启动控制面板+自动打开浏览器 |
| `stop_bot.bat` | 停止桥接脚本 |
| `start_wechat.bat` | 启动微信+自动打补丁 |

## 消息流程

### 私聊
1. wxauto 轮询到新消息 → 判断私聊
2. `POST http://<astrbot-ip>:6185/api/v1/chat` 发送消息
3. AstrBot 处理：查记忆 → LLM → 存记忆 → 返回回复
4. 激活微信窗口 → 切换到对应聊天 → 粘贴并发送回复

### 群聊 @回复
1. 轮询到新群消息，检查是否含 `@` + 已知昵称
2. 未被 @ → 跳过
3. 被 @ → 同私聊流程，session_id 使用 `wx_group_群名_发送者昵称`

## 技术要点

### wxauto
由于wxauto库使用，必然会产生和你抢鼠标键盘/抢焦点情况，目前已经设置了仅在→收到消息→去查看→进行回复 的时候才会占用

也可以配置虚拟机实现，但由于作者有点懒故而...（ciallo！

### DirectUI 发送机制

微信 WeChat 3.9.x 使用腾讯自研 **DirectUI** 框架，导致标准 UI 自动化方法失效：

| 方案 | 结果 | 原因 |
|------|------|------|
| `wxauto.SendMsg()`（UIA ValuePattern） | ❌ 静默失败 | DirectUI ValuePattern stub |
| `AttachThreadInput` + `keybd_event(Ctrl+V)` | ❌ 不粘贴 | 焦点不在编辑框 |
| `editbox.Click()` + `SendKeys('{Ctrl}v')` + `SendKeys('{Enter}')` | ✅ 可靠 | Click 让 DirectUI 内部焦点移到编辑框 |

### 新消息检测

`GetAllNewMessage()` 内部依赖 `IsRedPixel`（截屏检测红色角标）。窗口被遮挡时截屏会拍到覆盖窗口，无法检测红点。解决方案：每 3 轮轮询做一次 UIA 直读会话列表，对未读会话手动切换读取。

## 常见问题

### Embedding 连接失败

AstrBot 容器内通过 Docker bridge 网络连接 Ollama：
```
http://172.17.0.2:11434/v1
```
不能在 embedding 配置中使用 `host.docker.internal`（除非 Ollama 端口映射到宿主机）。

### 记忆存储失败后不重试

如果 `pending_summary.retry_count >= 3`，LivingMemory 插件不再重试。可通过 SQLite 手动重置：

```bash
# 进入 AstrBot 容器后执行
python -c "
import sqlite3, json
conn = sqlite3.connect('/AstrBot/data/plugin_data/astrbot_plugin_livingmemory/conversations.db')
cur = conn.cursor()
cur.execute('SELECT session_id, metadata FROM sessions')
for r in cur.fetchall():
    meta = json.loads(r[1])
    if meta.get('pending_summary'):
        meta['pending_summary']['retry_count'] = 0
        cur.execute('UPDATE sessions SET metadata=? WHERE session_id=?', (json.dumps(meta), r[0]))
conn.commit()
conn.close()
"
```

### 微信启动相关

- 每次重启微信后必须重新运行 `wechat_patcher.py`
- 扫码必须按"扫码 → 不确认 → 再扫一次 → 确认"的顺序操作
- 如果微信自动更新到 4.x，需要卸载重装 3.9.x 并禁用更新

### 群聊不回复

检查 `BOT_NICKNAMES` 配置是否正确。桥接脚本检查消息中是否含 `@` + 任一已知昵称。

## AstrBot 部署参考

- 容器名：`astrbot-final`
- Open API 端口：6185（映射到宿主机）
- QQ 适配器：aiocqhttp + napcat（OneBot v11）
- 主 LLM：通过 api.deepseek.com 或其他 OpenAI 兼容 API
- Embedding 模型：`nomic-embed-text`（Ollama 提供）
- 记忆数据库：SQLite（conversations.db）+ FAISS 向量索引

注：本项目默认建立在已经配置好astrbot并下载插件living memory的情况下，旨在做到vx小号也可接入bot并且记忆互通，实现所有平台信息同步，若尚未完成astrbot配置，请先前往该项目——https://github.com/AstrBotDevs/AstrBot 
，完成初始配置

## 许可证

MIT