A local Windows TTS engine that leverages window messages to read AI responses in real-time with zero token costs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tts-winmsg-free
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 tts-winmsg-free 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 winmsg-tts: Local Windows Text-to-Speech?
The winmsg-tts extension is a specialized utility for the Windows environment that enables high-performance, local text-to-speech capabilities. By utilizing the WM_COPYDATA protocol, it streams AI-generated text to a dedicated mini-window for immediate narration. This skill is part of the Openclaw Skills ecosystem, designed for developers who need privacy-focused, zero-latency audio feedback without relying on external cloud APIs or incurring token usage fees.
Built with Python and the native Windows Speech API, this tool provides a seamless bridge between your AI agent's output and your system's audio hardware. It features an unobtrusive 320x90 pixel overlay that stays on top of other windows, providing both visual and auditory confirmation of the AI's response progress.
winmsg-tts: Local Windows Text-to-Speech Use Cases
- Narrating AI assistant responses in real-time for multitasking or eyes-busy scenarios.
- Building local, voice-enabled desktop agents using Openclaw Skills.
- Accessibility support for reading long AI-generated explanations aloud automatically.
- Developing interactive Windows-based tools that require low-latency audio feedback without internet dependency.
How winmsg-tts: Local Windows Text-to-Speech Works
- Activation: The user triggers reading mode, which launches the winmsg-tts server (wmserver_20260327.py) and initializes a mini-window.
- Message Capture: As the AI generates content, Openclaw Skills capture the text and pass it to the sender script.
- Protocol Transmission: The sender script (sendmsg_hwnd.py) uses the WM_COPYDATA message and Base64 encoding to securely pass the string to the window handle.
- Intelligent Queueing: The receiver splits the text into sentences based on punctuation and adds them to a playback queue to prevent overlapping audio.
- Speech Synthesis: The System.Speech.Synthesis engine processes the queue while the UI label updates in real-time to match the spoken sentence.
winmsg-tts: Local Windows Text-to-Speech Setup
To integrate this into your environment, ensure you are running Windows and follow these steps:
# Install the necessary Windows API wrapper
pip install pywin32
# Launch the TTS receiver server
python scripts/wmserver_20260327.py
# Test the speech output from the command line
python scripts/sendmsg_hwnd.py "Hello, this is a test of the Openclaw Skills TTS integration."
# To close the TTS engine
python scripts/sendmsg_hwnd.py --quit
winmsg-tts: Local Windows Text-to-Speech Data Schema & Taxonomy
The skill manages its state and configuration through local text files to ensure persistence across sessions:
| File Path | Description | Data Type |
|---|---|---|
| config/tts_speed.txt | Stores the current speech rate | Integer (-10 to 10) |
| config/volume.txt | Stores the current audio volume | Integer (0 to 100) |
| config/wmserver_hwnd.txt | Stores the current Windows HWND for message routing | Hexadecimal String |
All audio processing is handled locally via the Windows SpeechSynthesizer engine, ensuring no text data leaves the machine.
winmsg-tts: Local Windows Text-to-Speech Advanced Features
- Intelligent Sentence Segmentation: Automatically splits complex AI responses into natural phrases using Chinese and English punctuation marks.
- Queue Management: Multi-sentence responses are queued sequentially to ensure smooth, non-interruptive playback.
- Config Persistence: Speed and volume sliders on the UI save settings immediately to local files, restoring them automatically upon restart.
- Stealth Execution: Uses CREATE_NO_WINDOW and Base64 encoding to prevent PowerShell popups from interrupting the user experience in Openclaw Skills.
- Precision Termination: Supports a specific quit command that targets only the TTS window handle, avoiding conflicts with other running Python processes.
SKILL.md
Loading
Related Openclaw Skills
WeChat Publisher
An automated solution for curating AI news and publishing formatted drafts directly to WeChat Official Accounts.
Remote Install Skill
A powerful automation tool for detecting and installing Windows software packages through GUI automation and silent installers.
Radar Collision Warning
An AI agent skill that enables real-time Lidar obstacle detection and collision warnings by connecting to ROS2 services on a Raspberry Pi.
Paper Trading Plan Generator
A specialized tool for generating comprehensive, structured paper trading plans for indices and US equity options.
Group Finance Capability Model
A structured analytical framework providing six core dimensions of corporate finance expertise for AI knowledge bases and talent evaluation.
Financial Competency Gap Analysis & IDP
A strategic tool designed to identify professional gaps and generate actionable Individual Development Plans for finance experts.
Featured*
