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

OpenClaw · VideoReleased 2025-09-02

How to Use Video Face Swap in OpenClaw

Video Face Swap replaces a person's face in existing footage using a reference portrait while retaining the original expressions and lip movements. It suits talking clips and face replacement edits; hair and head outline generally stay as filmed.

Prompts to try with Video Face Swap in OpenClaw

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

Every Monday, use Video Face Swap on the approved 15-second greeting and this week's approved portrait. Queue the result for review.

Video Face SwapOpenClaw
Try asking
  • Each morning, use Video Face Swap to create previews for newly approved 20-second ads, one result per approved portrait.

  • Every Friday, use Video Face Swap on the approved 10-second casting test with each newly approved actor portrait. Keep the results separate.

  • Each evening, use Video Face Swap on approved greeting videos shorter than one minute, pairing each with its assigned portrait.

  • Every Tuesday, use Video Face Swap to prepare an 8-second head-turn test for each approved video and portrait pair. Queue the tests for visual review.

How to set up Video Face Swap 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 Video Face Swap

    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": "wavespeed",
        "model": "wavespeed-ai/video-face-swap",
        "input": {
          "video": "<video>",
          "face_image": "<face_image>"
        }
      }'

Then paste one of the prompts above: OpenClaw finds Video Face Swap on Spiral, shows the price and runs it.

Video Face Swap providers and prices

Spiral runs Video Face Swap through WaveSpeed. Open a card for today's price, with every fee included.

WaveSpeedVideo
Video Face Swap
wavespeed-ai/video-face-swap

Settings you can ask for

Video Face Swap works from your video and face image. Ask OpenClaw for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Target index0 to 100

0 = the largest face the detector finds, 1 the next, and so on. Profile and very small faces may not be found, and the video comes back unchanged.

Target genderall, male, or femaleall

Only swap target faces matching this gender. 'all' swaps regardless of gender.

Every API field of Video Face Swap is on its tool page: open its card above.

What can you do with Video Face Swap in OpenClaw?

Prepare recurring face replacement previews from approved footage and portraits. A scheduled agent can organize each result for review before publication.

Presenter face replacement

Use an approved portrait to replace the face in a recorded introduction while retaining the presenter's facial performance.

Ad casting previews

Compare approved faces in the same filmed ad before deciding which appearance fits the creative.

Short-film casting tests

Preview an actor's face on an existing performance to assess the shot, with the original hair and head outline generally retained.

Personalized greeting clips

Place a participant's approved portrait into a prerecorded greeting, producing one face replacement per request.

Comedy sketches

Replace a performer's face in an original sketch while keeping the facial expressions that carry the joke.

Reference portrait comparisons

Process the same short shot with several approved portraits in separate requests, then compare identity match and facial edges.

Questions about Video Face Swap in OpenClaw

Can OpenClaw use Video Face Swap?

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

How much does Video Face Swap cost in OpenClaw?

$0.013 per second, at least 3 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 WaveSpeed account to use Video Face Swap in OpenClaw?

No. Spiral runs Video Face Swap on its own WaveSpeed account. You sign in to Spiral once and never paste a key.

How long does it take to set up Video Face Swap in OpenClaw?

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

Does OpenClaw wait while Video Face Swap runs?

Video Face Swap runs in the background. OpenClaw starts the run, checks on it and gives you the video when it's ready.

How long can a Video Face Swap clip be?

The source video can be up to 10 minutes long.

Does Video Face Swap keep the original performance?

It is designed to retain the original facial movements, emotions, and lip sync while replacing the face. Review the result before using it.

What reference photo works best?

Choose a clear, front-facing portrait with good lighting and an unobstructed face. Avoid sunglasses and strong shadows.

Can I replace two people with different faces?

Yes, through separate requests. Each request uses one reference identity to replace one selected face.

Will Video Face Swap also replace the hairstyle?

Hair and head outline generally remain from the original footage. Face replacement works best when you want to retain those parts of the shot.

Get started

Start using Video Face Swap 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