openclaw-murf-tts

Community-managed plugin that adds Murf Falcon TTS to OpenClaw.

OpenClaw speech-provider plugin for Murf AI. Adds the murf speech provider to your OpenClaw workspace, calling the FALCON model (low-latency, ~130 ms) for high-quality, natural-sounding voice output. No local TTS stack required.

Features

• 150+ voices across 35 languages
• 12 regional API endpoints for low-latency routing
• Built-in retry with exponential backoff for 429 and 5xx errors
• Typed errors (MurfAuthError, MurfRateLimitError, ...) for clean failure handling
• API key automatically redacted from logs

Install

From ClawHub (recommended):

openclaw plugins install clawhub:openclaw-murf-tts

Or directly from npm:

npm install openclaw-murf-tts

openclaw is a peer dependency; your gateway/workspace already provides it.

Quick start

1. Get a Murf API key from the Murf API dashboard.

2. Export the key:

   # macOS / Linux
   export MURF_API_KEY="your_key_here"
   
   # Windows PowerShell
   $env:MURF_API_KEY = "your_key_here"
   

3. Enable the plugin and select Murf as the TTS provider:

   openclaw config set plugins.entries.openclaw-murf-tts.enabled true
   openclaw config set messages.tts.provider murf
   

4. Restart and verify:

   openclaw gateway restart
   openclaw plugins list
   

That's it. The plugin runs with sensible defaults (en-US-natalie voice, FALCON model, MP3 output, 24 kHz).

Customizing the voice

Persist a setting with openclaw config set

openclaw config set messages.tts.providers.murf.voiceId en-US-jackson
openclaw config set messages.tts.providers.murf.style Newscast
openclaw config set messages.tts.providers.murf.rate 10
openclaw config set messages.tts.providers.murf.region us-east

Restart the gateway after changes (openclaw gateway restart).

Override per message with an in-message directive

Tweak parameters inline for a single reply without touching config:

@tts voiceid=en-US-jackson style=Newscast rate=10 pitch=-5

Supported keys: voiceid, model, style, rate, pitch, locale, format. Each respects your SpeechModelOverridePolicy flags.

Edit the JSON config directly

{
  "messages": {
    "tts": {
      "provider": "murf",
      "providers": {
        "murf": {
          "voiceId": "en-US-jackson",
          "style": "Newscast",
          "rate": 10,
          "region": "us-east"
        }
      }
    }
  },
  "plugins": {
    "enabled": true,
    "entries": {
      "openclaw-murf-tts": { "enabled": true }
    }
  }
}

Configuration reference

All fields live under messages.tts.providers.murf. All are optional; defaults are shown.

Regions: au, ca, eu-central, global, in, jp, kr, me, sa-east, uk, us-east, us-west.

Voices

Browse the full catalog in the Murf Falcon voice library.

Or list them from the CLI (requires the Murf provider active and a valid key):

openclaw tts voices

A voice ID looks like en-US-natalie, en-UK-harry, es-ES-elvira, etc.

Troubleshooting

Development

git clone https://github.com/sanchitasunil/murf-openclaw-plugin.git
cd murf-openclaw-plugin
pnpm install
pnpm build
pnpm test

Live tests in tests/live/ hit the real Murf API. They self-skip unless both MURF_LIVE_TEST=1 and MURF_API_KEY are set:

MURF_LIVE_TEST=1 MURF_API_KEY=your_key pnpm test

Links

• Plugin on ClawHub
• Package on npm
• Murf API
• Murf API dashboard
• Murf Falcon voice library

License

MIT. See LICENSE.