← 返回 Skills 市场

Black Forest Labs FLUX

Name: Black Forest Labs FLUX
Author: gamaleldientarek

作者 Gamal Eldien Tarek Abdelsataar · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install black-forest-labs-flux

功能描述

Generate images with Black Forest Labs FLUX models using a direct BFL API key. Use when the user wants FLUX image generation through Black Forest Labs itself...

使用说明 (SKILL.md)

Black Forest Labs FLUX

Generate images through Black Forest Labs' direct API using the bundled script in scripts/bfl-generate.sh.

Quick start

Ensure BFL_API_KEY is available in the environment or in /root/.clawdbot/.env.
Run:

/root/clawd/skills/black-forest-labs-flux/scripts/bfl-generate.sh "your prompt here" [output-file]

Example:

/root/clawd/skills/black-forest-labs-flux/scripts/bfl-generate.sh \
  "A cinematic scene of a monkey sitting proudly on top of a red Ferrari sports car" \
  /root/clawd/output/monkey-ferrari.jpg

The script prints the saved file path on success.

When to use this skill

Use this skill when:

The user has a Black Forest Labs API key
The user wants direct FLUX generation instead of fal.ai or another wrapper
The user mentions BFL, Black Forest Labs, or direct FLUX model endpoints

Do not use this skill for:

fal.ai keys (FAL_KEY) — use built-in fal support instead
OpenAI image generation
Google Gemini image generation

Default behavior

The script defaults to:

model: flux-2-pro-preview
width: 1536
height: 1024

Override these with environment variables before running:

export BFL_MODEL=flux-pro
export BFL_WIDTH=1024
export BFL_HEIGHT=1024

Then call the script normally.

How it works

The BFL API is asynchronous:

Submit a generation request
Capture polling_url
Poll until status becomes Ready
Download the returned image URL

The bundled script already handles this flow.

Troubleshooting

If the script says BFL_API_KEY not set, add the key to the environment first.
If generation fails, inspect the JSON returned by the API; the script prints it to stderr.
If the request succeeds but takes longer than expected, re-run with a simpler prompt or smaller dimensions.

scripts/

scripts/bfl-generate.sh — direct Black Forest Labs FLUX generation via API

安全使用建议

This skill likely does what it claims (submits prompts to api.bfl.ai and downloads images), but there are a few practical concerns to consider before installing or running it: - The script expects BFL_API_KEY but the skill metadata does not declare this — you should provide a valid BFL_API_KEY environment variable before running. Prefer setting only that key in the agent environment rather than relying on shared env files. - The script automatically sources /root/.clawdbot/.env if it exists. That file may contain other secrets (tokens, keys). Inspect /root/.clawdbot/.env and remove unrelated secrets or modify the script to avoid sourcing it if you do not want it read. - Ensure the runtime has curl and python3 available (the metadata did not list these binaries). If they are missing the script will fail. - Note the default output path (/root/clawd/output) and the script creating directories under /root; adjust paths or permissions if that is undesirable. If you want higher assurance: ask the skill author/maintainer to (1) update the manifest to declare BFL_API_KEY and required binaries, (2) remove or document the automatic sourcing of /root/.clawdbot/.env, or (3) provide an option to explicitly pass the API key rather than implicitly sourcing files.

功能分析

Type: OpenClaw Skill Name: black-forest-labs-flux Version: 0.1.0 The skill provides a legitimate interface for generating images via the Black Forest Labs FLUX API. The core logic in `scripts/bfl-generate.sh` uses standard tools (curl and python) to submit prompts, poll for results, and download images to a designated output directory. It correctly handles API authentication using environment variables and follows the documented asynchronous flow of the BFL service without any signs of malicious intent, data exfiltration, or obfuscation.

能力评估

⚠ Purpose & Capability

The skill's stated purpose (direct Black Forest Labs FLUX image generation) matches the script's actions (POST to https://api.bfl.ai and polling). However the package metadata declares no required environment variables or binaries, while the script requires BFL_API_KEY and uses curl and python3. This mismatch between declared requirements and actual needs is incoherent and could mislead install-time checks or users.

⚠ Instruction Scope

SKILL.md instructs using the bundled script and says BFL_API_KEY must be in the environment or /root/.clawdbot/.env. The script will source /root/.clawdbot/.env if present, which may load unrelated secrets or variables from that file. The script also writes output to /root/clawd/output by default. Reading/sourcing a root-scoped env file is broader scope than strictly required to accept a single API key and is worth scrutinizing.

✓ Install Mechanism

There is no install spec (instruction-only plus a script). That is low-risk from an installation/download perspective; nothing is fetched or extracted at install time.

⚠ Credentials

The script requires a BFL_API_KEY (and optionally BFL_MODEL/BFL_WIDTH/BFL_HEIGHT) but the skill metadata does not declare any required env vars or a primary credential. The script also sources /root/.clawdbot/.env automatically, which could expose other environment variables or secrets stored there. The requested environment access is not fully documented in the manifest.

✓ Persistence & Privilege

The skill is not always-enabled and does not request elevated or cross-skill privileges. It does not modify other skills' configs. Its actions are limited to making network requests to the BFL API and writing image files to the output directory.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install black-forest-labs-flux
安装完成后，直接呼叫该 Skill 的名称或使用 /black-forest-labs-flux 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

Initial release

元数据

Slug black-forest-labs-flux

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题