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.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

設定

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 モデルを選択します。

LLM だけじゃない

同じ API キーで画像・動画・音楽も。

多くの OpenClaw ユーザーはモダリティごとに別の GitHub skill をインストールします——画像用、動画用、音楽用と。RunAPI なら、チャット用に設定済みの RUNAPI_API_KEY で画像・動画・音楽の 113 モデル以上をそのまま呼び出せます。追加の skill インストールは不要です。

画像生成

Flux Kontext、Imagen 4、Seedream、GPT Image、Nano Banana で画像を生成・編集。同じ /v1 エンドポイントにプロンプトを送るだけで、RunAPI が指定したモデルにルーティングします。

画像モデルを見る

動画生成

Kling 3.0、Seedance 2.0、Veo 3、Wan 2.7 でテキストや画像から動画を生成。タスクのライフサイクル・コールバック形式・API キーはすべて同じです。

動画モデルを見る

音楽生成

Suno v4 から v5.5 で楽曲を生成。歌詞・スタイル・長さを渡すと、RunAPI は標準のタスクポーリングフローで音声 URL を返します。

音楽モデルを見る

モデルガイド

OpenClaw でどのモデルでも使う

各ガイドでは、RunAPI を通じて OpenClaw 内の特定のモデルを呼び出すためのプロンプト、curl コマンド、パラメーター、FAQ を紹介します。

OpenClaw 設定のよくある質問

OpenClaw で 1つの RunAPI key を使う。

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

モデルを見る →

OpenClaw で RunAPI を使う。

Prompt で OpenClaw に RunAPI を設定する

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

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

選択を確認する

設定項目

同じ API キーで画像・動画・音楽も。

画像生成

動画生成

音楽生成

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