Claude 訪客：新帳戶可在 30 天內獲得 $1.00 API 贈送額度。每人限領一次，僅用於 API 用量。

OPENCLAW 指南

在 OpenClaw 中使用 RunAPI。

透過 RunAPI 將 OpenClaw 連接至 250+ 個 AI 模型。只用一組 API key，就能直接從 OpenClaw agent 生成影片、圖像、音樂與音訊。

複製提示詞 · 一組 RunAPI 金鑰 · model catalog 連結

設定提示詞

Configure this OpenClaw workspace to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a model provider named runapi.
- Use baseUrl "https://runapi.ai/v1".
- Use api "openai-completions".
- Register provider-local model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

{
  agents: {
    defaults: {
      model: { primary: "runapi/gpt-5.5" },
      models: {
        "runapi/gpt-5.5": { alias: "RunAPI GPT 5.5" },
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      runapi: {
        baseUrl: "https://runapi.ai/v1",
        apiKey: "${RUNAPI_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "gpt-5.5",
            name: "RunAPI GPT 5.5",
            reasoning: false,
            input: ["text"],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.5
openclaw

OpenClaw 可用模型

HappyHorse/happyhorse-1.0-i2v

HappyHorse API 存取，支援文字生成影片、圖片生成影片與影片編輯，輸出 720p/1080p，並可依角色參考生成片段。

Qwen 2/qwen-2-edit-image

Qwen 2 API 存取，支援阿里巴巴視覺模型系列的文字生成圖片與圖片編輯。

Producer/fuzz-0.8

Producer API 提供 FUZZ 音樂生成，可依指定歌詞創作人聲歌曲，或依製作說明創作純音樂。

ElevenLabs/text-to-dialogue-v3

ElevenLabs 透過 RunAPI 提供多語言語音合成和多位說話者的對話生成。

Qwen/qwen3.5-122b-a10b

透過 RunAPI 呼叫 Qwen API：開放權重的 Qwen3.5、Qwen3.6、Qwen3-VL 與 Qwen3-Coder-Next 語言模型，使用 OpenAI 相容的 Chat Completions。

Qwen/qwen3.5-27b

透過 RunAPI 呼叫 Qwen API：開放權重的 Qwen3.5、Qwen3.6、Qwen3-VL 與 Qwen3-Coder-Next 語言模型，使用 OpenAI 相容的 Chat Completions。

運作方式

3 步完成連線

設定

將 RunAPI API 金鑰加入 OpenClaw 設定。一個金鑰即可存取所有模型。
選擇模型

選擇代理程式可以使用的模型。依模態、品質或成本篩選。
生成

OpenClaw 代理程式透過 RunAPI 的統一 API 生成媒體。結果透過 webhook 或輪詢傳回。

使用情境

自動化內容

讓 OpenClaw 自動產生行銷影片、產品圖片和音訊內容。

多模態工作流程

在一次 agent 對話中串聯影片、圖片和音樂生成。

成本最佳化路由

OpenClaw 可以比較模型價格並選擇最具成本效益的選項。

OpenClaw 設定常見問題

OpenClaw 可以把 RunAPI 當作自訂模型供應商嗎？

可以。OpenClaw 透過 models.providers 支援自訂的 OpenAI 相容供應商。請將 RunAPI 設定為 /v1 base URL，將 api 設為 openai-completions，並在 agents.defaults.model.primary 選擇帶有供應商前綴的模型參照。

模型 ID 在 models.providers 裡需要包含供應商前綴嗎？

不用。在 models.providers.runapi.models 內，請使用供應商內部的 ID，例如 gpt-5.2。當你要在 OpenClaw 預設值或指令中選擇模型時，使用帶有供應商前綴的參照 runapi/gpt-5.2。

我應該把 RunAPI API 金鑰存在哪裡？

請將金鑰存到 RUNAPI_API_KEY，並從 OpenClaw 設定中讀取。這樣可避免憑證進入版本控制，也能讓同一份設定在本機 shell、伺服器和自動化流程中通用。

我可以保留現有的 OpenClaw 模型作為備援嗎？

可以。將 models.mode 保持為 merge，並新增 RunAPI 作為其中一個供應商。你既有的供應商仍然可用，而且當你需要復原行為時，也可以在 agents.defaults.model.fallbacks 中加入備援。

OpenClaw 無需安裝額外技能就能透過 RunAPI 生成圖片嗎？

可以。為聊天設定的 RUNAPI_API_KEY 和 /v1 端點同樣接受圖片生成請求。指定 flux-kontext-pro 或 imagen-4 等模型，OpenClaw 即可透過現有 RunAPI 供應商呼叫，無需 GitHub 技能或獨立 API 金鑰。完整指南請參閱 OpenClaw 圖片生成頁面。

OpenClaw 智慧代理如何知道圖片或影片任務已完成？

圖片、影片和音樂任務均為非同步任務。RunAPI 在首次呼叫時傳回任務 ID。OpenClaw 智慧代理輪詢狀態端點直到任務完成，然後接收輸出 URL。使用 RunAPI SDK 時，輪詢會自動處理。

以 agent 執行 RunAPI 的其他方式

工作流程自動化

Hermes Agent

透過 Hermes 路由生成步驟，讓它依工作選擇模型。同一把 key、同一份餘額，無需額外設定。

團隊助理

WorkBuddy

讓共用工作區助理存取影片、圖像和 LLM 模型，並為每把 key 設定消費上限。

SDK 或 MCP

自行建立

透過 RunAPI SDK 或 MCP server ——工具、輪詢和 webhook 均已包含。

正在與團隊一起打造？

我們可以協助企業設定、整合與技術問題。

聯絡我們