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 指南

在 OpenClaw 中使用 RunAPI。

RunAPI 可作為 OpenClaw 的 OpenAI 相容 endpoint。把提示詞貼到 OpenClaw，讓它自動新增 provider；只有在你想確認實際欄位時，再開啟 config 分頁查看。

取得免費 API 金鑰閱讀說明文件

複製提示詞 · 一組 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

Copy prompt first /v1

SETUP

用提示詞在 OpenClaw 安裝 RunAPI

貼上設定提示詞

將第一個分頁中的提示詞複製到 OpenClaw。它會告訴 OpenClaw 讀取 RUNAPI_API_KEY、加入 runapi 供應商，並保留既有供應商可用。

Copy prompt

檢視產生的設定

OpenClaw 應該將 gpt-5.2 加入為供應商內部的模型 ID，然後透過帶有供應商前綴的參照 runapi/gpt-5.2 來選取它。

runapi/gpt-5.2

驗證選取結果

執行 openclaw models status，切換到 RunAPI 模型，並開始 OpenClaw 工作階段。如果模型沒有出現，請確認 allowlist 包含 runapi/gpt-5.2。

openclaw models status

REFERENCE

設定欄位

欄位	值	用途
`baseUrl`	`https://runapi.ai/v1`	將 OpenClaw 指向 RunAPI 的 OpenAI 相容 API 端點。
`apiKey`	`${RUNAPI_API_KEY}`	從環境變數讀取 RunAPI API 金鑰。
`api`	`openai-completions`	使用 OpenAI 相容 endpoint 所預期的 Chat Completions adapter。
`agents.defaults.model.primary`	`runapi/gpt-5.2`	將 RunAPI 模型設為新 OpenClaw 工作階段的預設模型。

不只大型語言模型

同一組金鑰，圖像、影片、音樂一次搞定。

大多數 OpenClaw 使用者需要為每種媒體類型分別安裝 GitHub skill——圖像一個、影片一個、音樂一個。使用 RunAPI，你已為聊天設定的 RUNAPI_API_KEY，同樣能呼叫 113 個以上的圖像、影片和音樂模型。無需額外安裝任何 skill。

圖像生成

透過 Flux Kontext、Imagen 4、Seedream、GPT Image 和 Nano Banana 生成並編輯圖像。將提示詞傳送到同一個 /v1 端點，RunAPI 會路由到你指定的模型。

瀏覽圖像模型

影片生成

使用 Kling 3.0、Seedance 2.0、Veo 3 和 Wan 2.7，從文字或圖像生成影片。相同的任務週期、相同的回呼格式、相同的 API 金鑰。

瀏覽影片模型

音樂生成

透過 Suno v4 到 v5.5 生成歌曲。傳入歌詞、風格和時長，RunAPI 透過標準任務輪詢流程回傳音訊 URL。

瀏覽音樂模型

模型指南

在 OpenClaw 中使用任何模型

每份指南都包含在 OpenClaw 中透過 RunAPI 呼叫特定模型所需的提示詞、curl 指令、參數說明與常見問題。

OpenClaw 設定常見問題

在 OpenClaw 中只用一組 RunAPI 金鑰。

瀏覽模型目錄、選擇模型 ID，然後將它加入你的 OpenClaw 供應商設定。

瀏覽模型 →

在 OpenClaw 中使用 RunAPI。

用提示詞在 OpenClaw 安裝 RunAPI

貼上設定提示詞

檢視產生的設定

驗證選取結果

設定欄位

同一組金鑰，圖像、影片、音樂一次搞定。

圖像生成

影片生成

音樂生成

在 OpenClaw 中使用任何模型

Claude

DeepSeek

ElevenLabs

Embedding

Fish Audio

Flux

Flux 2

Flux Kontext

Gemini

Gemini Omni

Gemini TTS

GLM

GPT

GPT Image

GPT Image 2

GPT-4o Image

Grok

Grok Imagine

Hailuo

HappyHorse

Ideogram V3

Imagen 4

InfiniteTalk

Kimi

Kling

Luma

Midjourney

MiMo

MiniMax

MiniMax H3

Nano Banana

OmniHuman

OpenAI Transcription

OpenAI TTS

PixVerse

Producer

Qwen 2

Qwen 3

Qwen Image

Recraft

Runway

Runway Aleph

Seedance

Seedream

Suno

Topaz

Veo 3.1

Volcengine Lip Sync

Wan