Spiral gives your agent every tool with one account. Browse the tools →

OpenClaw · AudioReleased 2025-12-30

How to Use SAM Audio in OpenClaw

Use SAM Audio to extract speech, instruments, or sound effects from a mixed recording by describing the sound. It returns the requested sound and a separate track containing everything else.

Prompts to try with SAM Audio in OpenClaw

Copy an example into OpenClaw, or ask in your own words.

Every weekday, use SAM Audio to extract 'speech' from newly submitted interview recordings. Keep both returned tracks with each recording for editorial review.

SAM AudioOpenClaw
Try asking
  • Each evening, use SAM Audio on new podcast recordings to extract 'dog barking' with automatic sound timing enabled. Collect the remaining-audio tracks for review before publication.

  • Every Monday, use SAM Audio to extract 'piano playing' from newly submitted rehearsal recordings. Leave automatic sound timing off and collect the piano tracks for the music coach.

  • Each morning, use SAM Audio to extract 'car honking' from new location recordings. Enable automatic detection of when the sound occurs and retain both returned tracks.

  • After each weekly recording session, use SAM Audio to extract 'singing voice' from the submitted song recordings. Generate and rank three candidates per recording and collect the selected results for listening.

How to set up SAM Audio 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:

    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.

    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.

    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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run SAM Audio

    One request; the result comes back by polling or a webhook.

    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": "fal-ai/sam-audio/separate",
        "input": {
          "audio_url": "https://v3b.fal.media/files/b/0a88511f/tUUCI9eDmeC2RqJEOXrZk_assets_avatar_multi_sing_woman.WAV",
          "prompt": "piano playing"
        }
      }'

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

SAM Audio providers and prices

Spiral runs SAM Audio through fal. Open a card for today's price, with every fee included.

falAudio

Settings you can ask for

SAM Audio works from your audio URL and prompt. Ask OpenClaw for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Predict spanson or offoff

Automatically predict temporal spans where the target sound occurs.

Reranking candidates1 to 71

Number of candidates to generate and rank. Higher improves quality but increases latency and cost.

Accelerationfast, balanced, or qualitybalanced

The acceleration level to use.

Max chunk duration10 to 6060

Maximum audio duration (in seconds) to process in a single pass. Longer audio will be chunked with overlap and blended.

Chunk overlap0 to 305

Overlap duration (in seconds) between chunks for crossfade blending.

Output formatwav or mp3wav

Output audio format.

Every API field of SAM Audio · Text-Prompted Sound Separation is on its tool page: open its card above.

What can you do with SAM Audio in OpenClaw?

Prepare described sound separations from recurring recordings before an editor reviews them. A scheduled agent can apply consistent sound descriptions and collect extracted and remaining-audio tracks for each recording.

Prepare interview dialogue

Extract speech from a noisy interview recording for a dialogue edit. Compare the extracted speech with the original before replacing the source track.

Remove barking from a podcast

Target the barking and use the remaining-audio track as a podcast editing candidate. Check the moments where barking overlaps speech.

Reduce traffic in outdoor recordings

Separate traffic noise from recorded outdoor audio, then review the remaining track for use beneath the scene.

Study a piano part

Extract piano from a mixed music recording to hear its phrasing more clearly. Treat the result as a listening aid and review passages with overlapping instruments.

Prepare a vocal editing reference

Separate singing from accompaniment for an editing reference. Avoid relying on it to identify one singer within a chorus.

Collect recorded sound effects

Extract a specific event, such as an engine revving or a horn honking, from a location recording for a sound editing session.

Separate music from spoken content

Target background music in a mixed recording and review the remaining track for a speech-focused edit.

Questions about SAM Audio in OpenClaw

Can OpenClaw use SAM Audio?

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

How much does SAM Audio cost in OpenClaw?

$0.065 per 30 seconds of audio, at least 30 seconds. Each extra reranking candidate: $0.0325 per 30 seconds. 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 SAM Audio in OpenClaw?

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

How long does it take to set up SAM Audio in OpenClaw?

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

Does OpenClaw wait while SAM Audio runs?

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

What is SAM Audio useful for?

SAM Audio extracts a described sound from a mixed recording. Use it to isolate speech, music, or everyday sound effects for editing and review.

How should I describe the sound I want?

Use a short, lowercase phrase naming the source and its action, such as “piano playing” or “dog barking.” Meta recommends noun or verb phrases that match how the model was trained.

Can SAM Audio remove a sound instead of keeping it?

Yes. Describe the unwanted sound, then use the remaining-audio track, called the residual, for the edit.

What sounds are hardest to separate?

Highly similar sources remain difficult, such as one singer within a chorus or one instrument within an orchestra. Review those results before using them in a finished edit.

When should I try automatic sound timing?

Try it for distinct events, such as barking or honking, so the model predicts when the target occurs. Compare results with it disabled for continuous instrument parts: Meta reported a small decline in professional instrument separation.

Get started

Start using SAM Audio in OpenClaw

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into OpenClaw:

Set up OpenClaw

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options