Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (perstudio-openclaw) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Perstudio — OpenClaw Plugin

AI image and video generation for OpenClaw via perstudio.ai.

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

Prerequisites

OpenClaw installed and running
A perstudio.ai account with an API key

Getting Your API Key

Sign up at perstudio.ai
Go to Dashboard → API Keys
Click Create Key and copy the key

Installation

Via ClawHub (Recommended)

clawhub install perstudio

Then configure your API key:

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

Manual Installation

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

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

Add the plugin to your openclaw.json:

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

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

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

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.

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