hotbutter voice chat

Enables local voice chat by embedding Hotbutter relay server and PWA, providing speech-to-text and text-to-speech via a secure, self-hosted connection.

Hotbutter Voice Skill (Hosted Relay)

This skill routes data through hotbutter.ai. Voice transcripts and agent responses are transmitted through the hosted relay server at wss://hotbutter.ai. This is a convenience skill — not a private or local-only solution.

For a fully local alternative where no data leaves your machine, see hotbutter-os.

For updates, follow @DnuLkjkjh.

Privacy & Data Flow

Data that transits through hotbutter.ai:

• Transcribed speech text (from browser speech-to-text)
• Agent response text (stdout from your local openclaw binary)

Warning: If your agent prints sensitive information (secrets, credentials, private data), that output will be sent through the relay. Avoid running agents that output secrets, or use --relay-url to point to a relay you control.

Data that stays local:

• Raw audio (processed in the browser, never transmitted)
• The openclaw binary execution (runs on your machine)
• Config file (~/.hotbutter)

Required Dependencies

• openclaw CLI — must be installed and on your PATH

How It Works

1. This skill connects via WebSocket to wss://hotbutter.ai
2. A pairing code and URL (https://hotbutter.ai/app?code=XXXXXX) are printed
3. Open the URL in your browser to start a voice session
4. Browser speech-to-text converts your voice to text, sent through the relay to this skill
5. This skill executes openclaw agent --session-id <id> -m <text> on your machine
6. The agent's text response is sent back through the relay and spoken via browser TTS

Usage

bash

# Start (connects to hotbutter.ai by default)
voice-bridge start

# Use your own relay for privacy
voice-bridge start --relay-url wss://your-relay.example.com

# Custom agent display name
voice-bridge start --agent-name "My Agent"

Configuration

Option	Default	Description
--relay-url	wss://hotbutter.ai	Relay WebSocket URL. Change this to use your own relay.
--agent-name	Agent	Display name shown in the voice client

First Run

On first run, the skill will prompt for an optional email (stored locally in ~/.hotbutter). Subsequent runs connect immediately.