🦀 ClawHub
Wechat Control
by @ltf13133-wq
Control local Windows WeChat client via Python to login, send messages, list recent chats, and get total unread count using itchat library.
TERMINAL
clawhub install wechat-control📖 About This Skill
wechat-control
简介
这个 Skill 用 Python 实现，利用 itchat 库登录本地微信客户端（Windows 桌面版），可以发送文本消息、获取最近的聊天列表以及读取未读消息数量。适用于单用户本地使用场景。
功能
login：扫码登录（仅首次，需要手动在微信扫码）send(to, text)：向指定好友（昵称或微信号）发送文本消息list_chats()：返回最近 10 条聊天的 nick、last_msg、unread_cntunread_total()：返回所有未读消息的总数使用示例（Python REPL）
>>> from wechat_control import WeChat
>>> wc = WeChat()
>>> wc.login() # 首次扫码登录
>>> wc.send('小明', '你好，今天的天气不错哦')
>>> wc.list_chats()
[{'nick': '小明', 'last_msg': '好的', 'unread_cnt': 0}, ...]
>>> wc.unread_total()
3
注意事项
itchat 自动缓存 loginInfo.pkl），后续启动时会直接登录。itchat（只能在 Windows 桌面版微信上运行）和 pywin32（用于获取窗口句柄、焦点等可选功能）。pip install -r requirements.txt 安装依赖。常见问题
itchat 缓存文件 loginInfo.pkl 后重新扫码。list_chats() 获取实际 nick。itchat 找不到：请先运行 pip install itchat 安装库。依赖文件
requirements.txt
itchat==1.3.10
pywin32==306
入口脚本
main.py 负责解析命令行参数并调用 WeChat 类的相应方法。使用方式如下：
python main.py login
python main.py send "小明" "Hello!"
python main.py list
python main.py unread
📋 Tips & Best Practices
itchat 缓存文件 loginInfo.pkl 后重新扫码。list_chats() 获取实际 nick。itchat 找不到：请先运行 pip install itchat 安装库。