clack
Deploy and manage Clack, a voice relay server for OpenClaw. Bridges voice input (WebSocket) through STT → OpenClaw agent → TTS, enabling real-time voice conversations with your agent. Supports ElevenLabs, OpenAI, and Deepgram for STT/TTS. Per-session provider selection — users can independently choose STT and TTS providers (including on-device) from the app settings. Encrypted connections via Domain (SSL) or Tailscale. Supports local speech mode where STT/TTS run on-device and only LLM calls go through the server. Use when a user wants to set up voice chat, voice relay, voice interface, Clack, or talk to their agent by voice.
Why use this skill?
Enable real-time voice conversations with your OpenClaw agent. Clack supports ElevenLabs, OpenAI, Deepgram, and on-device STT/TTS with secure SSL or Tailscale.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/fbn3799/clackWhat This Skill Does
Clack is a specialized WebSocket relay server for OpenClaw that functions as a real-time voice interface bridge. It acts as the middleware between your voice input and the OpenClaw agent, handling the complexities of audio stream orchestration. The system processes client audio—standardized at PCM 16kHz/16-bit/mono—through a chain of Speech-to-Text (STT) services, feeds the text into the OpenClaw agent, and returns the agent's response through a Text-to-Speech (TTS) engine. A standout feature of Clack is its support for per-session provider selection, allowing users to mix and match on-device Apple speech frameworks with premium cloud services like ElevenLabs, OpenAI, and Deepgram. This flexibility ensures you can optimize for either high-fidelity cloud voices or low-latency, private, on-device processing depending on your specific needs.
Installation
Installation is streamlined through the OpenClaw CLI and a comprehensive setup script. First, run the command clawhub install openclaw/skills/skills/fbn3799/clack to download the skill. Navigate to the installation directory and run sudo bash scripts/setup.sh. This script will create a virtual environment, install necessary dependencies, and prompt you for API keys. During setup, you can define the server port (default 9878) and configure an optional domain. If you provide a domain, the script automatically configures SSL via Caddy to support secure WebSocket (WSS) connections. Alternatively, you can run the service over a Tailscale network for secure, encrypted private communication without needing a public domain.
Use Cases
Clack is designed for users who want to move beyond text-based interaction and build a conversational AI assistant. Common use cases include: 1) Creating a hands-free voice interface for smart home automation via OpenClaw. 2) Developing a low-latency, real-time therapy or roleplay companion that requires natural voice responsiveness. 3) Building a personal assistant that maintains strict privacy for local conversations while allowing high-quality cloud-based TTS for public-facing interactions. It is the definitive skill for any project requiring audio input-output capabilities.
Example Prompts
- "OpenClaw, setup my voice relay server on port 9878 using Deepgram for speech recognition."
- "Can you help me configure the Clack skill so that my agent uses ElevenLabs for a more natural voice?"
- "Show me how to toggle between local on-device speech and cloud providers in the Clack settings menu."
Tips & Limitations
To ensure peak performance, always firewall port 9878 to avoid unauthorized access. Use Caddy with a custom domain for the best balance of security and ease of use. Remember that local speech mode significantly reduces latency but may be limited by the computational resources of your host device. Ensure the OpenClaw Gateway has the chatCompletions endpoint enabled in your configuration file, or the relay will fail to transmit data to the agent. If you experience audio stuttering, check your network latency to the chosen STT/TTS provider.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-fbn3799-clack": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, external-api