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. 從文字生成圖像

你：「為一家名為 'NexaFlow' 的科技新創公司生成一個極簡風格的標誌——簡潔線條、藍色漸層、深色背景。」

代理將提示傳送至 FLUX.1 [dev]，指定適合標誌的尺寸（1024x1024）。生成的圖像儲存至您的工作目錄並顯示。如果結果不夠理想，您可以要求進一步調整。

2. 建立部落格插圖

你：「為一篇關於雲端運算的部落格文章建立一張主視覺圖。風格：等距插圖、現代感、紫色和青色配色方案，尺寸 1200x630 像素。」

代理以指定的社群媒體分享尺寸（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]）保留給最終的生產級圖像，以管理成本。

常見錯誤與故障排除

「驗證失敗」或「API 金鑰無效」

您的 FAL_KEY 環境變數缺失、為空或無效。

# 檢查金鑰是否已設定
echo $FAL_KEY

# 若缺失則設定
export FAL_KEY=your_api_key_here

如果金鑰已設定但仍然失敗，請從 fal.ai 控制台重新產生。舊金鑰可能已被撤銷。

「超出速率限制」

您已超出當前方案的 API 速率限制。

1. 等待幾分鐘後重試。
2. 查看您的使用量控制台以瞭解目前的限制。
3. 考慮升級方案以獲得更高的速率限制。
4. 批量生成時，在請求之間加入延遲。

「找不到模型」或「模型 ID 無效」

指定的模型名稱或 ID 不正確或已被棄用。

1. 查看 fal.ai 模型庫以取得目前的模型 ID。
2. 使用模型的完整識別碼（例如 fal-ai/flux/dev 而非僅 flux）。
3. 某些模型可能需要特定的方案等級——請確認您的存取權限。