OpenClaw fal.ai 技能指南

OpenClaw fal.ai 技能概述

fal.ai Image Gen 技能 将 OpenClaw 连接到 fal.ai 云端 GPU 平台，使你的智能体具备使用最先进 AI 模型生成、编辑和变换图像的能力。安装后，你可以通过自然语言描述创建插图、缩略图、概念艺术和设计原型 — 全程无需离开当前工作流。

fal.ai 提供数十种图像生成模型的访问权限，包括 FLUX.1、Stable Diffusion XL 以及针对不同艺术风格的专用模型。OpenClaw fal.ai 技能将这些能力封装为对话式接口，让你无需切换工具即可反复迭代图像效果。

典型工作流：

1. 让 OpenClaw 根据文本描述生成一张图像。
2. 智能体选择合适的模型，将提示发送到 fal.ai 的 API 并下载生成结果。
3. 生成的图像保存到本地并展示 — 无需浏览器或其他工具。

该技能非常适合在开发过程中需要快速视觉素材的开发者、为博客或文档制作插图的内容创作者，以及探索概念艺术的设计师。它可以与 FFmpeg Video Editor 技能搭配使用，将生成的图像制作成视频内容；也可以与 SlideSpeak 技能搭配，为演示文稿添加视觉元素。

fal.ai 技能安装前的准备

在安装 fal.ai 技能之前，请确保你已具备：

• 已安装并运行 OpenClaw（v1.0+）
• 一个 fal.ai 账号 — 前往 fal.ai 注册
• 一个 fal.ai API 密钥 — 在 控制面板 中生成
• 已安装 clawhub CLI 用于技能管理

验证你的环境：

# 检查 OpenClaw 版本
openclaw --version

# 验证 API 密钥是否已设置
echo $FAL_KEY

无需本地 GPU 或其他重量级依赖。所有图像生成均在 fal.ai 的云端基础设施上运行，因此该技能可在任何有互联网连接的机器上使用。

如何安装 fal.ai 技能

使用一条命令安装 fal.ai 技能：

npx clawhub@latest install fal-ai

验证安装：

clawhub list

你应该能在已安装技能列表中看到 fal-ai。

fal.ai 技能配置指南

fal.ai 技能需要 API 密钥进行身份验证。所有图像生成按用量计费 — 费用取决于所用模型和分辨率。

API 密钥设置

从 fal.ai 控制面板 获取你的 API 密钥，然后将其设置为环境变量：

# 设置你的 fal.ai API 密钥
export FAL_KEY=your_api_key_here

如需持久化配置，将其添加到 shell 配置文件中：

# 添加到 ~/.bashrc、~/.zshrc 或等效文件
echo 'export FAL_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc

支持的模型

该技能支持多种图像生成模型。以下是最常用的选项：

| 模型 | 最适用于 | 速度 | 质量 | |------|----------|------|------| | FLUX.1 [schnell] | 快速草稿和迭代 | 极快 | 良好 | | FLUX.1 [dev] | 高质量生成 | 中等 | 优秀 | | FLUX.1 [pro] | 生产级图像 | 较慢 | 最佳 | | Stable Diffusion XL | 通用图像生成 | 快速 | 良好 | | FLUX Realism | 照片级真实图像 | 中等 | 优秀 |

你可以在提示中指定模型，也可以让智能体根据你的需求自动选择。

重要提示： 切勿将 API 密钥硬编码到配置文件中。请使用环境变量或密钥管理工具（如 1Password 技能）。参阅 安全清单 了解通用的凭证管理指南。

fal.ai 技能使用示例

1. 从文本生成图像

你： "生成一个极简风格的科技创业公司 Logo，公司名叫 'NexaFlow' — 简洁线条，蓝色渐变，深色背景。"

智能体将提示发送到 FLUX.1 [dev]，指定适合 Logo 的尺寸（1024×1024）。生成的图像保存到你的工作目录并展示。如果效果不够理想，你可以要求进一步调整。

2. 创建博客插图

你： "为一篇关于云计算的博客文章创建一张头图。风格：等距插画，现代感，紫色和青色配色方案，1200×630 像素。"

智能体按照社交媒体分享（Open Graph 格式）所需的精确尺寸生成图像。它会选择针对插画风格优化的模型，并返回包含所用提示和模型版本等元数据的图像。

3. 生成多种变体

你： "给我生成 4 种不同的奇幻风景画变体，包含山脉、湖泊和北极光。"

智能体发送提示时设置 num_images: 4，在一次 API 调用中生成四种独特的变体。所有四张图像保存到本地，供你比较后选择最佳方案。

4. 放大已有图像

你： "将 ./assets/thumb.png 这张缩略图放大到 4 倍分辨率。"

智能体使用 fal.ai 的放大模型，将图像从原始分辨率提升到 4 倍，在保留细节的同时增加清晰度。放大后的图像保存在原图旁边。

5. 使用局部重绘进行编辑

你： "去除 ./images/photo.png 右下角的水印，并自然填充该区域。"

智能体使用局部重绘模型遮罩指定区域，并根据周围内容重新生成，产出一个无水印的干净结果。

安全与最佳实践

使用 fal.ai 技能时，请遵循以下准则：

• 监控 API 用量。 fal.ai 按生成的图像数量计费。定期查看你的 用量面板，避免产生意外费用。如有条件，设置账单提醒。
• 保护你的 API 密钥。 将 FAL_KEY 存储在环境变量或密钥管理工具中。切勿将其提交到版本控制系统或以明文形式分享。
• 审查生成的内容。 AI 生成的图像可能包含伪影、偏差或非预期内容。在发布或对外分享之前，务必进行审查。
• 遵守内容政策。 fal.ai 的使用政策禁止生成有害、欺骗性或违法的内容。请确保你的提示符合其 服务条款。
• 控制输出目录。 生成的图像默认保存到你的工作目录。确保敏感或草稿图像不会被意外提交到公开仓库。
• 选择合适的模型。 草稿和迭代阶段使用更快、更便宜的模型（FLUX.1 [schnell]）。正式生产图像时再使用高端模型（FLUX.1 [pro]），以便合理控制成本。

常见错误与故障排除

"Authentication failed" 或 "Invalid API key"

你的 FAL_KEY 环境变量缺失、为空或无效。

# 检查密钥是否已设置
echo $FAL_KEY

# 如果缺失则设置
export FAL_KEY=your_api_key_here

如果密钥已设置但仍然报错，请前往 fal.ai 控制面板 重新生成。旧密钥可能已被撤销。

"Rate limit exceeded"

你已超出当前套餐的 API 速率限制。

1. 等待几分钟后重试。
2. 在 用量面板 查看当前限制。
3. 考虑升级套餐以获取更高的速率限制。
4. 批量生成时，在请求之间添加延迟。

"Model not found" 或 "Invalid model ID"

指定的模型名称或 ID 不正确，或已被废弃。

1. 在 fal.ai 模型库 查看当前可用的模型 ID。
2. 使用模型的完整标识符（例如 fal-ai/flux/dev，而非仅写 flux）。
3. 部分模型可能需要特定的套餐等级 — 请确认你的访问权限。