A sophisticated text-to-speech skill that generates emotional AI voices using Qwen3-TTS and broadcasts them directly to Apple HomePod via Home Assistant.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install homepod-tts
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 homepod-tts 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 HomePod TTS?
HomePod TTS is a powerful integration designed to bring high-fidelity AI voice capabilities to your smart home environment. By utilizing the advanced Qwen3-TTS model, this skill converts text into expressive audio that captures specific emotional nuances such as happiness, excitement, or urgency. It is an essential addition to the collection of Openclaw Skills for users looking to create more immersive and interactive voice-first experiences through their Apple hardware.
The skill handles the entire pipeline from sentiment analysis to audio hosting and media playback. It ensures that voice responses aren't just robotic announcements but contextually aware interactions that enhance the personality of your AI agent. Whether for notifications or full-scale conversations, it provides a seamless bridge between LLM outputs and physical audio hardware.
HomePod TTS Use Cases
- Broadcasting AI-generated announcements throughout a smart home using Apple HomePod.
- Enabling an AI agent to 'talk back' with human-like emotions during interactions.
- Sending context-aware voice notifications that reflect the urgency or mood of the message.
- Automating personalized greetings or reminders triggered by smart home events.
How HomePod TTS Works
- The skill analyzes the input text using built-in keyword mapping to identify the appropriate emotion.
- It calls the Qwen3-TTS engine to synthesize a high-quality WAV audio file matching the detected sentiment.
- A local HTTP service is initialized to serve the audio file to the local network.
- It sends a request to Home Assistant's media_player.play_media service to stream the file to the target HomePod.
- The skill dynamically manages HomePod volume, setting it to 40% for playback and restoring the original volume once finished.
HomePod TTS Setup
To get started with this entry in the Openclaw Skills library, follow these steps:
- Ensure you have a functioning Home Assistant instance with your HomePod integrated.
- Install the Qwen3-TTS model and dependencies in your environment.
- Configure your environment variables for Home Assistant API access and local file serving.
# Example setup for dependencies
pip install qwen3-tts-provider
# Ensure Home Assistant connection is verified
HomePod TTS Data Schema & Taxonomy
The skill manages audio data and state transitions through the following schema:
| Property | Type | Description |
|---|---|---|
| Emotion Map | Object | Maps text keywords to specific Qwen3-TTS emotional presets. |
| Audio Format | String | WAV (lossless) for high-fidelity playback. |
| Volume State | Integer | Tracks and restores previous HomePod volume levels. |
| Duration | Float | Calculated as (Audio Length + 1s) for dynamic process management. |
HomePod TTS Advanced Features
- Automatic sentiment analysis for 12+ distinct emotional states including Excitement, Surprise, and Serenity.
- Intelligent volume normalization that auto-adjusts to 40% and reverts post-playback to prevent sudden loud noises.
- Dynamic waiting logic that calculates exact audio length to ensure the process remains active until the speech is finished.
- Multi-system compatibility leveraging Home Assistant for broad Apple HomePod ecosystem support.
SKILL.md
Loading
Related Openclaw Skills
Exa Search
A high-performance neural search and web content retrieval tool powered by Exa AI for AI agents.
WordPress Remote News Publisher
An automated pipeline for generating journalist-quality news articles and publishing them to remote WordPress sites via SSH.
ez-cronjob
A comprehensive troubleshooting and optimization guide to ensure scheduled tasks and automated messages run reliably within Clawdbot and Moltbot environments.
Clawality
A psychometric personality assessment platform designed specifically for AI agents to discover their unique behavioral type and interact with others.
NapCat QQ
A specialized tool for Openclaw agents to send QQ messages via the NapCat plugin API with automated session management.
Apify Competitor Intelligence
Automate deep-dive competitor analysis across social media, maps, and travel platforms using Apify Actors.
Featured*
