Celeb-AI OpenAPI Skill for Openclaw

A professional AI image generation skill that places a person into high-fidelity selfies with celebrities or fictional characters.

sparkleming
v1.0.0
Apr 16, 2026
0
225
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install celeb-ai-openapi-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install celeb-ai-openapi-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Celeb-AI OpenAPI Skill?

The Celeb-AI skill is a powerful expansion for AI agents, part of the Openclaw Skills ecosystem, designed to interface with the WeShop OpenAPI. It allows users to take a standard portrait and realistically composite it into a scene with a chosen celebrity or fictional figure, such as Harry Potter.

Leveraging advanced image synthesis, this skill handles the heavy lifting of perspective matching, background generation, and character consistency. It is ideal for developers building social media tools, entertainment apps, or personalized content generators that require robust cloud-based image manipulation via a clean API interface.

Celeb-AI OpenAPI Skill Use Cases

  • Creating personalized marketing materials featuring brand-appropriate fictional characters.
  • Generating viral social media content by placing users in scenes with famous celebrities.
  • Prototyping entertainment apps that allow fans to 'meet' their idols virtually.
  • Automating high-volume selfie generation for fan communities or gaming rewards.

How Celeb-AI OpenAPI Skill Works

  1. Image Preparation: The agent uploads a local portrait or provides a URL to the WeShop OpenAPI assets endpoint.
  2. Task Initiation: A POST request is sent to the /openapi/agent/runs endpoint specifying the celeb-ai agent and the textDescription of the scene.
  3. Processing: The WeShop server transitions through Segmenting and Running states to composite the images.
  4. Status Polling: The skill polls the executionId via GET requests until a Success or Failed status is returned.
  5. Asset Retrieval: The final high-resolution image URLs are extracted from the execution result data for the user.

Celeb-AI OpenAPI Skill Setup

To use this Openclaw Skills compatible integration, you must obtain an API key from the WeShop dashboard and configure your environment.

# Export your API key as an environment variable
export WESHOP_API_KEY="your_api_key_here"

Note: Ensure your agent is configured to send the raw API key in the Authorization header without the Bearer prefix.

Celeb-AI OpenAPI Skill Data Schema & Taxonomy

The skill utilizes a structured JSON request and response format to manage image assets and task states.

Object Property Description
Input input.images An array containing up to 2 source portrait URLs.
Params textDescription The prompt describing the celebrity and the scene.
Params batchCount Number of variations to generate (1-16).
Status data.executions Array containing the final generated image objects and URLs.

Celeb-AI OpenAPI Skill Advanced Features

  • Batch Generation: Generate up to 16 different variations in a single run to provide users with multiple options.
  • Custom Scene Prompting: Beyond celebrities, users can define complex backgrounds and specific character interactions using the textDescription parameter.
  • Async Polling Architecture: Built-in support for long-running image generation tasks with granular state tracking (Pending, Segmenting, Running).
  • Secure Asset Management: Integrated image upload endpoint to convert local files into reusable URLs for the generation pipeline.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*