——
OpenClaw 新增 Fal Krea 图像模型支持：3 步配置 AI 图像生成
OpenClaw 最新版本（commit d503ec5）正式引入 Fal Krea 图像生成模型的完整架构支持。这一更新让开发者能够直接在 AI Agent 工作流中调用业界领先的实时图像生成能力，同时保持对模型原生特性的完整兼容。
本文将详细解析本次更新的核心功能，并提供完整的配置指南。
—
为什么需要 Fal Krea 集成？
Fal 是高性能 AI 推理平台，其 Krea 系列模型以超低延迟和高质量图像生成著称。此前 OpenClaw 用户需要通过自定义 API 调用接入，现在官方 Schema 支持让集成变得开箱即用。
本次更新解决的关键问题：
- 标准化 Fal Krea 模型参数配置
- 支持模型特定的宽高比设置
- 保留 Fal 原生自动比例特性
—
核心功能详解
1. Fal Krea 模型架构 Schema
新增完整的 JSON Schema 定义，覆盖 Krea 系列所有参数：
{
"model": "fal-ai/krea",
"parameters": {
"prompt": "a futuristic cityscape at sunset",
"aspect_ratio": "16:9",
"width": 1024,
"height": 576,
"num_images": 1
}
}
关键字段说明：
| 字段 | 类型 | 说明 |
|:—|:—|:—|
| aspect_ratio | string | 支持 1:1, 16:9, 9:16, 4:3, 3:4 等标准比例 |
| width/height | integer | 可选，与 aspect_ratio 互斥或共存 |
| model | string | 固定值 fal-ai/krea 或子版本如 fal-ai/krea-v1 |
2. 模型特定宽高比支持
Fal Krea 提供不同于其他平台的特殊比例选项。更新后的 OpenClaw 自动识别并转换：
// OpenClaw 配置示例
const imageConfig = {
provider: "fal",
model: "krea",
// 自动映射到 Fal 原生支持的格式
aspectRatio: "21:9", // 超宽屏，Krea 特有
fallbackToAuto: true // 不支持时回退到 auto
};
支持的 Fal 特有比例：
21:9— 电影级超宽屏32:9— 全景格式auto— 智能比例（保留原生行为）
3. 原生自动比例保留
当用户不明确指定尺寸时，OpenClaw 现在正确传递 auto 参数，让 Fal 引擎自主决定最优输出尺寸：
通过 OpenClaw CLI 使用自动比例
openclaw generate image \
--provider fal \
--model krea \
--prompt "abstract digital art" \
--aspect-ratio auto
对比之前的硬编码默认值，这显著提升了生成质量。
4. 图像模型几何参数优化
修复了几何参数（宽度/高度）与宽高比冲突时的优先级逻辑：
// 优先级：显式尺寸 > 模型特定比例 > 通用比例 > auto
function resolveGeometry(config, modelSchema) {
if (config.width && config.height) {
// 显式尺寸最高优先级
return { width: config.width, height: config.height };
}
if (config.aspectRatio && modelSchema.supportsRatio(config.aspectRatio)) {
// 使用模型原生支持的比例
return { aspect_ratio: config.aspectRatio };
}
// 回退到 auto，保留 Fal 原生行为
return { aspect_ratio: "auto" };
}
—
快速开始：配置 Fal Krea 工作流
步骤 1：获取 Fal API 密钥
访问 Fal 控制台 创建 API 密钥。
步骤 2：配置 OpenClaw 凭证
设置环境变量
export FAL_API_KEY="your_fal_key_here"
或在 OpenClaw 配置文件中添加
openclaw config set providers.fal.api_key "$FAL_API_KEY"
步骤 3：创建图像生成 Agent
agent.yaml
name: "creative-designer"
tools:
- name: "generate_image"
provider: "fal"
model: "krea"
config:
default_aspect_ratio: "16:9"
max_images_per_request: 4
workflows:
- trigger: "user_requests_design"
steps:
- tool: "generate_image"
input:
prompt: "{{ user.prompt }}"
aspect_ratio: "{{ user.preferred_ratio | default('16:9') }}"
运行工作流：
openclaw run agent.yaml --input '{"prompt": "minimalist logo design", "preferred_ratio": "1:1"}'
—
常见问题 (FAQ)
Q1: Fal Krea 与其他图像模型（如 DALL-E、Midjourney）有何区别？
Krea 主打实时生成和交互式编辑，延迟通常在 100-300ms，适合需要快速迭代的场景。OpenClaw 的 Schema 抽象让你可以在不同模型间无缝切换，无需修改业务逻辑。
Q2: 如何设置自定义分辨率（非标准宽高比）？
直接指定 width 和 height 即可，OpenClaw 会自动验证 Fal 的约束条件：
{
"width": 1536,
"height": 640,
"aspect_ratio": "custom"
}
若尺寸不被支持，系统会返回可接受的最近似选项。
Q3: auto 比例和固定比例哪个效果更好？
取决于使用场景：
- auto：让模型根据提示词内容智能选择，适合创意探索
- 固定比例：确保输出符合特定平台要求（如 Instagram 1:1、YouTube 16:9）
建议 A/B 测试后决定。
Q4: 是否需要额外安装依赖？
不需要。OpenClaw 内置 Fal 客户端，更新到最新版本即可：
openclaw update
或
pip install -U openclaw
Q5: 如何调试图像生成失败的问题？
启用详细日志查看实际 API 请求：
OPENCLAW_LOG_LEVEL=debug openclaw run agent.yaml
常见错误：
401 Unauthorized：检查FAL_API_KEY422 Invalid aspect ratio：确认比例在 Krea 支持列表中
—
总结与下一步
本次 OpenClaw 更新带来了：
1. ✅ 完整的 Fal Krea Schema 支持 — 标准化配置
2. ✅ 模型特定宽高比 — 解锁 21:9 等特殊格式
3. ✅ 原生 auto 比例保留 — 提升生成质量
4. ✅ 几何参数优先级优化 — 避免配置冲突
建议行动：
- 升级至最新版 OpenClaw：
openclaw update - 阅读 OpenClaw 图像生成文档 了解完整 API
- 尝试将现有 DALL-E 工作流迁移至 Fal Krea 对比效果
—
相关阅读
—