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 설치

1

설정 Prompt 붙여넣기

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

Prompt 복사
2

생성된 config 확인

OpenClaw는 provider 내부 모델 ID로 gpt-5.2를 추가한 뒤, provider prefix가 붙은 runapi/gpt-5.2 참조로 모델을 선택해야 합니다.

runapi/gpt-5.2
3

선택 확인

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를 제공합니다.

InfiniteTalk

오디오로 디지털 휴먼 영상 생성

Grok Imagine

xAI 이미지 및 영상 생성

Flux Kontext

텍스트 기반 이미지 편집

Z Image

빠른 이중 언어 이미지 생성

Topaz

AI 이미지 및 영상 초고해상도

Imagen 4

Google 이미지 생성

Seedream

Bytedance 4K 이미지 생성

Qwen 2 Image

알리바바 이미지 생성 및 편집

Kling

모션 제어와 사운드가 있는 비디오 생성

Veo 3

네이티브 오디오가 있는 Google 시네마틱 비디오

Seedance

Bytedance의 저비용 비디오 생성

Hailuo

무료 일일 할당량이 있는 MiniMax 비디오

Wan

오픈소스 비디오 및 이미지 생성

Runway

카메라 제어가 있는 크리에이티브 비디오

Luma

공간 인식 비디오 변환

Suno

텍스트로 AI 음악 생성

ElevenLabs

텍스트 음성 변환 및 음성 AI

GPT

OpenAI 채팅 및 응답 API

Claude

Anthropic 메시지 API

DeepSeek

추론 기능이 있는 저비용 LLM

Gemini

GCP 없이 Google AI 모델 사용

Nano Banana

텍스트 렌더링이 뛰어난 Google 이미지 생성

Midjourney

Midjourney AI 이미지 생성, 이미지 편집, 이미지 투 비디오

Ideogram V3

타이포그래피 중심 이미지 생성

Recraft

벡터 아트 및 이미지 화질 개선

Flux 2

BFL 이미지 생성, Pro 및 Flex

GPT Image

OpenAI 이미지 생성 및 편집
FAQ

OpenClaw 설정 질문

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

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

모델 보기 →