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.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에 복사하세요. 이 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 모델을 선택합니다.

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에서 모든 모델 사용하기

각 가이드는 OpenClaw에서 RunAPI를 통해 특정 모델을 호출하는 데 필요한 프롬프트, curl 명령, 파라미터, FAQ를 제공합니다.

OpenClaw 설정 질문

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

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

모델 보기 →

OpenClaw에서 RunAPI를 사용하세요.

Prompt로 OpenClaw에 RunAPI 설치

설정 Prompt 붙여넣기

생성된 config 확인

선택 확인

설정 필드

동일한 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