[Integrations](https://spiral.ai/integrations) › [OpenClaw](https://spiral.ai/integrations/openclaw) › [Chatterbox HD](https://spiral.ai/integrations/openclaw/chatterbox-hd)

# How to Use Chatterbox HD in OpenClaw

Chatterbox HD turns English scripts into expressive narration or character dialogue, with voice cloning from a short recording. It produces 24 kHz audio, with optional upscaling to 48 kHz.

|  |  |
| --- | --- |
| Model | Chatterbox HD |
| Available through | fal |
| Category | Audio |
| Price | Each item in `text` adds $0.052. |
| Returns | audio |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Chatterbox HD in OpenClaw

- Each weekday morning, summarize the public astronomy news from the past day in 80 English words. Generate a spoken edition with Chatterbox HD using emotional intensity and guidance both at 0.5.
- Every Friday, write a short English introduction to the weekend's visible planets using current public astronomy information. Read it with Chatterbox HD at ordinary speech settings and keep the script with the audio.
- Each Monday, write a 70-word English lesson explaining one common gardening term. Generate narration with Chatterbox HD and request 48 kHz upscaling.
- Every evening, write a three-sentence English mystery scene and generate a dramatic reading with Chatterbox HD. Use emotional intensity around 0.7 and guidance around 0.3.
- Each Sunday, prepare a short English introduction to the next week's public space launches. Generate an audio draft with Chatterbox HD using ordinary speech settings, and list proper names for pronunciation review.

## How to set up Chatterbox HD in OpenClaw

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send OpenClaw this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Add the server**: On the machine that runs OpenClaw's Gateway:

```bash
openclaw mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --transport streamable-http \
  --auth oauth
```

2. **Sign in**: In Settings › MCP, select Sign in on the Spiral server, sign in to Spiral and click Authorize. No API key.

```bash
openclaw mcp login spiral
```

3. **Reload and check**: A running Gateway may keep its old tool list: restart it, or Save & Publish in the Control UI.

```bash
openclaw mcp reload
openclaw mcp doctor spiral --probe
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Chatterbox HD**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "resemble-ai/chatterboxhd/text-to-speech",
    "input": {
      "text": "My name is Maximus Decimus Meridius, commander of the Armies of the North, General of the Felix Legions and loyal servant to the true emperor, Marcus Aurelius. Father to a murdered son, husband to a murdered wife. And I will have my vengeance, in this life or the next."
    }
  }'
```

Then paste one of the prompts above: OpenClaw finds Chatterbox HD on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/openclaw

## Chatterbox HD tools and prices

- [Chatterboxhd · Text to Speech](https://spiral.ai/tools/fal/resemble-ai/chatterboxhd/text-to-speech) (fal): $0.052 per 1,000 characters of `text`. Rounded up to the next 1,000 characters, minimum 1,000.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| text |  | My name is Maximus Decimus Meridius, commander of the Armies of the North, General of the Felix Legions and loyal servant to the true emperor, Marcus Aurelius. Father to a murdered son, husband to a murdered wife. And I will have my vengeance, in this life or the next. | Text to synthesize into speech. |
| voice | Aurora, Blade, Britney, Carl, Cliff, Richard, Rico, Siobhan, Vicky | — | The voice to use for the TTS request. If neither voice nor audio are provided, a random voice will be used. |
| audio_url |  | — | URL to the audio sample to use as a voice prompt for zero-shot TTS voice cloning. Providing a audio sample will override the voice setting. If neither voice nor audio_url are provided, a random voice will be used. |
| exaggeration | 0.25 to 2 | 0.5 | Controls emotion exaggeration. Range typically 0.25 to 2.0. |
| cfg | 0 to 1 | 0.5 | Classifier-free guidance scale (CFG) controls the conditioning factor. Range typically 0.2 to 1.0. For expressive or dramatic speech, try lower cfg values (e.g. ~0.3) and increase exaggeration to around 0.7 or higher. If the reference speaker has a fast speaking style, lowering cfg to around 0.3 can improve pacing. |
| high_quality_audio |  | false | If True, the generated audio will be upscaled to 48kHz. The generation of the audio will take longer, but the quality will be higher. If False, the generated audio will be 24kHz. |

## What can you do with Chatterbox HD in OpenClaw?

Produce recurring spoken English briefings with Chatterbox HD. A scheduled agent can prepare a fresh script each run and generate a listening edition for review.

### Product walkthrough narration

Turn an English walkthrough script into spoken instructions. Start with ordinary speech settings and review each instruction for clarity.

### Game dialogue auditions

Generate separate reads of a character's lines. Compare ordinary and more dramatic delivery before choosing a performance.

### Podcast introductions

Create a spoken introduction from an approved English script, using a short recording of the host as the voice reference.

### Training lesson voiceovers

Produce narration for individual lesson sections. Review the pacing before pairing the audio with slides or demonstrations.

### Spoken daily briefings

Convert a prepared English summary into a listening edition for a morning or evening briefing.

### Ad script auditions

Hear how the same copy sounds with ordinary and heightened emotional delivery. Check whether greater intensity makes the message feel rushed.

### Short story narration

Create spoken readings of English story passages using a narrator reference. Audition dramatic settings on tense scenes before applying them more widely.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All OpenClaw guides](https://spiral.ai/integrations/openclaw)

## Chatterbox HD in other agents

- [Amp](https://spiral.ai/integrations/amp/chatterbox-hd)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/chatterbox-hd)
- [Claude](https://spiral.ai/integrations/claude-desktop/chatterbox-hd)
- [Claude Code](https://spiral.ai/integrations/claude-code/chatterbox-hd)
- [Cline](https://spiral.ai/integrations/cline/chatterbox-hd)
- [Codex](https://spiral.ai/integrations/codex/chatterbox-hd)
- [Cursor](https://spiral.ai/integrations/cursor/chatterbox-hd)
- [Devin](https://spiral.ai/integrations/devin/chatterbox-hd)
- [dots](https://spiral.ai/integrations/dots/chatterbox-hd)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/chatterbox-hd)
- [Gemini](https://spiral.ai/integrations/gemini/chatterbox-hd)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/chatterbox-hd)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/chatterbox-hd)
- [goose](https://spiral.ai/integrations/goose/chatterbox-hd)
- [Grok](https://spiral.ai/integrations/grok/chatterbox-hd)
- [Grok Build](https://spiral.ai/integrations/grok-build/chatterbox-hd)
- [Hermes](https://spiral.ai/integrations/hermes/chatterbox-hd)
- [Instinct](https://spiral.ai/integrations/instinct/chatterbox-hd)
- [Manus](https://spiral.ai/integrations/manus/chatterbox-hd)
- [Muse](https://spiral.ai/integrations/muse/chatterbox-hd)
- [Muse Code](https://spiral.ai/integrations/muse-code/chatterbox-hd)
- [n8n](https://spiral.ai/integrations/n8n/chatterbox-hd)
- [Notion](https://spiral.ai/integrations/notion/chatterbox-hd)
- [opencode](https://spiral.ai/integrations/opencode/chatterbox-hd)
- [Perplexity](https://spiral.ai/integrations/perplexity/chatterbox-hd)
- [Raycast](https://spiral.ai/integrations/raycast/chatterbox-hd)
- [VS Code](https://spiral.ai/integrations/vscode/chatterbox-hd)
- [Windsurf](https://spiral.ai/integrations/windsurf/chatterbox-hd)
- [Zapier](https://spiral.ai/integrations/zapier/chatterbox-hd)

## More OpenClaw guides

- [CassetteAI Sound Effects Generator](https://spiral.ai/integrations/openclaw/cassetteai-sound-effects-generator)
- [Chatterbox HD Speech to Speech](https://spiral.ai/integrations/openclaw/chatterbox-hd-speech-to-speech)
- [CassetteAI Music Generator](https://spiral.ai/integrations/openclaw/cassetteai-music-generator)
- [Chatterbox Multilingual](https://spiral.ai/integrations/openclaw/chatterbox-multilingual)
- [Canary Speech-to-Text Turbo](https://spiral.ai/integrations/openclaw/canary-speech-to-text-turbo)
- [Chatterbox Speech to Speech](https://spiral.ai/integrations/openclaw/chatterbox-speech-to-speech)

## Questions about Chatterbox HD in OpenClaw

**Can OpenClaw use Chatterbox HD?**

Yes. Add Spiral to OpenClaw as an MCP server, and OpenClaw can find and run Chatterbox HD like any built-in tool.

**How much does Chatterbox HD cost in OpenClaw?**

Each item in `text` adds $0.052. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your OpenClaw plan is separate.

**Do I need a fal account to use Chatterbox HD in OpenClaw?**

No. Spiral runs Chatterbox HD on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Chatterbox HD in OpenClaw?**

About two minutes: add the server, then sign in, then reload and check.

**Does OpenClaw wait while Chatterbox HD runs?**

Chatterbox HD runs in the background. OpenClaw starts the run, checks on it and gives you the audio when it's ready.

**Which languages does Chatterbox HD support?**

The HD documentation specifies English text only. Keep scripts in English.

**Does Chatterbox HD generate native 48 kHz audio?**

The higher-quality setting upscales the generated audio to 48 kHz. Without it, output is 24 kHz.

**What makes a good voice reference for Chatterbox HD?**

Use a clean recording of one speaker. Chatterbox HD can clone from short audio, so choose a clear excerpt without competing voices.

**How should I tune Chatterbox HD for dramatic dialogue?**

Try emotional exaggeration around 0.7 and guidance around 0.3. Compare the result with an ordinary read before increasing the intensity further.

**Why does a more expressive Chatterbox HD read sound faster?**

Higher exaggeration tends to accelerate speech. Lowering guidance can help restore slower, more deliberate pacing.

