在 OpenClaw 使用 RunAPI。
RunAPI 可作為 OpenClaw 的 OpenAI 相容 endpoint 使用。將提示複製到 OpenClaw，讓它自動加入 provider；只有當你想檢查實際欄位時，才需要開啟 config 分頁。
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以提示安裝 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
設定欄位
| 欄位 | 值 | 用途 |
|---|---|---|
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。
在 OpenClaw 中使用任何模型
每份指南展示如何透過 RunAPI 在 OpenClaw 中呼叫指定模型，包括提示詞、curl 指令、參數說明及常見問題。
InfiniteTalk
由音訊生成對話頭像影片
Grok Imagine
xAI 圖像與影片生成
Flux Kontext
文字引導圖像編輯
Z Image
快速雙語圖像生成
Topaz
AI 圖像與影片超解像度
Imagen 4
Google 圖像生成
Seedream
Bytedance 4K 圖像生成
Qwen 2 Image
Alibaba 圖像生成與編輯
Kling
帶動作控制和音訊的影片生成
Veo 3
Google 電影級影片，含原生音訊
Seedance
Bytedance 平價影片生成
Hailuo
MiniMax 影片，每日免費配額
Wan
開源影片與圖像生成
Runway
帶鏡頭控制的創意影片
Luma
空間感知影片生成
Suno
文字生成 AI 音樂
ElevenLabs
文字轉語音及語音 AI
GPT
OpenAI 對話與 Responses API
Claude
Anthropic Messages API
DeepSeek
平價 LLM，內建推理能力
Gemini
Google AI 模型，無需 GCP
Nano Banana
Google 圖像生成，支援文字渲染
Midjourney
Midjourney AI 圖像生成、圖片編輯和圖生影片
Ideogram V3
專注排版的圖像生成
Recraft
向量藝術及圖像放大
Flux 2
BFL 圖像生成，Pro 及 Flex 版本
GPT Image
OpenAI 圖像生成與編輯
OpenClaw 設定常見問題
可以。OpenClaw 支援透過 models.providers 使用自訂 OpenAI 相容 provider。請以 /v1 base URL 設定 RunAPI，將 api 設為 openai-completions，並在 agents.defaults.model.primary 選擇帶 provider 前綴的 model reference。
不用。在 models.providers.runapi.models 內，請使用 provider-local ID，例如 gpt-5.2。當你在 OpenClaw defaults 或 commands 選擇模型時，使用帶 provider 前綴的 reference runapi/gpt-5.2。
將 key 存在 RUNAPI_API_KEY，並由 OpenClaw config 讀取。這樣可避免把 credential 放入 version control，亦方便同一份設定在本機 shell、server 和 automation 上共用。
可以。將 models.mode 保持為 merge，並加入 RunAPI 作為其中一個 provider。你現有的 provider 仍然可用；如需 recovery 行為，可在 agents.defaults.model.fallbacks 加入 fallback。