voxclaw

Send text to a macOS listener for text-to-speech playback.

211|17|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/malpern/VoxClaw --skill voxclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voxclaw
Source: https://github.com/malpern/VoxClaw/tree/main
Command: npx skills add https://github.com/malpern/VoxClaw --skill voxclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, and includes scripts (resource) components.

What problem does it solve?

VoxClaw gives your OpenClaw agent a voice by enabling on-device or cross-machine text-to-speech on macOS, so agents can speak aloud through the user's Mac.

Core Features & Use Cases

  • Cross-machine voice output: run agents elsewhere and have VoxClaw read text on the user's Mac via a LAN HTTP listener.
  • Multiple engines: use Apple TTS by default or OpenAI neural voices with a user-provided API key.
  • Network API & discovery: speak via POST /read, check status with GET /status, and discover on the LAN with Bonjour.
  • Teleprompter overlay & highlighting: synchronized word highlighting to keep speech readable.
  • CLI & URL scheme: trigger speaking via voxclaw CLI or voxclaw:// URL scheme; supports stdin, clipboard, files, and more.
  • iPhone companion app included in VoxClawIOS for cross-platform parity.

Quick Start

Launch VoxClaw on your Mac, enable the network listener, and send a JSON payload to http://<mac-ip>:4140/read to hear your agent speak.

Frequently Asked Questions about voxclaw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable text-to-speech for a remote agent on macOS?

Text-to-speech for a remote agent on macOS is enabled by running a network listener on port 4140 that receives POST requests, allowing remote agents to send text payloads to the Mac for spoken playback.

Can I use OpenAI neural voices for TTS playback on macOS?

Yes, OpenAI neural voices can be used for TTS playback on macOS by providing a user-supplied OpenAI API key, offering an alternative to the default Apple TTS engine.

How do I trigger text-to-speech playback via CLI or URL scheme on macOS?

Text-to-speech playback is triggered via the voxclaw CLI or voxclaw:// URL scheme, supporting input from stdin, the clipboard, or files to generate spoken audio output.

Does cross-machine voice output over a LAN require a specific port?

Yes, cross-machine voice output over a LAN requires a Mac running VoxClaw with a network listener enabled on port 4140 to receive HTTP requests for spoken output.

What is the best way to discover a macOS TTS listener on a local network?

A macOS TTS listener is discovered on a local network using Bonjour, which provides automatic network discovery for the device running the text-to-speech listener.

Are there limitations when using Apple TTS compared to OpenAI voices for agent speech?

Apple TTS works locally without external dependencies, while OpenAI neural voices require a user-provided API key and network connectivity to generate higher quality speech output.