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 终端执行一次：

bash

pip install pywechat127 emoji pyautogui pywinauto pyperclip psutil pywin32

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

bash

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

---

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

发送消息#

python

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
)

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

python

from pywechat.WechatAuto import Messages

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

发送文件#

python

from pywechat.WechatAuto import Files

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

读取聊天记录#

python

from pywechat.WechatTools import Tools

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

获取通讯录#

python

from pywechat.WechatAuto import Contacts

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

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

监听新消息#

python

from pywechat.WechatAuto import Messages

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

自动回复（装饰器）#

python

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微信版本不兼容更新 pywechat 或检查 UI 元素NotInstalledError未找到微信注册表确认微信 3.9+ 已安装NoSuchFriendError好友备注不匹配检查精确备注名

参考#

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