say for Openclaw

A macOS-native text-to-speech skill that leverages the system say command and Siri Natural Voices for professional audio generation.

tobihagemann
v1.0.2
Feb 15, 2026
0
1.7k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install say

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install say 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 say?

The say skill is a developer-centric interface for on-device text-to-speech on macOS. It allows users to programmatically generate speech audio from text strings using the built-in system utility. By utilizing Openclaw Skills, developers can tap into the high-fidelity Siri Natural Voices that are typically restricted to system defaults, enabling more human-like audio outputs than standard TTS engines.

This skill is particularly effective for those who need a local, privacy-focused solution for audio generation without relying on external cloud APIs. It handles everything from simple spoken feedback to complex batch generation of audio clips, providing a bridge between raw text and professional-grade audio files.

say Use Cases

  • Creating automated voiceovers for videos or tutorials directly from Markdown content.
  • Generating notification sounds or spoken alerts for macOS-based automation workflows.
  • Batch processing localized text into audio clips across multiple languages using Siri voices.
  • Building accessibility features that read documentation or terminal output aloud to the user.

How say Works

  1. The skill receives the text input and checks for optional parameters like voice selection or speaking rate.
  2. To use Siri Natural Voices, it utilizes the defaults write command to update the system speech language preference globally.
  3. The macOS say binary is executed to process the text into either live audio or a file output.
  4. If an output file is requested, the system generates a high-quality AIFF file.
  5. Optionally, the skill uses ffmpeg to transcode the AIFF file into widely compatible formats like WAV or MP3.

say Setup

To get started with this component of your Openclaw Skills library, ensure you are running macOS and have the necessary binaries installed:

# Install ffmpeg for audio conversion
brew install ffmpeg

# Configure Siri voices in System Settings > Accessibility > Spoken Content
# Ensure the desired languages are downloaded and set as system defaults

To verify your current voice configuration, run:

defaults read com.apple.Accessibility SpokenContentDefaultVoiceSelectionsByLanguage

say Data Schema & Taxonomy

The skill manages audio output and system configuration through the following schema:

Attribute Description
Output Format Native AIFF; convertible to WAV/MP3 via ffmpeg
Voice Config Managed via com.apple.speech.voice.prefs
Language Strings Uses standard ISO codes (e.g., 'en', 'de', 'cmn', 'fr')
Audio Specs Default 22050 Hz, Mono (adjustable via transcoding)

say Advanced Features

  • Zero-restart language switching: Update the system TTS language on the fly to support multi-lingual Openclaw Skills workflows.
  • Natural prosody: Automatically handles pauses at punctuation marks without requiring manual SSML or sentence splitting.
  • Enhanced Voice Support: Access high-quality 'Enhanced' voice variants through specific voice selection flags.
  • Optimized Batching: Minimal overhead for generating hundreds of clips by managing system defaults efficiently.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins sayffmpeg
Github Stars: 0
forks: 0

Featured*