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

OPENCLAW 指南

在 OpenClaw 使用 RunAPI。

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

複製提示 · 一個 RunAPI key · 模型目錄連結

設定提示

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 相容 provider。請以 /v1 base URL 設定 RunAPI，將 api 設為 openai-completions，並在 agents.defaults.model.primary 選擇帶 provider 前綴的 model reference。

在 models.providers 內，model ID 需要包含 provider prefix 嗎？

不用。在 models.providers.runapi.models 內，請使用 provider-local ID，例如 gpt-5.2。當你在 OpenClaw defaults 或 commands 選擇模型時，使用帶 provider 前綴的 reference runapi/gpt-5.2。

RunAPI API key 應該存放在哪裡？

將 key 存在 RUNAPI_API_KEY，並由 OpenClaw config 讀取。這樣可避免把 credential 放入 version control，亦方便同一份設定在本機 shell、server 和 automation 上共用。

可以保留現有的 OpenClaw models 作為 fallback 嗎？

可以。將 models.mode 保持為 merge，並加入 RunAPI 作為其中一個 provider。你現有的 provider 仍然可用；如需 recovery 行為，可在 agents.defaults.model.fallbacks 加入 fallback。

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 均已包括。

正與團隊一起構建？

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

聯絡我們