---
title: "OpenClaw で RunAPI を使う - OpenAI 互換 API 設定ガイド"
url: "https://runapi.ai/ja/openclaw.md"
canonical: "https://runapi.ai/ja/openclaw"
locale: "ja"
---

# RunAPI in OpenClaw

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

## Install prompt

Copy this prompt into OpenClaw:

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

## Configuration

```json5
{
  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,
          },
        ],
      },
    },
  },
}
```

## Steps

1. **セットアップ Prompt を貼り付ける** — 最初のタブの Prompt を OpenClaw にコピーします。RUNAPI_API_KEY を読み込み、runapi provider を追加し、既存 provider を残すよう OpenClaw に指示します。
2. **生成された設定を確認する** — OpenClaw は provider 内のローカルなモデル ID として gpt-5.2 を追加し、provider プレフィックス付きの参照 runapi/gpt-5.2 でモデルを選択する必要があります。
3. **選択を確認する** — openclaw models status を実行し、RunAPI モデルに切り替えて OpenClaw セッションを開始します。モデルが表示されない場合は、allowlist に runapi/gpt-5.2 が含まれているか確認してください。

## FAQ

### 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 を追加できます。


## Links

- [Model catalog](https://runapi.ai/ja/models)
- [CLI](https://runapi.ai/ja/cli)
- [MCP Server](https://runapi.ai/ja/mcp)
- [Pricing](https://runapi.ai/ja/pricing)
- [API docs](https://runapi.ai/ja/docs)
- [Hermes Agent setup](https://runapi.ai/ja/hermes-agent)