{
  "schemaVersion": "1.0",
  "item": {
    "slug": "runware-image",
    "name": "Generate images using Runware API",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/GeekLord/runware-image",
    "canonicalUrl": "https://clawhub.ai/GeekLord/runware-image",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/runware-image",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=runware-image",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      ".github/workflows/ci.yml",
      "CONTRIBUTING.md",
      "examples/README.md",
      "README.md",
      "requirements.txt",
      "scripts/generate_image.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/runware-image"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/runware-image",
    "agentPageUrl": "https://openagent3.xyz/skills/runware-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/runware-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/runware-image/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [],
    "body": "Runware Image Skill\n\nPurpose\n\nProvide a secure, documented, and testable integration for generating images via the Runware.ai Image Inference API.\n\nIMPORTANT INSTRUCTIONS FOR AGENT:\n\nDo NOT ask the user for the RUNWARE_API_KEY. The script automatically loads it from the .env file in the skill directory.\nDo 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.\nExecute the script directly. Do not propose it.\n\nWhat it does\n\nSend text-to-image tasks to Runware's task API (imageInference).\nSupport synchronous (sync) responses returning base64 image data and asynchronous workflows (webhook/polling) if required.\nSave generated images to the user's Downloads folder by default.\nValidate prompts for common safety issues (e.g., minors) before sending requests.\n\nIncluded files\n\nscripts/generate_image.py — Primary CLI script (Python 3.8+). Reads RUNWARE_API_KEY from environment, supports sync mode, size/format options, and output filename.\nskill-config.json — default parameters (no secrets). Contains default_size and default_format.\nSKILL.md — this metadata and usage file.\n\nSecurity & secrets\n\nDO 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.\nThe packaged version uploaded to ClawHub must not include any API keys. Before publishing, confirm skill-config.json contains NO sensitive values.\nThe script performs simple prompt filtering; users should still follow platform content policies.\n\nUsage (CLI)\n\nInstall dependencies\n\npip install -r requirements.txt (The script uses requests and python-dotenv; keep requirements minimal.)\n\nSet your Runware API key. You can create a .env file in the skill directory: RUNWARE_API_KEY=your_key_here Or set it in your environment: $env:RUNWARE_API_KEY = \"<YOUR_KEY>\"\n\nRun the script (sync mode): python scripts/generate_image.py --prompt \"A photorealistic adult portrait (age 25)\" --sync --outfile \"my_image.png\"\n\nFor non-sync workflows, omit --sync and implement webhook handling or polling as described in the Runware docs.\n\nConfiguration\n\nskill-config.json fields:\ndefault_size: e.g. \"1024x1024\"\ndefault_format: e.g. \"png\"\n\nPackaging & publishing (ClawHub)\n\nChecklist before publishing:\n\nRemove any plaintext API keys from skill-config.json (already removed).\nAdd a short one-line license (MIT recommended) in LICENSE file.\nAdd a small tests/ directory with a smoke test that verifies parsing logic and saved file behavior using temporary directories. Tests may require RUNWARE_API_KEY for live integration or can be skipped in CI if secrets are not provided.\nEnsure SKILL.md frontmatter (name + description) is accurate and includes trigger phrases.\nProvide example prompts and recommended safety guidance in SKILL.md.\n\nSuggested repository structure\n\nrunware-image/ ├── SKILL.md ├── skill-config.json ├── scripts/ │ └── generate_image.py ├── requirements.txt ├── LICENSE └── tests/ └── test_generate_image.py\n\nTests and CI\n\nInclude a minimal pytest-based test that stubs requests.post and verifies parsing logic and saved file behavior using temporary directories.\nAdd GitHub Actions workflow (optional) that runs tests on push.\n\nContribution & support\n\nInclude a short CONTRIBUTING.md describing how to run tests, where to report issues, and how to add features (e.g., support for ControlNet, LoRA, or custom models).\nProvide an examples/ folder with 2–3 example prompts and expected CLI commands.\n\nLicensing\n\nRecommend MIT license for public sharing unless you prefer another OSI-approved license.\n\nPrivacy and usage notes\n\nMake it explicit that the skill does not collect or store user prompts or keys on the server. All generation is performed using the user's Runware account.\nRecommend users review Runware's terms and ensure they have rights to generate/host the requested imagery."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/GeekLord/runware-image",
    "publisherUrl": "https://clawhub.ai/GeekLord/runware-image",
    "owner": "GeekLord",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/runware-image",
    "downloadUrl": "https://openagent3.xyz/downloads/runware-image",
    "agentUrl": "https://openagent3.xyz/skills/runware-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/runware-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/runware-image/agent.md"
  }
}