Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

OPENCLAW 가이드

OpenClaw에서 RunAPI를 사용하세요.

RunAPI를 통해 OpenClaw를 250+개의 AI 모델에 연결하세요. 하나의 API key로 OpenClaw 에이전트에서 동영상, 이미지, 음악, 오디오를 직접 생성할 수 있습니다.

Prompt 복사 · 하나의 RunAPI key · 모델 카탈로그 링크
설정 Prompt
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.

OpenClaw에서 사용할 수 있는 모델

전체 모델 6개 표시 중입니다.

비디오

HappyHorse/happyhorse-1.0-i2v

720p/1080p 출력과 캐릭터 가이드 클립을 지원하는 텍스트, 이미지, 편집 비디오 생성을 위한 HappyHorse API 액세스.

이미지

Qwen 2/qwen-2-edit-image

Alibaba 비주얼 모델 제품군의 텍스트-이미지 생성과 이미지 편집을 위한 Qwen 2 API 액세스.

오디오 & 음악

Producer/fuzz-0.8

입력한 가사 그대로 또는 인스트루멘털 프로덕션 브리프로 FUZZ 음악을 생성하는 Producer API를 RunAPI에서 사용하세요.

오디오 & 음악

ElevenLabs/text-to-dialogue-v3

ElevenLabs는 RunAPI를 통해 다국어 음성 합성과 여러 화자의 대화 음성 생성을 제공합니다.

텍스트

Qwen/qwen3.5-122b-a10b

RunAPI를 통한 Qwen API 액세스: 오픈 웨이트 Qwen3.5, Qwen3.6, Qwen3-VL, Qwen3-Coder-Next 언어 모델을 OpenAI 호환 Chat Completions로 사용합니다.

텍스트

Qwen/qwen3.5-27b

RunAPI를 통한 Qwen API 액세스: 오픈 웨이트 Qwen3.5, Qwen3.6, Qwen3-VL, Qwen3-Coder-Next 언어 모델을 OpenAI 호환 Chat Completions로 사용합니다.

작동 방식

3단계로 연결

  1. 설정

    OpenClaw 설정에 RunAPI API 키를 추가하세요. 키 하나로 모든 모델에 접근할 수 있습니다.

  2. 모델 선택

    에이전트가 사용할 모델을 선택하세요. 모달리티, 품질 또는 비용으로 필터링할 수 있습니다.

  3. 생성

    OpenClaw 에이전트가 RunAPI의 통합 API로 미디어를 생성합니다. 결과는 webhook 또는 폴링으로 전달됩니다.

사용 사례

자동화된 콘텐츠

OpenClaw가 마케팅 동영상, 제품 이미지, 오디오 콘텐츠를 자동으로 생성하도록 하세요.

멀티모달 워크플로

하나의 에이전트 대화에서 동영상, 이미지, 음악 생성을 연결하세요.

비용 최적화 라우팅

OpenClaw는 모델 가격을 비교하고 가장 비용 효율적인 옵션을 선택할 수 있습니다.

OpenClaw 설정 질문

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가 추가 스킬 없이 RunAPI로 이미지를 생성할 수 있나요?

네. 채팅용으로 설정한 RUNAPI_API_KEY와 /v1 엔드포인트는 이미지 생성 요청도 받습니다. flux-kontext-pro나 imagen-4 같은 모델을 지정하면 OpenClaw가 기존 RunAPI 공급자를 통해 호출할 수 있습니다. GitHub 스킬이나 별도의 API 키는 필요 없습니다. 전체 안내는 OpenClaw 이미지 생성 페이지를 확인하세요.

OpenClaw 에이전트는 이미지나 동영상 작업이 완료되었는지 어떻게 확인하나요?

이미지, 동영상, 음악 작업은 비동기입니다. RunAPI는 첫 호출에서 작업 ID를 반환합니다. OpenClaw 에이전트는 완료될 때까지 상태 엔드포인트를 폴링한 다음 결과 URL을 받습니다. RunAPI SDK를 사용하면 폴링이 자동 처리됩니다.

팀과 함께 만들고 계신가요?

엔터프라이즈 설정, 통합 및 기술 문의를 도와드립니다.

문의하기