---
title: "OpenClaw에서 RunAPI 사용 - OpenAI 호환 설정 가이드"
url: "https://runapi.ai/ko/openclaw.md"
canonical: "https://runapi.ai/ko/openclaw"
locale: "ko"
---

# RunAPI in OpenClaw

RunAPI는 OpenClaw용 OpenAI 호환 endpoint로 동작합니다. 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에 복사하세요. 이 Prompt는 OpenClaw가 RUNAPI_API_KEY를 읽고, runapi provider를 추가하며, 기존 provider를 계속 사용할 수 있게 지시합니다.
2. **생성된 config 확인** — OpenClaw는 provider 내부 모델 ID로 gpt-5.2를 추가한 뒤, provider prefix가 붙은 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 prefix가 붙은 모델 참조를 선택하세요.

### models.providers 안의 모델 ID에 provider prefix를 넣어야 하나요?

아닙니다. models.providers.runapi.models 안에서는 gpt-5.2처럼 provider 내부 ID를 사용하세요. OpenClaw defaults나 명령에서 모델을 선택할 때만 runapi/gpt-5.2처럼 provider prefix가 붙은 참조를 사용합니다.

### RunAPI API key는 어디에 저장해야 하나요?

key를 RUNAPI_API_KEY에 저장하고 OpenClaw config에서 읽도록 하세요. 이렇게 하면 인증 정보가 버전 관리에 들어가지 않고, 같은 config를 로컬 shell, 서버, 자동화 환경에서 사용할 수 있습니다.

### 기존 OpenClaw 모델을 fallback으로 유지할 수 있나요?

네. models.mode를 merge로 유지하고 RunAPI를 provider 중 하나로 추가하세요. 기존 provider는 계속 사용할 수 있으며, 복구 동작이 필요하면 agents.defaults.model.fallbacks 아래에 fallback을 추가할 수 있습니다.


## Links

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