wxwork-rpa — wxwork-RPA（微信企业版机器人流程自动化）

企业微信桌面自动化工具 基于桌面端UI自动化的企业微信操作工具，支持Windows/macOS双平台，可实现企业微信窗口管理、联系人操作、消息收发、聊天记录提取及自动化智能回复。 ⚠️ 重要声明：本工具仅用于个人合法合规的企业微信操作自动化，请勿用于批量群发、骚扰他人等违规场景。使用前请确保遵守企业微信用户协议及相关法律法规。

支持平台 ✅ Windows (支持企业微信Windows版所有主流版本) ✅ macOS (支持企业微信macOS版) ❌ Linux (暂不支持)

前提条件

• 环境依赖安装

# 基础核心依赖 pip install pyautogui pillow opencv-py numpy pyperclip requests psutil paddle # Windows 额外依赖 pip install pywin32 # macOS 额外依赖 pip install pyobjc-framework-Quartz pyobjc-core pyobjc

• 权限配置

Windows：无需额外权限，确保企业微信已安装并登录 macOS：授予终端/IDE"辅助功能"和"屏幕录制"权限： 系统设置 → 隐私与安全 → 辅助功能 → 添加终端/IDE 系统设置 → 隐私与安全 → 屏幕录制 → 添加终端/IDE

• 企业微信准备

确保企业微信已安装并完成登录 建议将企业微信窗口最大化运行（提升定位准确性） 关闭企业微信的"消息免打扰"等可能影响界面显示的设置

• 自动回复的Authentication

自动回复需要 CHAT_API_URL 和 CHAT_API_KEY 和模型名称CHAT_MODEL: Authorization: Bearer YOUR_API_KEY Environment Variable: Set your API url as CHAT_API_URL，Set your API key as CHAT_API_KEY: export CHAT_API_URL="YOUR_API_URL" export CHAT_API_KEY="YOUR_API_KEY" export CHAT_MODEL="YOUR_CHAT_MODEL"

使用方法 启动企业微信 py wechat.py start 激活企业微信窗口 py wechat.py activate 搜索联系人并发送消息 py wechat.py search_and_send --contact 张三 --message "你好，这是自动发送的消息" 获取聊天记录 py wechat.py get_history --contact 李四 --limit 10 自动处理联系人消息（智能回复） # 基础用法 py wechat.py auto_process --api_key "CHAT_API_KEY" --api_url "CHAT_API_URL" --model "CHAT_MODEL" 暂停自动回复 py wechat.py stop_auto_process 查看帮助 py wechat.py help

命令参考 命令 功能 示例 start 启动企业微信客户端 wechat.py start activate 激活并最大化企业微信窗口 wechat.py activate --title 企业微信 search_and_send 搜索联系人并发送消息 wechat.py search_and_send --contact 张三 --message 您好 get_history 获取指定联系人聊天记录 wechat.py get_history --contact 李四 --limit 15 auto_process 自动轮询联系人并智能回复 wechat.py auto_process --polling_times 10 --api_key xxx --api_url xxx --model xxx --contact_list xxx stop_auto_process 停止自动回复 wechat.py stop_auto_process help 查看帮助信息 wechat.py help

核心功能说明

• 企业微信进程与窗口管理

功能 说明 进程检测 自动检测企业微信是否正在运行 自动启动 查找企业微信安装路径并启动，支持多路径适配 窗口激活 定位企业微信窗口并激活，支持最大化、前置显示 区域定位 自动识别企业微信界面各功能区域（输入框、发送按钮等）

• 联系人操作

功能 说明 精准搜索 通过搜索框定位联系人，支持剪贴板输入避免输入失败 列表点击 按索引点击联系人列表，支持边界检查 状态记忆 记录当前打开的联系人，避免重复操作

• 消息处理

功能 说明 安全输入 支持剪贴板粘贴和逐字符输入，避免输入异常 消息发送 精准点击发送按钮，支持自然鼠标移动轨迹 记录提取 通过OCR和右键复制提取聊天记录，区分收发方向 新消息检测 自动识别最新收到的消息，过滤自己发送的内容

• 自动化回复

功能 说明 轮询检测 循环检查多个联系人的新消息 AI接口集成 调用自定义AI接口获取回复内容 批量发送 支持多条回复依次发送，可自定义发送间隔 异常处理 失败自动重试，错误日志完整记录

配置说明 界面区域配置 首次运行activate命令会自动生成config/wechat_regions.json 包含企业微信界面各区域的坐标和尺寸参数 不同平台配置自动区分，避免混用 自定义参数 参数 功能 示例 --contact 指定联系人名称 --contact 张三 --message 发送的消息内容 --message "您好" --limit 聊天记录获取数量 --limit 10 --polling_times 自动轮询次数 --polling_times 20 --api_url AI接口地址 --api_url "your-api-url" --api_key AI接口密钥 --api_key "your-api-key" --model 模型名称 --model "your-chat-model" --contact_list 过滤联系人 --contact_list 张三 李四 --title 企业微信窗口标题 --title "企业微信"

技术说明 核心技术点 跨平台适配：通过platform模块区分Windows/macOS，适配不同的窗口管理API 精准定位：基于企业微信界面固定布局计算各功能区域坐标，无需图像识别 人机模拟：贝塞尔曲线模拟人类鼠标移动轨迹，随机偏移避免被检测 安全操作：所有点击/输入操作均有异常处理，失败自动降级为基础操作 剪贴板管理：使用前保存、使用后恢复剪贴板内容，避免覆盖用户数据

关键模块说明 模块 功能 WeChatRegion 数据类，定义企业微信界面所有区域的参数和坐标 WeChatAutomation 核心类，封装所有自动化操作方法 _safe_click 安全点击方法，模拟人类操作行为 _locate_message_bubbles 消息气泡定位，基于OpenCV识别消息区域 auto_process_contacts 自动化主方法，实现轮询和智能回复

日志与调试 日志文件：wechatmation.log（包含详细操作记录） 调试目录：debug/（存储截图等调试信息） 所有关键操作均有日志输出，便于问题定位

常见问题 错误：无法激活企业微信窗口 → 确认企业微信已运行并登录，或先执行start命令启动企业微信 → macOS需授予辅助功能权限 错误：点击位置不准确 → 确保企业微信窗口已最大化 → 删除config/wechat_regions.json重新生成区域配置 → 检查企业微信界面布局是否为默认样式 错误：剪贴板操作失败 → Windows：安装pywin32库（pip install pywin32） → macOS：确保终端有剪贴板访问权限 错误：消息发送成功但对方未收到 → 检查输入框是否真正获得焦点 → 增加发送后的等待时间（修改代码中time.sleep参数） 错误：AI接口调用失败 → 检查API地址和密钥是否正确 → 确认接口支持POST请求，且返回格式符合要求 → 检查网络连接和接口权限 企业微信界面更新后工具失效 → 更新WeChatRegion中的尺寸参数 → 重新运行activate生成新的区域配置

隐私与安全 ✅ 所有操作均在本地完成，不上传任何数据到网络 ✅ 仅访问企业微信界面，不读取企业微信数据库文件 ✅ 剪贴板内容使用后自动恢复，避免信息泄露 ✅ 操作日志仅保存在本地，可随时删除 ⚠️ 自动化操作可能违反企业微信用户协议，请谨慎使用 ⚠️ 请勿用于商业推广、垃圾信息发送等违规行为

扩展功能 可添加文件发送功能（点击文件按钮→选择文件→确认发送） 可添加图片识别功能（结合OCR提取图片中的文字） 可添加定时发送功能（结合schedule库实现定时操作）

免责声明 本工具仅用于学习和研究目的，请勿用于商业或违规用途。使用本工具产生的一切后果由使用者自行承担，作者不承担任何责任。