在 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
用提示詞在 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
設定欄位
| 欄位 | 值 | 用途 |
|---|---|---|
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。
在 OpenClaw 中使用任何模型
每份指南都包含在 OpenClaw 中透過 RunAPI 呼叫特定模型所需的提示詞、curl 指令、參數說明與常見問題。
從音訊生成口型同步頭像影片
xAI 圖像與影片生成
文字引導圖像編輯
快速雙語圖像生成
AI 圖像與影片超解析度
Google 圖像生成
字節跳動 4K 圖像生成
阿里巴巴圖像生成與編輯
帶動態控制和音效的影片生成
Google 電影級影片與原生音訊
字節跳動的經濟型影片生成
MiniMax 影片,附帶每日免費額度
開源影片與圖像生成
帶攝影機控制的創意影片
具空間感知的影片生成
從文字生成 AI 音樂
文字轉語音與聲音 AI
OpenAI 聊天與 Responses API
Anthropic Messages API
經濟型推理 LLM
Google AI 模型,無需 GCP
帶文字渲染的 Google 圖像生成
Midjourney
Midjourney AI 繪圖、圖片編輯和圖生影片
專注排版的圖像生成
向量藝術與圖像放大
BFL 圖像生成,pro 與 flex
OpenAI 圖像生成與編輯
OpenClaw 設定常見問題
可以。OpenClaw 透過 models.providers 支援自訂的 OpenAI 相容供應商。請將 RunAPI 設定為 /v1 base URL,將 api 設為 openai-completions,並在 agents.defaults.model.primary 選擇帶有供應商前綴的模型參照。
不用。在 models.providers.runapi.models 內,請使用供應商內部的 ID,例如 gpt-5.2。當你要在 OpenClaw 預設值或指令中選擇模型時,使用帶有供應商前綴的參照 runapi/gpt-5.2。
請將金鑰存到 RUNAPI_API_KEY,並從 OpenClaw 設定中讀取。這樣可避免憑證進入版本控制,也能讓同一份設定在本機 shell、伺服器和自動化流程中通用。
可以。將 models.mode 保持為 merge,並新增 RunAPI 作為其中一個供應商。你既有的供應商仍然可用,而且當你需要復原行為時,也可以在 agents.defaults.model.fallbacks 中加入備援。