在 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.2" with display name "RunAPI GPT 5.2".
- Set the default model to "runapi/gpt-5.2" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.2` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.{
agents: {
defaults: {
model: { primary: "runapi/gpt-5.2" },
models: {
"runapi/gpt-5.2": { alias: "RunAPI GPT 5.2" },
},
},
},
models: {
mode: "merge",
providers: {
runapi: {
baseUrl: "https://runapi.ai/v1",
apiKey: "${RUNAPI_API_KEY}",
api: "openai-completions",
models: [
{
id: "gpt-5.2",
name: "RunAPI GPT 5.2",
reasoning: false,
input: ["text"],
contextWindow: 128000,
maxTokens: 8192,
},
],
},
},
},
}export RUNAPI_API_KEY="runapi_xxx"
openclaw models status
openclaw models set runapi/gpt-5.2
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 的預設模型。 |
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。