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을 추가할 수 있습니다.

OPENCLAW 가이드

OpenClaw에서 RunAPI를 사용하세요.

RunAPI는 OpenClaw용 OpenAI 호환 endpoint로 동작합니다. Prompt를 OpenClaw에 붙여넣고 provider 추가를 맡기세요. 정확한 필드를 확인해야 할 때만 config 탭을 사용하면 됩니다.

무료 API Key 받기 문서 읽기

Prompt 복사 · 하나의 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가 자체 config를 업데이트하게 하는 것입니다. provider ID는 OpenClaw config 내부에서만 사용되고, 모델 참조는 runapi/gpt-5.2가 되며, API key는 RUNAPI_API_KEY에 유지됩니다.

설정

Prompt로 OpenClaw에 RunAPI 설치

설정 Prompt 붙여넣기

첫 번째 탭의 Prompt를 OpenClaw에 복사하세요. 이 Prompt는 OpenClaw가 RUNAPI_API_KEY를 읽고, runapi provider를 추가하며, 기존 provider를 계속 사용할 수 있게 지시합니다.

Prompt 복사

생성된 config 확인

OpenClaw는 provider 내부 모델 ID로 gpt-5.2를 추가한 뒤, provider prefix가 붙은 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 호환 endpoint가 기대하는 Chat Completions 어댑터를 사용합니다.
`agents.defaults.model.primary`	`runapi/gpt-5.2`	새 OpenClaw 세션의 기본 모델로 RunAPI 모델을 선택합니다.

FAQ

OpenClaw 설정 질문

OpenClaw 안에서 하나의 RunAPI key를 사용하세요.

모델 카탈로그를 둘러보고 model ID를 선택한 뒤 OpenClaw provider config에 추가하세요.

모델 보기 →