Runware Run은 에이전트가 모든 모달리티에서 Runware 작업을 안전하고 스키마에 유효하며 비용을 고려하여 실행하는 방법을 가르치는 기초 Openclaw Skills 기술입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install runware-run
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 runware-run 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Runware Run란 무엇인가요?
Runware Run은 모델 선택을 실제적이고 신뢰할 수 있는 Runware 호출로 전환하는 Openclaw Skills의 실행 계약입니다.
이는 에이전트에게 올바른 AIR 및 taskType을 선택하고, 모델의 JSON Schema를 해석하며, 입력을 올바르게 업로드하거나 인코딩하고, 동기 또는 비동기 제공을 선택하며, 모달리티별 응답을 추측 없이 읽는 방법을 안내합니다. 결과적으로 TypeScript SDK, Python SDK, MCP 도구, CLI 또는 api.runware.ai/v1의 OpenAI 호환 엔드포인트를 통해 Runware를 호출할 때 무효한 요청이 줄어들고 자동화가 깔끔해지며 예측 가능한 비용 제어가 가능해집니다.
Runware Run 활용 사례
Openclaw Skills 팀은 다음과 같은 경우에 이 기술을 사용합니다:
- 에이전트가 실제 Runware 생성 호출을 수행하려 하고 올바른 실행 흐름이 필요할 때.
- imageInference, videoInference, audioInference 또는 modelUpload 중에서 선택해야 할 때.
- 새로 출시된 모델이 아직 SDK 레지스트리에 없어서 명시적인 taskType이 필요할 때.
- 배포 전에 페이로드를 모델 스키마에 대해 검증해야 할 때.
- 로컬 파일을 먼저 업로드하고 URLs 또는 base64 입력으로 참조해야 할 때.
- 실행 시간이 긴 작업에 taskUUID 및 getResponse를 사용한 비동기 폴링이 필요할 때.
- X-Runware-Dry-Run: 1 또는 includeCost: true를 통해 비용 가시성을 원할 때.
- 동일한 Runware 계약이 SDK, MCP, CLI 또는 API 환경 전체에서 작동해야 할 때.
Runware Run 작동 원리
- 모델 및 실행 유형 선택. runware-models에서 모델을 검색하고, AIR를 선택한 다음 모달리티를 기반으로 taskType을 설정합니다. 새로 출시되었거나 등록되지 않은 모델의 경우 taskType을 명시적으로 전달합니다.
- 스키마 해석. 모델의 JSON Schema를 검사하고 문서화된 필드 이름만 채웁니다. 매개변수 이름을 임의로 만들지 마십시오.
- 입력 준비. 이미지, 비디오, 오디오, 마스크 및 기타 자산을 URLs 또는 base64로 전송합니다. SDK 또는 MCP 헬퍼를 사용할 때는 로컬 파일을 먼저 업로드합니다.
- 올바른 전달 모드로 실행. 이미지 및 기타 빠른 작업에는 동기 호출을 사용합니다. 비디오, 오디오, 3D 및 학습에는 비동기 실행을 사용한 다음, 완료될 때까지 반환된 taskUUID를 사용하여 getResponse를 폴링합니다.
- 최종 출력 읽기. 이미지 URLs, videoURL 또는 3D용 outputs.files[].url과 같은 모달리티별 결과를 사용하고, 필요할 때 includeCost로 비용을 캡처합니다.
- 프로덕션 전 검증 및 최적화. X-Runware-Dry-Run: 1을 사용하여 실제 실행이나 과금 없이 요청을 검증하고 비용을 미리 확인합니다.
Runware Run 설정 가이드
- 사용할 환경을 설치합니다.
npm install @runware/sdk
pip install runware
- 스키마 해석, 파일 업로드 및 비동기 폴링을 자동으로 처리해주므로 가능하면 SDK 또는 MCP를 선호하는 것이 좋습니다.
- 프로덕션 전에 불확실한 페이로드를
X-Runware-Dry-Run: 1로 검증하고, 실제 실행 시includeCost: true를 활성화합니다. - 실행 시간이 긴 작업의 경우 반환된 taskUUID를 저장하고 작업이 최종 상태에 도달할 때까지 getResponse를 폴링합니다.
Runware Run 데이터 스키마 및 분류 체계
Runware Run은 스키마 우선 요청/응답 모델을 따릅니다:
| 엔티티 | 목적 | 규칙 |
|---|---|---|
taskType |
모달리티 파이프라인 선택 | imageInference, videoInference, audioInference 또는 modelUpload 사용 |
model / AIR |
실행할 모델 식별 | bfl:7@1과 같은 AIR 사용. 슬러그(slug)도 해석 가능 |
| 매개변수 | 모델별 옵션 | 모델의 JSON Schema와 정확히 일치해야 함 |
| 입력 | 미디어 및 참조 자산 | URLs 또는 base64 전달. 로컬 파일 우선 업로드 |
| 전달 모드 | 런타임 동작 제어 | 이미지 및 빠른 작업은 동기, 비디오, 오디오, 3D 및 학습은 비동기 |
taskUUID |
비동기 작업 핸들 | 실행 시간이 긴 작업에 대해 반환됨. getResponse 폴링 |
| 출력 | 최종 결과물 | 이미지는 URLs 반환, 비디오는 videoURL 반환, 3D는 outputs.files[].url 반환 |
| 비용 메타데이터 | 가격 가시성 | X-Runware-Dry-Run: 1 예측 검증 전용, includeCost: true 실제 실행 |
메타데이터 분류
- 식별: AIR 또는 슬러그, 필요한 경우
taskType추가. - 입력 페이로드: 프롬프트, 참조 미디어, 마스크, 오디오, 학습 자산 및 기타 스키마 승인 필드.
- 실행 메타데이터: 동기 vs 비동기, 반환된
taskUUID및 폴링 상태. - 과금 메타데이터: dry-run 검증 및 실제 비용 보고.
- 출력 결과물: 단일 응답 형태를 가정하지 않고 모달리티에 특화된 URLs 또는 파일 목록 반환.
Runware Run 고급 기능
- 실행 전 스키마 해석을 통해 추측 및 유효하지 않은 매개변수 이름을 제거합니다.
- Dry-run 모드는 실행이나 과금 없이 요청 형태를 검증하고 비용을 반환합니다.
includeCost: true는 예산을 고려한 자동화를 위해 실제 실행 시의 실시간 지출을 나타냅니다.taskUUID및getResponse를 사용한 비동기 오케스트레이션은 긴 작업이 동기 제한 시간 초과에 걸리지 않도록 합니다.- TypeScript SDK, Python SDK, MCP, CLI 및 api.runware.ai/v1 전체에서 크로스 플랫폼 패리티를 제공합니다.
- AIR 기반 주소 지정 및 명시적 taskType은 레지스트리 업데이트 전에 새로 출시되었거나 테스트 중인 모델을 지원합니다.
- 로컬 파일, 참조 이미지, 소스 비디오, 오디오 및 마스크를 위한 내장 업로드 흐름을 제공합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Text in Image Generation
정확하고 읽기 쉬우며 스타일이 지정된 텍스트 레이어를 갖춘 고품질 이미지를 생성하기 위한 특화된 워크플로우입니다.
보이스오버 및 나레이션
Openclaw Skills는 대괄호 기반의 디렉션, 목소리 선택 및 모델 인식 정규화를 통해 스크립트를 표현력 있는 단일 화자 보이스오버 오디오로 변환합니다.
오픈소스 이슈 우선 워크플로우
오픈소스 버그에 대한 커스텀 우회 방법을 작성하기 전에 업스트림 이슈 및 릴리스를 먼저 검색하도록 강제하는 Openclaw Skills 워크플로우입니다.
AI Music Composer
사용자의 음성을 복제하고 작사 및 스타일 선호도를 기반으로 완전하고 개인화된 노래를 작곡하는 전문 엔드투엔드 AI 음악 생성기입니다.
시각 및 미디어 이해
Openclaw Skills는 미디어 입력을 캡션, OCR, 트랜스크립트, 요약, 태그 및 구조화된 JSON과 같은 근거 있는 텍스트 출력으로 변환합니다.
이미지 복원 및 업스케일
Openclaw Skills는 흐릿하거나 노이즈가 있거나 저해상도인 이미지를 가장 적합한 모델로 복원하여 더 선명하고 충실한 결과를 제공합니다.
추천*
