claw-codes/wx4py/wx4-skill

try:
    from wx4py import WeChatClient
    print("✅ wx4py 已安装")
except ImportError:
    print("❌ 未安装 wx4py")

# 方法1：从 PyPI 安装（推荐）
pip install wx4py
 
# 方法2：从 GitHub 安装（最新版）
pip install git+https://github.com/claw-codes/wx4py.git
 
# 方法3：从本地安装
cd /path/to/wx4py
pip install .

from wx4py import WeChatClient
# 测试导入
print("✅ 安装成功！")
# 检查版本（可选）
import wx4py
print(f"版本: {wx4py.__version__}")

from wx4py import WeChatClient
wx = WeChatClient()
wx.connect()
# 发送给联系人
wx.chat_window.send_to("文件传输助手", "测试消息")
# 发送到群
wx.chat_window.send_to("工作群", "下午3点开会", target_type='group')
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 批量发送到多个群
groups = ["群1", "群2", "群3"]
message = "重要通知：明天放假"
wx.chat_window.batch_send(groups, message)
# 批量发送到多个联系人
contacts = ["张三", "李四", "王五"]
wx.chat_window.batch_send(contacts, "周末聚餐通知", target_type='contact')
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 发送文件给联系人
wx.chat_window.send_file_to("文件传输助手", r"C:\reports\weekly.pdf")
# 发送文件到群
wx.chat_window.send_file_to("工作群", r"C:\data.xlsx", target_type='group', message='可以携带消息')
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 发送多个文件
files = [
    r"C:\images\photo1.png",
    r"C:\images\photo2.png",
    r"C:\documents\report.pdf"
]
wx.chat_window.send_file_to("文件传输助手", files)
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 获取今天的聊天记录
messages = wx.chat_window.get_chat_history(
    target="工作群",
    target_type='group',
    since='today'  # 'today' | 'yesterday' | 'week' | 'all'
)
# 处理消息
for msg in messages:
    print(f"[{msg['time']}] {msg['content']}")
wx.disconnect()

{
    "type": "text",      # text / link / system
    "content": "消息内容",
    "time": "今天 15:30"
}

wx = WeChatClient()
wx.connect()
members = wx.group_manager.get_group_members("工作群")
print(f"群成员数量：{len(members)}")
for member in members:
    print(member)
wx.disconnect()

wx = WeChatClient()
wx.connect()
wx.group_manager.set_group_nickname("工作群", "张三的小号")
wx.disconnect()

wx = WeChatClient()
wx.connect()
nickname = wx.group_manager.get_group_nickname("工作群")
print(f"我在本群的昵称：{nickname}")
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 开启免打扰
wx.group_manager.set_do_not_disturb("工作群", enable=True)
# 关闭免打扰
wx.group_manager.set_do_not_disturb("工作群", enable=False)
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 置顶聊天
wx.group_manager.set_pin_chat("工作群", enable=True)
# 取消置顶
wx.group_manager.set_pin_chat("工作群", enable=False)
wx.disconnect()

wx = WeChatClient()
wx.connect()
# 优先使用这种方式，从 Markdown 文件设置公告（支持表格、列表等格式）
wx.group_manager.set_announcement_from_markdown("工作群", "markdown文件路径")
# 直接设置文本公告
wx.group_manager.modify_announcement_simple("工作群", "本群禁止发广告，违者移出")
wx.disconnect()

from wx4py import CallbackHandler, MessageEvent, WeChatClient
groups = ["工作群1", "工作群2", "工作群3"]
def on_message(event: MessageEvent):
    print(f"[{event.group}] {event.content}")
    return ""  # 只监听，不自动回复
with WeChatClient(auto_connect=True) as wx:
    wx.process_groups(
        groups,
        [CallbackHandler(on_message)],
        block=True,
    )

from wx4py import AsyncCallbackHandler, MessageEvent, WeChatClient
groups = ["工作群1", "工作群2"]
def reply(event: MessageEvent):
    if not event.is_at_me:
        return ""
    return f"收到：{event.content}"
with WeChatClient(auto_connect=True) as wx:
    wx.process_groups(
        groups,
        [AsyncCallbackHandler(reply, auto_reply=True, reply_on_at=True)],
        block=True,
    )

from wx4py import ForwardRuleHandler, GroupForwardRule, WeChatClient
rules = [
    GroupForwardRule(
        source_group="告警群",
        targets=["值班同学"],
        target_type="contact",
        prefix_template="[告警群] ",
    ),
    GroupForwardRule(
        source_group="项目群A",
        targets=["项目群B"],
        target_type="group",
        prefix_template="[项目群A] ",
    ),
]
with WeChatClient(auto_connect=True) as wx:
    wx.process_groups(
        ["告警群", "项目群A"],
        [ForwardRuleHandler(rules)],
        block=True,
    )

import os
from wx4py import AIClient, AIConfig, AIResponder, AsyncCallbackHandler, WeChatClient
ai = AIClient(
    AIConfig(
        base_url="https://api.example.com/v1",
        api_format="completions",
        model="your-model-id",
        api_key=os.environ["AI_API_KEY"],
        enable_thinking=False,
    )
)
with WeChatClient(auto_connect=True) as wx:
    wx.process_groups(
        ["工作群"],
        [
            AsyncCallbackHandler(
                AIResponder(ai, context_size=8, reply_on_at=True),
                auto_reply=True,
            )
        ],
        block=True,
    )

from wx4py import AsyncCallbackHandler, MessageEvent, WeChatClient
def custom_reply(event: MessageEvent):
    if not event.is_at_me:
        return ""
    # 这里可以调用公司内部接口、其他 AI SDK 或业务系统。
    return f"自定义回复：{event.content}"
with WeChatClient(auto_connect=True) as wx:
    wx.process_groups(
        ["工作群"],
        [AsyncCallbackHandler(custom_reply, auto_reply=True, reply_on_at=True)],
        block=True,
    )

from wx4py import WeChatClient
with WeChatClient() as wx:
    # 自动连接和断开
    wx.chat_window.send_to("文件传输助手", "Hello!")

wx = WeChatClient()
wx.connect()
try:
    # 执行操作
    wx.chat_window.send_to("文件传输助手", "Hello!")
finally:
    wx.disconnect()

from wx4py import WeChatClient
import schedule
import time
def send_daily_notification():
    with WeChatClient() as wx:
        groups = ["工作群1", "工作群2", "工作群3"]
        message = "早安！今日工作提醒..."
        wx.chat_window.batch_send(groups, message, target_type='group')
        print("通知已发送")
# 每天早上9点发送
schedule.every().day.at("09:00").do(send_daily_notification)
while True:
    schedule.run_pending()
    time.sleep(60)

from wx4py import WeChatClient
import json
from datetime import datetime
with WeChatClient() as wx:
    # 获取昨天的聊天记录
    messages = wx.chat_window.get_chat_history(
        target="工作群",
        target_type='group',
        since='yesterday'
    )
    # 保存到文件
    filename = f"chat_history_{datetime.now().strftime('%Y%m%d')}.json"
    with open(filename, 'w', encoding='utf-8') as f:
        json.dump(messages, f, ensure_ascii=False, indent=2)
    print(f"已保存 {len(messages)} 条消息到 {filename}")

from wx4py import WeChatClient
import os
# 准备要发送的文件
files_dir = r"C:\weekly_reports"
files = [os.path.join(files_dir, f) for f in os.listdir(files_dir) if f.endswith('.pdf')]
groups = ["管理群", "开发群", "产品群"]
with WeChatClient() as wx:
    for group in groups:
        print(f"正在向 {group} 发送文件...")
        wx.chat_window.send_file_to(group, files, target_type='group')
        print(f"已完成 {group}")

from wx4py import WeChatClient, WeChatNotFoundError, ControlNotFoundError
try:
    with WeChatClient() as wx:
        wx.chat_window.send_to("目标", "消息")
except WeChatNotFoundError:
    print("错误：未找到微信窗口，请确保微信已打开并登录")
except ControlNotFoundError as e:
    print(f"错误：未找到控件 - {e}")
except Exception as e:
    print(f"未知错误：{e}")