Wechat_astrbot

基于微信openclaw-weixin接口，接入多个mcp实现的轻量化微信助手。

1. 架构演进与重构背景

早期方案依赖 wxauto 及 Windows 句柄注入/UI Automation，存在三大痛点：

依赖桌面会话：必须维持 Windows 桌面处于活跃状态；
多账号与风控：需专用小号登录，维护繁琐且易掉线；
高维护成本：微信 UI 层级频繁变动导致抓取逻辑极易失效。

新版本统一归档旧代码，全面切至 iLink 协议与微信开放第三方接口对接，无需复杂中间件，更轻量稳定。

2. 核心功能与特性

轻量鉴权：扫码授权生成 session.json，无客户端窗口依赖。
MCP 工具生态：
- 实时天气：基于和风天气 API 查询。
- 联网检索：实时补充外部检索知识。
- 任务定时调度：本地数据库存储待办事项，定时主动向微信推送提醒。
人设定制：在 聊天助手.txt、定时提醒开场白.txt、主动问候语.txt 中自定义 Prompt。
高性价比模型接入：兼容 DeepSeek（如 deepseek-v4-flash）等低成本 API。

3. 本地与服务器快速起步

依赖与配置

1
2
3

pip install -r ilink_catgirl/requirements.txt
cp .env.example .env  # 填入大模型 API Key 与和风天气 Key
python main.py        # 扫码授权登录

4. Linux 云服务器持久化部署（Screen）

为保证 24 小时后台稳定运行，使用 screen 进行会话托管：

# 1. 安装 screen
sudo apt update && sudo apt install -y screen

# 2. 新建并进入虚拟终端
screen -S bot

# 3. 运行程序
python3 main.py

# 4. 挂起会话（保持后台运行）
# 依次按下：Ctrl + A，然后按 D（终端提示 [detached] 即可安全关闭 SSH）

运维管理常用命令

操作	命令
查看后台会话	`screen -ls`
重连会话	`screen -r bot`
强占/踢掉已占用会话并重连	`screen -d -r bot`
彻底关闭会话	`screen -X -S bot quit`

2.0版本已发布！如果你感兴趣，留下您的star，这对我是一份非常重要的鼓励。

inmost's blog

wechat_astrbot