AI Elf OpenAPI Skill for Openclaw

An AI-powered image transformation skill that turns standard portraits into detailed fantasy elf characters via the WeShop OpenAPI.

sparkleming
v1.0.0
Apr 13, 2026
0
231
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install ai-elf-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 ai-elf-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 AI Elf OpenAPI Skill?

The AI Elf OpenAPI skill is a specialized image processing tool designed to bridge the gap between real-world portraits and high-quality fantasy aesthetics. By leveraging advanced generative models through the WeShop API, this skill allows developers to integrate automated character design and stylized filtering into their applications.

As one of the versatile Openclaw Skills, it handles the complexities of image segmentation and style transfer, providing a seamless workflow for generating multiple variations of elf characters from a single source image. This is ideal for gaming avatars, creative profile pictures, and digital art automation within any agentic framework.

AI Elf OpenAPI Skill Use Cases

  • Converting user portraits into fantasy-themed avatars for gaming or social media profiles.
  • Automating batch image processing for digital artists and creative design agencies.
  • Integrating fantasy style transfer into existing creative software workflows using Openclaw Skills.
  • Rapid prototyping of character designs for novelists and concept artists.

How AI Elf OpenAPI Skill Works

  1. Provide an image URL or upload a local file to the assets endpoint to obtain a reusable URL.
  2. Initialize a generation task by sending a POST request to the agent runs endpoint with the ai-elf agent name and the portrait URL.
  3. Optionally customize the output by adjusting the textDescription or increasing the batchCount up to 16 for multiple variations.
  4. Poll the run execution endpoint to monitor the transformation progress through states like Segmenting and Running.
  5. Retrieve the final character image results from the success payload once the task reaches its terminal state.

AI Elf OpenAPI Skill Setup

To get started with this skill, you must first obtain an API Key from the official WeShop developer portal. Follow these steps for configuration:

  1. Set the WESHOP_API_KEY environment variable in your local environment:
export WESHOP_API_KEY='your_api_key_here'
  1. Ensure your agent has HTTPS access to openapi.weshop.ai.
  2. When making requests, include the raw API key in the Authorization header without the Bearer prefix as required by Openclaw Skills integrations.

AI Elf OpenAPI Skill Data Schema & Taxonomy

The skill utilizes a structured schema for managing image generation tasks and tracking their lifecycle:

Field Type Description
input.images Array A list containing the input portrait image URL.
params.textDescription String Custom instructions for the transformation; defaults to 'Turn this person into an elf'.
params.batchCount Integer Number of images to generate (range 1-16).
executionId String Unique ID used to poll the status of the generation task.
status String Current run state: Pending, Segmenting, Running, Success, or Failed.

AI Elf OpenAPI Skill Advanced Features

  • Batch Generation: Create up to 16 unique elf variations in a single run to provide users with multiple creative options.
  • Custom Prompting: Leverage the textDescription parameter to inject specific stylistic instructions for more targeted fantasy designs.
  • Robust Polling Workflow: Manage long-running generative tasks effectively with an asynchronous status tracking system.
  • Secure Asset Handling: Compatible with centralized image asset management for high-performance processing within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*