[Integrations](https://spiral.ai/integrations) › [OpenClaw](https://spiral.ai/integrations/openclaw) › [Portrait Enhance](https://spiral.ai/integrations/openclaw/portrait-enhance)

# How to Use Portrait Enhance in OpenClaw

Portrait Enhance refines portrait photos for improved clarity and detail. Its documented 4K output makes it worth testing for headshots, author photos, and speaker portraits.

|  |  |
| --- | --- |
| Model | Portrait Enhance |
| Available through | fal |
| Category | Image |
| Price | $0.52 per image. |
| Returns | image |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Portrait Enhance in OpenClaw

- Every Monday, use Portrait Enhance on newly submitted staff portraits. Put originals and results in a review gallery.
- Each morning, use Portrait Enhance on new speaker photos submitted for the conference. Include the returned pixel dimensions in the review report.
- Every Friday, use Portrait Enhance on newly approved author portraits. Prepare a before-and-after digest for the editor.
- Each evening, use Portrait Enhance on new performer portraits submitted for the press kit. Keep each result paired with its original.
- Every Wednesday, use Portrait Enhance on new interview subject portraits. Flag visible facial changes for editorial review.

## How to set up Portrait Enhance 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 Portrait Enhance**: 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": "fal-ai/image-apps-v2/portrait-enhance",
    "input": {
      "image_url": "https://v3b.fal.media/files/b/monkey/VszUszGx2uzReqFvQzF26.jpg"
    }
  }'
```

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

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

## Portrait Enhance tools and prices

- [Portrait Enhance](https://spiral.ai/tools/fal/fal-ai/image-apps-v2/portrait-enhance) (fal): $0.52 per image.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| aspect_ratio |  | — | Aspect ratio for 4K output (default: 3:4 for portraits) |

## What can you do with Portrait Enhance in OpenClaw?

Prepare portrait review candidates as new staff, speaker, or author photos arrive with Portrait Enhance. A scheduled agent can collect the results into a comparison report for an editor.

### Team directory portraits

Refine existing employee portraits, then review each result before placing it in the team directory.

### Author biography photos

Prepare an enhanced version of an author's portrait for a book page, newsletter, or article biography.

### Conference speaker photos

Improve portrait clarity for speaker biographies and compare the results before adding names and session details.

### Professional profile updates

Test an enhanced version of an existing headshot for a professional profile, keeping the original for comparison.

### Performer press portraits

Refine a musician's or actor's existing portrait for review alongside the other images in a press kit.

### Interview subject portraits

Prepare portrait candidates for an interview page and check facial detail before the editor selects an image.

## Overview

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

## Portrait Enhance in other agents

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

## More OpenClaw guides

- [Plushie Style](https://spiral.ai/integrations/openclaw/plushie-style)
- [Post Processing Color Correction](https://spiral.ai/integrations/openclaw/post-processing-color-correction)
- [Pixelcut Product Photo](https://spiral.ai/integrations/openclaw/pixelcut-product-photo)
- [Product Holding](https://spiral.ai/integrations/openclaw/product-holding)
- [Pixelcut Background Remover](https://spiral.ai/integrations/openclaw/pixelcut-background-remover)
- [Product Photography](https://spiral.ai/integrations/openclaw/product-photography)

## Questions about Portrait Enhance in OpenClaw

**Can OpenClaw use Portrait Enhance?**

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

**How much does Portrait Enhance cost in OpenClaw?**

$0.52 per image. 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 Portrait Enhance in OpenClaw?**

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

**How long does it take to set up Portrait Enhance in OpenClaw?**

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

**Does OpenClaw wait while Portrait Enhance runs?**

Portrait Enhance runs in the background. OpenClaw starts the run, checks on it and gives you the image when it's ready.

**What is Portrait Enhance good for?**

Its stated purpose is improving clarity and detail in portrait photos. Try it on an existing headshot or biography photo, then compare the result with the original.

**What resolution does Portrait Enhance produce?**

The documentation specifies 4K output. Check the returned image dimensions before preparing a final layout.

**How do I check the exact output dimensions?**

Read the returned image's width and height in pixels. Use those measurements when deciding how large to place the portrait.

**How should I check whether the portrait still looks like the person?**

Compare the original and result side by side, paying attention to eyes, teeth, skin texture, and facial contours. Keep the original if the changes make the person look less recognizable.

**What should I ask my agent to do with Portrait Enhance?**

Name the portrait and its intended use, such as an author bio or conference program. Ask the agent to show a before-and-after comparison and flag visible changes before you approve the result.

