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

在 OpenClaw 使用 RunAPI。

RunAPI 可作為 OpenClaw 的 OpenAI 相容 endpoint 使用。將提示複製到 OpenClaw，讓它自動加入 provider；只有當你想檢查實際欄位時，才需要開啟 config 分頁。

免費取得 API Key 閱讀文件

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

Copy prompt first /v1

SETUP

以提示安裝 RunAPI 到 OpenClaw

貼上設定提示

將第一個分頁的提示複製到 OpenClaw。它會指示 OpenClaw 讀取 RUNAPI_API_KEY、加入 runapi provider，並保留現有 provider 可用。

Copy prompt

檢查產生的設定

OpenClaw 應會加入 gpt-5.2 作為 provider-local model ID，然後透過帶 provider 前綴的參考 runapi/gpt-5.2 選取它。

runapi/gpt-5.2

驗證選取結果

執行 openclaw models status，切換至 RunAPI 模型，並開始 OpenClaw session。如果模型未顯示，請確認 allowlist 包含 runapi/gpt-5.2。

openclaw models status

REFERENCE

設定欄位

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

不止大語言模型

同一個 key，圖像、影片、音樂全包。

大多數 OpenClaw 用戶需要為每種媒體類型分別安裝 GitHub skill——圖像一個、影片一個、音樂一個。用 RunAPI，你為聊天配置的同一個 RUNAPI_API_KEY，同樣可以呼叫 113 個以上的圖像、影片及音樂模型。毋須額外安裝任何 skill。

圖像生成

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

瀏覽圖像模型

影片生成

以 Kling 3.0、Seedance 2.0、Veo 3 及 Wan 2.7 從文字或圖像生成影片。相同的 task lifecycle、相同的 callback 格式、相同的 API key。

瀏覽影片模型

音樂生成

透過 Suno v4 至 v5.5 生成歌曲。傳入歌詞、風格及時長，RunAPI 透過標準 task polling 流程回傳音訊 URL。

瀏覽音樂模型

模型指南

在 OpenClaw 中使用任何模型

每份指南展示如何透過 RunAPI 在 OpenClaw 中呼叫指定模型，包括提示詞、curl 指令、參數說明及常見問題。

OpenClaw 設定常見問題

在 OpenClaw 內只用一組 RunAPI key。

瀏覽 model catalog，選擇 model ID，然後加入你的 OpenClaw provider config。

瀏覽模型 →

在 OpenClaw 使用 RunAPI。

以提示安裝 RunAPI 到 OpenClaw

貼上設定提示

檢查產生的設定

驗證選取結果

設定欄位

同一個 key，圖像、影片、音樂全包。

圖像生成

影片生成

音樂生成

在 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