Perstudio Claw

Name: Perstudio Claw
Rating: 3.5 (1 reviews)
Author: montenegronyc

By montenegronyc 👁 28 views ▲ 0 votes

Perstudio AI image & video generation plugin for OpenClaw

GitHub

Configuration Example

{
  "plugins": {
    "entries": {
      "perstudio": {
        "enabled": true,
        "path": "extensions/perstudio",
        "config": {
          "apiKey": "ps_your_api_key_here"
        }
      }
    }
  }
}

README

# Perstudio — OpenClaw Plugin

AI image and video generation for [OpenClaw](https://openclaw.ai) via [perstudio.ai](https://perstudio.ai).

Generate images, product shots, portraits, stickers, videos, and more — all from natural language descriptions through your OpenClaw agent.

## Prerequisites

- [OpenClaw](https://openclaw.ai) installed and running
- A [perstudio.ai](https://perstudio.ai) account with an API key

## Getting Your API Key

1. Sign up at [perstudio.ai](https://perstudio.ai)
2. Go to **Dashboard** → **API Keys**
3. Click **Create Key** and copy the key

## Installation

### Via ClawHub (Recommended)

```bash
clawhub install perstudio
```

Then configure your API key:

```bash
openclaw config set plugins.entries.perstudio.config.apiKey '"ps_your_api_key_here"'
```

### Manual Installation

1. Copy the `openclaw-plugin/` directory to your OpenClaw extensions folder:

```bash
cp -r openclaw-plugin ~/.openclaw/extensions/perstudio
```

2. Add the plugin to your `openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "perstudio": {
        "enabled": true,
        "path": "extensions/perstudio",
        "config": {
          "apiKey": "ps_your_api_key_here"
        }
      }
    }
  }
}
```

3. OpenClaw hot-reloads config — the plugin should load automatically.

Alternatively, set the API key as an environment variable instead of putting it in config:

```bash
export PERSTUDIO_API_KEY="ps_your_api_key_here"
```

## Usage

Once installed, your OpenClaw agent has access to the `perstudio` tool. Just ask it to generate images:

> "Generate a photo of a golden retriever in a field of sunflowers"

> "Create a product shot of a coffee mug on a marble countertop"

> "Make a sticker of a cartoon cat"

> "Generate a short video of ocean waves at sunset"

### Direct Tool Usage

```
perstudio({ action: "generate_sync", intent: "a cyberpunk cityscape at night" })
```

### Image-to-Image

```
perstudio({ action: "upload_asset", file_path: "/path/to/photo.jpg" })
perstudio({ action: "generate_sync", intent: "transform into oil painting", input_image_asset_id: "..." })
```

### Check Balance

```
perstudio({ action: "balance" })
```

### Browse Workflows

```
perstudio({ action: "list_workflows" })
perstudio({ action: "capabilities" })
```

## Configuration Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `apiKey` | string | — | Your perstudio.ai API key (required) |
| `baseUrl` | string | `https://api.perstudio.ai` | API base URL |
| `enabled` | boolean | `true` | Enable/disable the plugin |

## Token Pricing

Generation costs tokens. Purchase token packs at [perstudio.ai/pricing](https://perstudio.ai/pricing).

| Category | Tokens |
|----------|--------|
| Text to Image | 20 |
| Image to Image | 20 |
| Upscale | 10 |
| Product / Portrait | 30 |
| ControlNet / Style Transfer | 30 |
| Video | 100 |
| Audio / TTS | 40 |

## Links

- [perstudio.ai](https://perstudio.ai) — Sign up and manage your account
- [Documentation](https://perstudio.ai/docs) — Full API documentation
- [OpenClaw](https://openclaw.ai) — OpenClaw platform

tools