wxauto

微信自动化

通过本地 HTTP 服务操作微信，支持消息收发、监听、好友管理等功能。

前置要求

安装 wxautox4：

pip 安装 wxautox4

注意：需windows系统，python3.9,3.10,3.11,3.12 64位，其他python版本暂不支持

激活 wxautox4：

wxautox4 -a your-activation-code

获取：https://docs.wxauto.org/plus

部署 API 服务：

克隆项目：https://github.com/cluic/wxauto-restful-API 配置 config.yaml 启动服务：python 运行.py 服务配置 认证：Bearer 令牌（见 config.yaml 的 auth.令牌，默认值为 令牌） 服务状态文件：~/.wxautox/服务_状态.json（服务启动时自动生成，请查看该文件获取服务信息） 自动配置检测

服务启动后会自动将运行信息写入 ~/.wxautox/服务_状态.json。wxAPI.py 脚本会：

自动读取此文件获取连接配置 验证服务是否真的在运行（通过 API 健康检查） 如果服务未运行，自动启动服务（需要服务目录存在）

服务目录搜索顺序：

../wxauto-restful-API（相对于 技能 目录） ~/wxauto-restful-API WXAPI_服务_DIR 环境变量指定的路径 手动配置方式（可选）

如果需要覆盖自动配置，优先级从高到低：

命令行参数

python wxAPI.py --base-url "http://localhost:9000" --令牌 "my-令牌" 发送 "好友" "消息"

环境变量

$env:WXAPI_BASE_URL = "http://localhost:9000" $env:WXAPI_令牌 = "my-令牌" # 或者 $env:WXAPI_PORT = "9000" $env:WXAPI_服务_DIR = "/path/to/wxauto-restful-API"

服务_状态.json - 自动检测（推荐）

config.yaml - 服务目录下的配置文件

默认值 - http://localhost:8000, 令牌 为 令牌

启动服务

首次使用前需要启动服务：

# 进入服务目录 cd /path/to/wxauto-restful-API

启动服务 python 运行.py

或后台启动（Windows）：

启动-Process python -Argument列出 "运行.py" -WorkingDirectory "C:\path\to\wxauto-restful-API" -WindowStyle Hidden

如果服务已运行，脚本会自动连接；如果服务未运行且配置了服务目录，脚本会自动启动服务。

脚本路径

Python 调用脚本位于 技能 目录下的 scripts/wxAPI.py。

使用 {baseDir} 引用 技能 目录：

python "{baseDir}/scripts/wxAPI.py" 发送 "好友" "消息"

可用命令 初始化和状态 # 初始化微信实例 python wxAPI.py init

# 获取服务状态 python wxAPI.py 状态

# 检查是否在线 python wxAPI.py online

# 获取我的信息 python wxAPI.py my信息

发送消息 # 主窗口发送 python wxAPI.py 发送 "好友名" "消息内容"

# 精确匹配 python wxAPI.py 发送 "好友名" "消息内容" --exact

# @群成员 python wxAPI.py 发送 "群名" "开会了" --at "张三,李四"

# 子窗口发送 python wxAPI.py 发送-chat "好友名" "消息内容"

读取消息 # 获取聊天记录（主窗口） python wxAPI.py 获取msg "好友名"

# 获取聊天记录（子窗口） python wxAPI.py 获取msg-chat "好友名"

# 获取历史消息 python wxAPI.py 历史 "好友名" --count 100

# 获取新消息（主窗口轮询） python wxAPI.py newmsg

# 获取新消息（子窗口） python wxAPI.py newmsg-chat "好友名"

监听管理 # 添加监听（打开子窗口） python wxAPI.py 列出en "好友名"

会话管理 # 获取会话列表 python wxAPI.py 会话

# 获取所有子窗口 python wxAPI.py windows

# 切换聊天窗口 python wxAPI.py chatwith "好友名" --exact

获取列表 # 好友列表 python wxAPI.py friends

# 群聊列表 python wxAPI.py groups

页面控制 # 切换到聊天页面 python wxAPI.py switch-chat

# 切换到联系人页面 python wxAPI.py switch-contact

查看帮助 python wxAPI.py --help

API 接口列表

根据 wxauto-restful-API 服务：

微信功能接口 接口 说明 POST /v1/wechat/初始化 初始化微信实例 获取 /v1/wechat/状态 获取微信状态 POST /v1/wechat/发送 发送消息 POST /v1/wechat/发送file 发送文件 POST /v1/wechat/发送urlcard 发送 URL 卡片 POST /v1/wechat/获取allmessage 获取当前窗口消息 POST /v1/wechat/获取历史message 获取历史消息 POST /v1/wechat/获取nextnewmessage 获取新消息 POST /v1/wechat/获取会话 获取会话列表 POST /v1/wechat/获取subwindow 获取指定子窗口 POST /v1/wechat/获取allsubwindow 获取所有子窗口 POST /v1/wechat/chatwith 切换聊天窗口 POST /v1/wechat/获取friends 获取好友列表 POST /v1/wechat/获取my信息 获取我的信息 POST /v1/wechat/获取recentgroups 获取群聊列表 POST /v1/wechat/switch/chat 切换到聊天页面 POST /v1/wechat/switch/contact 切换到联系人页面 POST /v1/wechat/isonline 检查在线状态 聊天接口（子窗口） 接口 说明 POST /v1/chat/发送 子窗口发送消息 POST /v1/chat/获取allmessage 获取子窗口所有消息 POST /v1/chat/获取newmessage 获取子窗口新消息 POST /v1/chat/msg/quote 发送引用消息 POST /v1/chat/close 关闭子窗口 直接 API 调用（备选）

如需直接调用 HTTP API，用 Python（不要用 PowerShell，有中文编码问题）：

导入 请求s

headers = {"Authorization": "Bearer 令牌", "Content-Type": "应用/json"} body = {"who": "好友名", "msg": "消息内容"} resp = 请求s.post("http://localhost:8000/v1/wechat/发送", headers=headers, json=body) print(resp.json())

响应格式

所有 API 返回统一格式：

{ "成功": true, "message": "操作成功", "data": { ... } }

注意事项 微信客户端需要保持打开状态 wxautox4 需要激活后才能使用 不要用 PowerShell 直接调用 API（中文编码问题），请使用 Python 脚本 修改 config.yaml 中的 auth.令牌 以增强安全性