A Python-based automation tool that leverages AppleScript and cliclick to automatically send files, images, videos, and messages via desktop WeChat on macOS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mac-wechat-sender
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mac-wechat-sender using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is macOS WeChat Sender?
The macOS WeChat Sender is a highly efficient desktop automation skill designed specifically for Apple macOS users. Powered by a combination of AppleScript and the cliclick command-line utility, this skill allows users to programmatically dispatch text messages, documents, images, and videos directly through the official macOS WeChat desktop application without requiring web scrapers, browser-based interfaces, or unsafe API workarounds.
By integrating this tool into your automation suite with Openclaw Skills, developers can bridge the gap between AI-driven file generation and instant messenger communication. Whether you are distributing automated daily reports, sending freshly rendered video files, or dispatching urgent server alerts, this skill streamlines your messaging workflow by replicating native macOS user actions safely and securely.
macOS WeChat Sender Use Cases
- Automated Report Distribution: Automatically send newly generated PDF reports, spreadsheets, or analytical datasheets to specific contacts or work groups as soon as they are compiled.
- Content Pipeline Delivery: Programmatically send exported MP4 videos, audio tracks, or images to WeChat contacts immediately after creation.
- Status Alerts and Notifications: Dispatch automated text updates to group chats or individual users (e.g., system status updates or personal safety check-ins).
- Hands-Free AI Orchestration: Deliver media assets generated by autonomous agents directly to target audiences using Openclaw Skills for end-to-end publishing pipeline steps.
How macOS WeChat Sender Works
- Activate WeChat: The skill brings the WeChat desktop window to the foreground using macOS command-line automation (initiating
open -a WeChatif the process is not already running). - Search Contact: It triggers the global search hotkey
Cmd+Shift+F, inputs the designated contact or group name, and strikes Enter to open the targeted chat window. - Handle Attachment (Optional): If a file path is provided, it highlights the file in Finder, programmatically copies it (
Cmd+C), focuses the WeChat input field, pastes it (Cmd+V), and presses Enter to transmit. - Transmit Message (Optional): If a text payload is provided, it inputs the text directly into the active chat area and presses Enter to send.
macOS WeChat Sender Setup
Prerequisites
Ensure you are running macOS and have the official WeChat desktop application installed and logged in. You will also need to install cliclick via Homebrew for simulating mouse click coordinates.
brew install cliclick
Running the Script
Execute the Python script using your terminal. This skill can be integrated natively with your setup of Openclaw Skills:
# Send a file to the default contact
python3 scripts/skills/wechat-sender/wechat_sender.py --file "output/video/final/video_output.mp4"
# Send a file to a specific contact
python3 scripts/skills/wechat-sender/wechat_sender.py --contact "John Doe" --file "report.pdf"
# Send a text message to a contact
python3 scripts/skills/wechat-sender/wechat_sender.py --contact "Jane" --message "Hello! The script successfully executed."
# Send a message to a group chat
python3 scripts/skills/wechat-sender/wechat_sender.py --contact "Work Group" --message "Daily report update" --group
Custom Shortcuts
To configure quick access within your AI agent environment, set up the custom shortcut command:
/wechat-send
macOS WeChat Sender Data Schema & Taxonomy
Command Line Arguments
The wechat_sender.py script accepts the following parameters to format and direct the execution payload:
| Argument | Type | Required | Description |
|---|---|---|---|
--contact |
String | No | The target user contact name or group chat name. Defaults to a pre-configured contact name if omitted. |
--file |
String | No | The absolute or relative path to the file (e.g., PDF, MP4, JPEG) you want to send. |
--message |
String | No | The text message payload to transmit. |
--group |
Flag | No | Explicit flag to optimize search and navigation specifically for WeChat group chat windows. |
Screen Coordinates Calibration
Because this tool relies on desktop mouse coordinates to focus WeChat's text input box (using cliclick c:600,750), you may need to adjust the coordinates in the source script to match your specific screen resolution and WeChat interface layout constraints.
macOS WeChat Sender Advanced Features
- Coordinate Customization: Highly adaptable coordinate mapping to align with multiple screen resolutions, DPI scaling, and dual-monitor configurations.
- Intelligent Window Activation: AppleScript hooks verify if WeChat is running, launching or bringing it to focus safely without throwing exceptions.
- Direct Media Embedding: Fully supports native copy-paste routines, allowing direct pasting of high-definition videos, images, and heavy office files to bypass typical browser upload limits.
- Autonomous Agent Integration: Features robust scripting hooks for AI workflows, allowing quick installation and coordination as part of autonomous workflows managed through Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Mensa Canteen Menu
A zero-config python agent tool that retrieves daily lunch menus from German university canteens via the public OpenMensa API.
Workflow Refactor
A systematic methodology to strip away human-limiting coordination layers and reconstruct complex workflows into highly efficient, AI-assisted end-to-end pipelines.
competitor-change-monitor
An automated competitive intelligence agent that monitors competitor websites, tracks critical updates, and delivers strategic reports directly to your team.
Bid Assistant
An AI-powered digital employee designed to automate the entire bidding lifecycle, from opportunity assessment and document parsing to scoring alignment, drafting, and risk review.
Finance Assistant
An intelligent financial assistant that automates invoice parsing, multi-company tax header mapping, and reimbursement tracking.
DB Explorer
A database inspection and querying skill that connects to PostgreSQL, MySQL, SQLite, MongoDB, and Redis to check schemas, run queries, and export results.
Featured*
