🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί hotbutter voice chat
πŸ¦€ ClawHub

hotbutter voice chat

by @michael-stajer

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.

Versionv1.0.6
Downloads831
#clawhub
TERMINAL
clawhub install hotbutter

πŸ“– About This Skill

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 -m on your machine 6. The agent's text response is sent back through the relay and spoken via browser TTS

    Usage

    # 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.

    πŸ’‘ Examples

    # 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 |