Aidotnet Opencowork Wechat UI Sender

WeChat UI Sender

Automate the Windows WeChat client to push messages from an AI Agent to a specific contact or group using UI-level simulation.

When to use this skill

• Need to notify a person or group in personal WeChat (non-enterprise) from an AI workflow.
• No access to official WeChat/WeCom APIs, so UI automation is acceptable.
• Want basic auditing via optional screenshots after each send.
• WeChat may be closed, minimized to tray, or not running — script can auto-launch.

Avoid this skill if an official API (WeCom bot/app) is available—API integrations are more stable and secure.

Requirements

1. Windows desktop with the WeChat PC client installed and logged in.
2. Python 3.9+ environment with:

   pip install pyautogui pyperclip pygetwindow pillow psutil
   

3. Resolution scaling should be 100% for best accuracy.
4. Skill runner must allow clipboard access (pyperclip) and simulated keyboard shortcuts.

New features

• Auto-launch: Use --force-launch to automatically start WeChat if not running.
• Tray recovery: Script detects minimized/tray state and attempts restoration.
• Retry logic: Configurable retry attempts with --max-retries and --retry-delay.
• Status check: Use --check-only to verify WeChat status without sending.

Scripts overview

Usage steps

1. Install dependencies (first time only)

   pip install pyautogui pyperclip pygetwindow pillow psutil
   

2. Basic usage - Write message to a markdown file first, then send

   # Create a message file first
   echo "Your message here" > message.md
   
   # Send using the markdown file
   python scripts/send_wechat.py "CONTACT_OR_GROUP_NAME" --file message.md
   

3. Auto-launch if closed

   python scripts/send_wechat.py "Group Name" --file message.md --force-launch
   

4. Check WeChat status

   python scripts/send_wechat.py "dummy" --file message.md --check-only
   

5. Full options

   python scripts/send_wechat.py "CONTACT_OR_GROUP_NAME" \
       --file "C:\\path\\to\\message.md" \
       --window-title "微信" \
       --search-delay 0.6 \
       --typing-delay 0.2 \
       --screenshot-dir C:\\temp\\wechat-captures \
       --force-launch \
       --max-retries 5 \
       --retry-delay 3.0 \
       --confirm
   

Command options

Important: This script ONLY supports sending markdown files. Use --file to specify the path to your message file. Plain text messages are no longer supported directly.

Auto-launch paths

The script attempts to launch WeChat from these locations in order:

1. %ProgramFiles%\Tencent\WeChat\WeChat.exe
2. %ProgramFiles(x86)%\Tencent\WeChat\WeChat.exe
3. %LocalAppData%\Programs\WeChat\WeChat.exe
4. C:\Program Files\Tencent\WeChat\WeChat.exe
5. C:\Program Files (x86)\Tencent\WeChat\WeChat.exe
6. D:\Program Files\Tencent\WeChat\WeChat.exe

Safety notes

• Add an approval gate before sending to prevent accidental messages.
• Keep message length moderate; pyperclip pastes full content but huge payloads may fail.
• UI automation is fragile—theme or layout changes may require timing tweaks.
• For reliability, keep WeChat logged in and unlocked.
• Auto-launch requires WeChat to be installed in a standard location.

Troubleshooting

Exit codes

File list

• SKILL.md — this manifest & instructions
• scripts/send_wechat.py — automation script

Converted and distributed by TomeVault — claim your Tome and manage your conversions.