Xpersona
agentCLAWHUBUnverified

flux-kontext

Generate and edit images with Flux Kontext through RunAPI. Use when the user asks an agent to create, edit, or transform images with Flux Kontext. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Skill: flux-kontext Owner: runapi-ai Summary: Generate and edit images with Flux Kontext through RunAPI. Use when the user asks an agent to create, edit, or transform images with Flux Kontext. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend. Tags: latest:0.2.9 Version history: v0.2.9 | 2026-08-12T06:04:22.868Z | user Changed - Generate the flu

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.1k

Updated

Oct 11, 2026

Version

0.2.9

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1.1K downloadsadoption · observed Oct 11, 2026
Latest release
0.2.9release · observed Aug 12, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-flux-kontext
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-flux-kontext/snapshot"

Documentation

CLAWHUB

30,331 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: flux-kontext
description: "Generate and edit images with Flux Kontext through RunAPI. Use when the user asks an agent to create, edit, or transform images with Flux Kontext. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend."
documentation: https://runapi.ai/models/flux-kontext.md
provider_page: https://runapi.ai/providers/black-forest-labs.md
catalog: https://runapi.ai/models.md
metadata:
  openclaw:
    homepage: https://runapi.ai/models/flux-kontext
    requires:
      bins:
      - runapi
    install:
    - kind: brew
      formula: runapi-ai/tap/runapi
      bins:
      - runapi
    envVars:
    - name: RUNAPI_API_KEY
      required: false
      description: Optional RunAPI API key; agents should prefer environment auth or saved CLI config. Browser login is interactive fallback only.
---

# Flux Kontext on RunAPI

## Choose route

- For a one-off artifact or result, use the registered `flux-kontext` service in the `runapi` CLI. If the installed command catalog does not list it, stop and report the missing service instead of inventing a command.
- For an app, backend, worker, library, webhook pipeline, or production codebase, go directly to **Integrate with SDK**. Never shell out to the CLI as the production runtime.

## Discover contract

Authenticate, then inspect the installed command catalog and the selected operation's current contract:

```shell
runapi auth status > auth.json
jq -e '.authenticated == true' auth.json
runapi flux-kontext --help
runapi flux-kontext <operation> --help
curl --fail --location https://runapi.ai/docs/api/flux-kontext/<operation>.md --output contract.md
```

If authentication is false, stop before submitting. Ask the user to provide a valid `RUNAPI_API_KEY`, or import a user-provided key from stdin with `runapi auth import-token --token -`; use interactive browser login only when the user explicitly requests it. Choose `<operation>` only from service help. Treat command help as authoritative for the installed operation, model, and top-level field roster. Treat its API Reference as authoritative for the complete request schema, nested fields, conditional rules, task behavior, and response variants. If the two surfaces disagree, stop and report the contract mismatch instead of guessing.

## Build request

Create `request.json` as valid JSON using only fields accepted by the discovered operation contract. For the chosen model and values, evaluate every applicable conditional rule as a set: satisfy every required field, omit every forbidden field, and stop on unresolved contradictions.

Traverse nested objects and arrays before execution. Close every relationship stated by the discovered contract, including uniqueness constraints and cross-references between nested values.

For a discovered local media input, including file-typed fields and top-level media URL fields, put an agent-readable local file path directly in `request.json`. T

_meta.json

{
  "ownerId": "kn70me4rk7jqjt92evshjeb5z18768g7",
  "slug": "runapi-flux-kontext",
  "version": "0.2.9",
  "publishedAt": 1786514662868
}

skill-card.md

## Description:

Generate and edit images with Flux Kontext through RunAPI.

This skill is ready for commercial/non-commercial use.

## Publisher:

[runapi-ai](https://clawhub.ai/user/runapi-ai)

### License/Terms of Use:

MIT-0

## Use Case:

External users, developers, and agents use this skill to generate, edit, or transform images with Flux Kontext through RunAPI. It supports one-off CLI use and SDK-based integration when the user is building an application or backend.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Prompts and selected media inputs are sent to RunAPI and submitted tasks may incur provider charges.

Mitigation: Use the skill only with an authorized RunAPI account or API key, confirm authentication before submission, and submit paid requests only when the user has authorized the task.

Risk: A successful service status might not prove that the requested image deliverable is present or valid.

Mitigation: Validate the complete result contract, download every requested media deliverable, and require each downloaded file to be non-empty with the expected image MIME type before reporting completion.

Risk: An outdated CLI catalog or mismatched API contract can lead to invalid requests.

Mitigation: Inspect the installed CLI help and current API reference for the selected operation, and stop instead of guessing when the two contract sources disagree.

## Reference(s):

- [RunAPI Flux Kontext model overview](https://runapi.ai/models/flux-kontext.md)
- [RunAPI Flux Kontext homepage](https://runapi.ai/models/flux-kontext)
- [Black Forest Labs provider overview](https://runapi.ai/providers/black-forest-labs.md)
- [RunAPI model catalog](https://runapi.ai/models.md)
- [Flux Kontext SDK integration](https://github.com/runapi-ai/flux-kontext-sdk)
- [Flux Kontext Max variant](https://runapi.ai/models/flux-kontext/max.md)
- [Flux Kontext Pro variant](https://runapi.ai/models/flux-kontext/pro.md)

## Skill Output:

**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance, Files, JSON]

**Output Format:** [Markdown guidance with shell commands, JSON request and response artifacts, and downloaded image files when generation succeeds]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [The skill requires contract discovery before requests, preserves task and result JSON, and verifies downloaded image files for non-empty content and expected MIME type.]

## Skill Version(s):

0.2.9 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/runapi-ai/skills/runapi-flux-kontext",
      "sourceUrl": "https://clawhub.ai/runapi-ai/skills/runapi-flux-kontext",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T10:09:25.132Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-flux-kontext/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-flux-kontext/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T10:09:25.132Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.1K downloads",
      "href": "https://clawhub.ai/runapi-ai/runapi-flux-kontext",
      "sourceUrl": "https://clawhub.ai/runapi-ai/runapi-flux-kontext",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T10:09:25.132Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.2.9",
      "href": "https://clawhub.ai/runapi-ai/runapi-flux-kontext",
      "sourceUrl": "https://clawhub.ai/runapi-ai/runapi-flux-kontext",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-12T06:04:22.868Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-flux-kontext/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-flux-kontext/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.2.9",
      "description": "## Changed - Generate the flux-kontext skill from the shared RunAPI recipe with contract-discovered request rules and task behavior, direct local media inputs, complete result verification, and bounded recovery.",
      "href": "https://clawhub.ai/runapi-ai/runapi-flux-kontext",
      "sourceUrl": "https://clawhub.ai/runapi-ai/runapi-flux-kontext",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-08-12T06:04:22.868Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to flux-kontext and adjacent AI workflows.