WeChat Automation Skill

环境要求

• 操作系统：Windows 10/11
• 微信版本：PC微信 3.9.12.x / 4.0+
• Python：3.x
• 依赖：

  pip install pywechat127 emoji pyautogui pywinauto pyperclip psutil pywin32

一键安装

在 OpenClaw 终端执行一次：

pip install pywechat127 emoji pyautogui pywinauto pyperclip psutil pywin32

注意：OpenClaw 运行在沙箱时需要微信安装在标准路径，且与 OpenClaw 同桌面会话。首次使用前先运行环境检查：

python "C:\Users\HUAWEI\.openclaw\workspace\skills\wechat-automation\scripts\check_env.py"

核心功能（直接调用，无需生成脚本）

发送消息

import sys
sys.path.insert(0, r'D:\code\pywechat3')
from pywechat.WechatAuto import Messages

# 单人单条
Messages.send_message_to_friend(
    friend="好友备注",
    message="消息内容",
    close_wechat=True
)

# 单人多条
Messages.send_messages_to_friend(
    friend="好友备注",
    messages=["消息1", "消息2"],
    delay=0.4
)

批量发送（给不同好友发不同消息）

from pywechat.WechatAuto import Messages

Messages.send_messages_to_friends(
    friends=["好友1", "好友2"],
    messages=[["消息A"], ["消息B"]],
    delay=0.4
)

发送文件

from pywechat.WechatAuto import Files

Files.send_file_to_friend(
    friend="好友备注",
    file_path=r"C:\path\to\file.pdf"
)

读取聊天记录

from pywechat.WechatTools import Tools

contents, senders, types = Tools.pull_messages(
    friend="好友备注",
    number=200
)

获取通讯录

from pywechat.WechatAuto import Contacts

# 好友列表
friends = Contacts.get_friends_info()

# 群聊列表
groups = Contacts.get_groups_info()

监听新消息

from pywechat.WechatAuto import Messages

new_messages = Messages.check_new_message(
    duration="5min",
    save_file=True
)

自动回复（装饰器）

from pywechat.utils import auto_reply_to_friend_decorator

@auto_reply_to_friend_decorator(duration="30min", friend="好友备注")
def reply_func(newMessage):
    if "在吗" in newMessage:
        return "你好，我暂时不在"
    return "收到"

reply_func()

技术原理

• UI 自动化：

  pywinauto

  （Windows 原生 UI Automation API）
• 输入模拟：

  pyautogui

  （剪贴板复制 → Ctrl+V 粘贴 → Alt+S 发送）
• 发消息：复制内容到剪贴板 → 粘贴到微信输入框 → 发送快捷键
• 无 Hook / 无内存读取：纯物理 UI 模拟，微信无法检测

错误处理

WeChatNotStartError

ElementNotFoundError

NotInstalledError

NoSuchFriendError

参考

• PyPI：https://pypi.org/project/pywechat127/
• 源码：https://github.com/Hello-Mr-Crab/pywechat
• 本地源码：

  D:\code\pywechat3