Grok Imagine OpenAPI Skill for Openclaw

A specialized image generation skill leveraging xAI Aurora to produce high-resolution visuals from text descriptions and reference images.

sparkleming
v1.0.0
Apr 18, 2026
0
301
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install grok-imagine-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 grok-imagine-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 Grok Imagine OpenAPI Skill?

The Grok Imagine skill is a robust integration designed for the xAI Aurora model, providing developers and AI agents the ability to generate high-fidelity imagery directly through an API. As part of the growing ecosystem of Openclaw Skills, it bridges the gap between text-based reasoning and visual creation, allowing for batch processing of up to 16 images in a single execution.

Built on the WeShop OpenAPI infrastructure, this skill prioritizes security and performance. It enables seamless image synthesis by supporting both pure text-to-image prompts and image-to-image workflows using reference URLs, making it an essential tool for automated content creation and design prototyping.

Grok Imagine OpenAPI Skill Use Cases

  • Creating high-resolution marketing assets or conceptual art from text prompts.
  • Generating multiple variations of a design concept in batches for rapid iteration.
  • Using reference images to guide the style or composition of AI-generated visuals.
  • Automating visual content production within AI-driven agents and development pipelines.

How Grok Imagine OpenAPI Skill Works

  1. The user or agent initiates a request by calling the POST /openapi/agent/runs endpoint with the grok-imagine agent configuration.
  2. The skill processes the textDescription and any optional reference images provided in the run parameters.
  3. A unique executionId is returned, and the skill transitions through states including Pending, Running, and Success.
  4. The agent polls the GET /openapi/agent/runs/{executionId} endpoint to monitor the generation progress.
  5. Upon completion, the high-resolution image URLs are retrieved from the result data schema.

Grok Imagine OpenAPI Skill Setup

To integrate this into your environment, ensure you have a valid API key from the WeShop platform.

  1. Obtain your API key at: https://open.weshop.ai/authorization/apikey
  2. Set the environment variable in your terminal:
export WESHOP_API_KEY='your_api_key_here'

Note: This skill communicates exclusively with openapi.weshop.ai. Ensure your network configuration allows HTTPS access to this domain.

Grok Imagine OpenAPI Skill Data Schema & Taxonomy

The skill utilizes a structured request/response format for reliable image generation.

Input Parameters

Field Type Description
textDescription string The primary prompt describing the desired image.
batchCount integer Number of images (1-16) to generate in one run.
images array Optional list containing a single reference image URL.

Execution Status

Results are organized by executionId with the following status taxonomy:

  • Pending / Segmenting: Initializing resources.
  • Running: Actively generating imagery.
  • Success: Process complete; images available in data.executions[*].result[*].image.
  • Failed: Execution encountered an error.

Grok Imagine OpenAPI Skill Advanced Features

  • Batch Generation: Supports generating up to 16 unique images in a single API call for high-throughput workflows.
  • Image-to-Image Support: Capability to provide a reference image URL to guide the Aurora model's output.
  • Asset Management: Dedicated endpoint for uploading local images to generate reusable URLs for processing.
  • Real-time Polling: Granular execution states allow agents to provide detailed feedback during the generation lifecycle within the Openclaw Skills framework.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*