OpenClaw で RunAPI をカスタムモデル provider として使えますか？

はい。OpenClaw は models.providers でカスタム OpenAI 互換 provider をサポートしています。RunAPI の /v1 base URL を設定し、api を openai-completions にして、agents.defaults.model.primary で provider プレフィックス付きのモデル参照を選択します。

models.providers 内のモデル ID に provider プレフィックスは必要ですか？

いいえ。models.providers.runapi.models の中では gpt-5.2 のような provider 内ローカル ID を使います。OpenClaw の defaults やコマンドでモデルを選択するときに runapi/gpt-5.2 という provider プレフィックス付き参照を使います。

RunAPI API key はどこに保存すべきですか？

キーは RUNAPI_API_KEY に保存し、OpenClaw 設定から読み込んでください。これにより認証情報をバージョン管理に入れず、同じ設定をローカル shell、サーバー、自動化環境で使えます。

既存の OpenClaw モデルを fallback として残せますか？

はい。models.mode を merge のままにして、RunAPI を provider の1つとして追加します。既存 provider は引き続き利用でき、復旧動作が必要な場合は agents.defaults.model.fallbacks に fallback を追加できます。

OPENCLAW ガイド

OpenClaw で RunAPI を使う。

RunAPI は OpenClaw の OpenAI 互換エンドポイントとして利用できます。Prompt を OpenClaw に貼り付け、provider の追加を任せます。正確な項目を確認したいときだけ config タブを使ってください。

無料 API キーを取得ドキュメントを読む

Prompt をコピー · 1つの 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.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

Copy prompt first /v1

概要

この設定で変わること

OpenClaw は model provider 設定から、カスタムの OpenAI 互換モデル provider を呼び出せます。最短の方法は、RunAPI のセットアップ Prompt を OpenClaw に貼り付け、agent に設定更新を任せることです。provider ID は OpenClaw 設定内だけで使われ、モデル参照は runapi/gpt-5.2 になり、API key は RUNAPI_API_KEY に残ります。

設定

Prompt で OpenClaw に RunAPI を設定する

セットアップ Prompt を貼り付ける

最初のタブの Prompt を OpenClaw にコピーします。RUNAPI_API_KEY を読み込み、runapi provider を追加し、既存 provider を残すよう OpenClaw に指示します。

Prompt をコピー

生成された設定を確認する

OpenClaw は provider 内のローカルなモデル ID として gpt-5.2 を追加し、provider プレフィックス付きの参照 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 key を環境変数から読み込みます。
`api`	`openai-completions`	OpenAI 互換エンドポイントで使う Chat Completions アダプターを指定します。
`agents.defaults.model.primary`	`runapi/gpt-5.2`	新しい OpenClaw セッションのデフォルトモデルとして RunAPI モデルを選択します。

FAQ

OpenClaw 設定のよくある質問

OpenClaw で 1つの RunAPI key を使う。

モデルカタログからモデル ID を選び、OpenClaw の provider 設定に追加します。

モデルを見る →