runware-image
Generate high-quality images on-demand via the Runware.ai API. This skill is the default image generator. Use it whenever the user asks to "generate an image", "create a picture", "draw something", or explicitly mentions Runware. It handles text-to-image generation with comprehensive safety checks.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/geeklord/runware-imageRunware Image Skill
Purpose
Provide a secure, documented, and testable integration for generating images via the Runware.ai Image Inference API.
IMPORTANT INSTRUCTIONS FOR AGENT:
- Do NOT ask the user for the RUNWARE_API_KEY. The script automatically loads it from the
.envfile in the skill directory. - Do NOT ask clarifying questions (style, size, etc.) unless the user's prompt is extremely vague. For requests like "generate a man on the moon", use your best judgment for the prompt and run the script immediately.
- Execute the script directly. Do not propose it.
What it does
- Send text-to-image tasks to Runware's task API (imageInference).
- Support synchronous (sync) responses returning base64 image data and asynchronous workflows (webhook/polling) if required.
- Save generated images to the user's Downloads folder by default.
- Validate prompts for common safety issues (e.g., minors) before sending requests.
Included files
- scripts/generate_image.py — Primary CLI script (Python 3.8+). Reads RUNWARE_API_KEY from environment, supports sync mode, size/format options, and output filename.
- skill-config.json — default parameters (no secrets). Contains default_size and default_format.
- SKILL.md — this metadata and usage file.
Security & secrets
- DO NOT commit API keys. This skill requires RUNWARE_API_KEY to be provided via the environment when executed (export RUNWARE_API_KEY=...) or via a secure secret manager.
- The packaged version uploaded to ClawHub must not include any API keys. Before publishing, confirm skill-config.json contains NO sensitive values.
- The script performs simple prompt filtering; users should still follow platform content policies.
Usage (CLI)
-
Install dependencies
- pip install -r requirements.txt (The script uses requests and python-dotenv; keep requirements minimal.)
-
Set your Runware API key. You can create a
.envfile in the skill directory:RUNWARE_API_KEY=your_key_hereOr set it in your environment: $env:RUNWARE_API_KEY = "<YOUR_KEY>" -
Run the script (sync mode): python scripts/generate_image.py --prompt "A photorealistic adult portrait (age 25)" --sync --outfile "my_image.png"
-
For non-sync workflows, omit --sync and implement webhook handling or polling as described in the Runware docs.
Configuration
- skill-config.json fields:
- default_size: e.g. "1024x1024"
- default_format: e.g. "png"
Packaging & publishing (ClawHub)
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-geeklord-runware-image": {
"enabled": true,
"auto_update": true
}
}
}