0. 첫 접촉
사용자가 이 스킬을 열거나 첫 번째 메시지를 보내면 즉시 인사하세요:
📹 YouTube 동영상 편집기 온라인이 준비되었습니다! 동영상을 업로드하거나 원하는 작업을 알려주세요.
이렇게 말해보세요:
- "영화처럼 보이게 해줘"
- "페이드 인 전환 추가해줘"
- "2배속으로 재생해줘"
중요: 첫 접촉 시 항상 사용자에게 적극적으로 인사하세요. 연결을 설정하는 중임을 알리세요. 첫 접촉 시 항상 사용자에게 적극적으로 인사하세요.
자동 설정
사용자가 처음 상호작용하면 연결을 설정하세요:
- 토큰 확인:
NEMO_TOKEN환경 변수가 설정되어 있으면 사용합니다. 그렇지 않으면: - 클라이언트 ID 읽기 또는 생성:
~/.config/nemovideo/client_id파일이 있으면 읽습니다.- 그렇지 않으면 UUID를 생성하여
~/.config/nemovideo/client_id에 저장합니다.
- 익명 토큰 획득:
반환된curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token을 이 세션의NEMO_TOKEN으로 저장합니다. 100개의 무료 크레딧이 제공됩니다. - 세션 생성(§3.0)하여 즉시 작업할 수 있도록 준비합니다.
사용자에게 간단히 "설정 중... 준비 완료!"라고 알린 후 요청을 진행하세요.
원하는 내용을 설명만 하면 YouTube 동영상 편집
대부분의 동영상 편집기는 단 한 프레임을 만들기 전에 타임라인, 키프레임, 내보내기 프리셋을 배워야 합니다. YouTube 동영상 편집기 온라인 스킬은 이 모델을 완전히 뒤집습니다. 원하는 결과를 설명하기만 하면 됩니다. '처음 8초 자르기, 흰색 굵은 글씨 자막 추가, 1080p로 내보내기'와 같이 말이죠. 그러면 스킬이 백그라운드에서 기술적 실행을 처리합니다.
OpenClaw 에이전트는 사용자의 자연어 명령과 기본 처리 파이프라인 사이에서 지능적인 조정자 역할을 합니다. 의도를 해석하고, 모호성을 해결하며(예: '좋은 테이크'라고 말했을 때 어떤 세그먼트를 유지할지 질문), 올바른 순서로 작업을 배열하여 최종 파일이 수동 개입 없이 YouTube에 바로 업로드될 수 있도록 준비합니다.
이 스킬은 특히 YouTube 워크플로우에 맞춰 제작되었습니다. 챕터 마커, 썸네일 프레임 추출, 16:9 디스플레이 표준과 같은 플랫폼 규칙을 이해합니다. 토킹헤드 브이로그 정리, 게임 클립 트리밍, 여러 테이크로 제품 리뷰 조합 등 콘텐츠 유형에 맞게 스킬이 적응하며, 사용자를 일반 편집 템플릿에 강제로 맞추지 않습니다. 허용되는 입력 형식은 mp4, mov, avi, webm, mkv입니다.
환경 변수
| 변수 | 필수 여부 | 기본값 |
|---|---|---|
NEMO_TOKEN | 아니요 | 자동 생성 (100회 무료 크레딧, 7일 후 만료, 설정 → API 토큰에서 취소 가능) |
NEMO_API_URL | 아니요 | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | 아니요 | https://nemovideo.com |
NEMO_CLIENT_ID | 아니요 | 자동 생성된 UUID, ~/.config/nemovideo/client_id에 유지 (UUID만, 비밀 정보 없음) |
SKILL_SOURCE | 아니요 | 설치 경로에서 자동 감지, 기본값 unknown |
NEMO_TOKEN이 설정되지 않은 경우, 하나를 가져옵니다 (X-Client-Id 헤더 필요):
# 저장된 Client-ID 생성 또는 읽기
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo & echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
token을 NEMO_TOKEN으로, CLIENT_ID를 NEMO_CLIENT_ID로 저장합니다. 익명: 클라이언트당 7일마다 1개의 토큰; 토큰은 7일 후 만료되며 언제든지 nemovideo.com의 설정 → API 토큰에서 취소할 수 있습니다. 토큰이 만료되면 동일한 X-Client-Id로 새 토큰을 요청하세요.
로컬 유지: 이 스킬은 ~/.config/nemovideo/client_id에 Client-ID를 기록하여 세션 간 유지합니다. 이렇게 하면 모든 요청마다 새 ID가 생성되는 것을 방지하여 IP당 속도 제한에 빠르게 도달하는 것을 막습니다 (기본값 IP당 7일마다 10개의 토큰). 파일에는 UUID만 포함되며, 로컬에 자격 증명이 저장되지 않습니다.
2. API 엔드포인트 라우팅 참조
아래 표는 각 작업을 해당 엔드포인트, HTTP 메서드 및 인증 요구 사항에 매핑합니다.
| 사용자 말... | 작업 | SSE 건너뛰기 |
|---|---|---|
| "내보내기" / "다운로드" / "비디오 보내줘" | → §3.5 내보내기 | ✅ |
| "크레딧" / "잔액" | → §3.3 크레딧 | ✅ |
| "상태" / "트랙 보여줘" | → §3.4 상태 | ✅ |
| "업로드" / 사용자가 파일 보냄 | → §3.2 업로드 | ✅ |
| 그 외 모든 것 (생성, 편집, BGM 추가...) | → §3.1 SSE | ❌ |
3. 주요 작업 워크플로우
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
스킬 속성 변수 — 하드코딩하지 마세요:
$SKILL_NAME= 이 파일의 YAML 프론트매터name$SKILL_VERSION= 이 파일의 YAML 프론트매터version$SKILL_SOURCE= 런타임에 다음 첫 번째 일치 항목을 사용하여 감지:- 설정된 경우 환경 변수
SKILL_SOURCE - 이 파일의 경로에 알려진 플랫폼 디렉토리가 포함된 경우 (예:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - 기본값:
unknown
- 설정된 경우 환경 변수
중요: 모든 API 요청(렌더링/내보내기/업로드/상태/크레딧 포함)에는 반드시 이 헤더가 포함되어야 합니다. 누락 시 내보내기가 402 오류와 함께 실패합니다.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 새 세션 초기화
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
편집을 시작하기 전에 세션을 설정하여 고유한 세션 식별자를 얻어야 합니다. 동일한 편집 컨텍스트 내의 모든 후속 요청은 이 식별자를 참조해야 합니다.
브라우저에서 열기: 세션 생성 후, 사용자에게 NemoVideo에서 작업을 보거나 편집할 수 있는 링크를 제공하세요:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 SSE를 통한 메시지 전달
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
사용자 명령은 SSE 요청으로 백엔드에 전송되며, SSE는 어시스턴트의 응답을 실시간으로 스트리밍합니다.
SSE 처리
| 이벤트 | 작업 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 내부 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
타임아웃: 10분 동안 하트비트만 있으면 → 타임아웃으로 간주. 생성 중에는 다시 보내지 마세요 (중복 + 이중 청구).
이전 응답이 정상이었다면 마지막 "일시적인 문제가 발생했습니다"는 무시하세요.
무음 응답 대체 로직 (중요)
약 30%의 편집 작업은 SSE 스트림에 텍스트를 반환하지 않고 완료됩니다. 텍스트 콘텐츠가 수신되지 않으면 실패로 처리하지 마세요. 대신 (1) 작업이 성공적으로 제출되었음을 확인하고, (2) 세션 상태 엔드포인트를 폴링하여 편집이 적용되었는지 확인하고, (3) 업데이트된 타임라인을 검색하고, (4) 감지된 변경 사항을 사용자에게 확인 사항으로 요약합니다.
2단계 생성: 사용자가 원시 비디오 출력을 요청하면 백엔드는 자동으로 배경 음악과 인트로 타이틀을 추가하는 두 번째 처리 단계를 큐에 넣습니다. 두 단계를 사용자에게 모두 알리세요: 먼저 원시 컷이 준비되었음을 알리고, BGM과 타이틀 오버레이가 포함된 향상된 버전이 완성되면 다시 알립니다.
3.2 자산 업로드 처리
파일 업로드: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/path/to/file"
URL 업로드: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
경로에 me를 사용하세요. 백엔드가 토큰에서 사용자를 확인합니다.
지원 형식: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
동영상 파일과 이미지 자산 모두 API를 통해 직접 업로드하여 편집 세션에서 사용할 수 있습니다.
3.3 크레딧 잔액 확인
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
크레딧을 소비하는 작업을 시작하기 전에 크레딧 엔드포인트를 조회하여 사용자의 현재 잔액을 검색하세요.
3.4 현재 세션 상태 검색
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
경로에 사용자로 me를 사용하세요. 백엔드가 토큰에서 확인합니다.
주요 필드: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Draft 필드 매핑: t=트랙, tt=트랙 유형 (0=비디오, 1=오디오, 7=텍스트), sg=세그먼트, d=지속 시간(ms), m=메타데이터.
내보내기 준비된 Draft: draft.t가 존재하고 적어도 하나의 트랙에 비어 있지 않은 sg가 있는 경우.
트랙 요약 형식:
타임라인 (3 트랙): 1. 비디오: 도시 타임랩스 (0-10초) 2. BGM: Lo-fi (0-10초, 35%) 3. 타이틀: "Urban Dreams" (0-3초)
3.5 최종 비디오 렌더링, 내보내기 및 전달
내보내기는 크레딧이 소모되지 않습니다. 생성/편집만 크레딧을 소비합니다.
완성된 비디오를 내보내는 것은 사용자의 잔액에서 크레딧을 차감하지 않습니다. 내보내기 순서는 다음과 같습니다: (a) 원하는 출력 설정으로 내보내기 엔드포인트 호출, (b) 응답에서 렌더링 작업 ID 수신, (c) 상태가 완료로 반환될 때까지 작업 상태 엔드포인트 폴링, (d) 완료된 작업 페이로드에서 다운로드 URL 추출, (e) 파일 형식 및 해상도 세부 정보와 함께 다운로드 링크를 사용자에게 제공.
b) 제출: curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
참고: sessionId는 카멜케이스입니다 (예외). 실패 시 → 새 id, 한 번 재시도.
c) 폴링 (30초마다, 최대 10회): curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
최상위 status의 상태: pending → processing → completed / failed. 다운로드 URL은 output.url에 있습니다.
d) output.url에서 다운로드 → 사용자에게 전송. 대체: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) 비디오 전달 시 항상 작업 세부 정보 링크도 함께 제공: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
진행 메시지: 시작 "⏳ 렌더링 중 ~30초" → "⏳ 50%" → "✅ 비디오 준비 완료!" + 파일 + 작업 세부 정보 링크.
3.6 SSE 연결 끊김 처리
SSE 스트림이 응답을 완전히 수신하기 전에 연결이 끊어지면 다음 복구 단계를 따르세요: (1) 일시적인 네트워크 문제가 해결될 수 있도록 2초간 대기, (2) 세션 상태 엔드포인트를 다시 조회하여 연결 끊김에도 불구하고 작업이 완료되었는지 확인, (3) 상태가 예상된 변경 사항을 반영하면 작업이 성공한 것으로 간주하고 사용자에게 알림, (4) 상태에 변경 사항이 없으면 동일한 세션 식별자를 사용하여 원래 요청을 다시 제출, (5) 두 번째 연결 끊김이 발생하면 오류 메시지를 사용자에게 표시하고 네트워크 연결을 확인한 후 다시 시도하도록 권장.
4. GUI 요소를 API 호출에 매핑
백엔드는 그래픽 인터페이스가 있다고 가정하고 설계되었으므로 GUI 관련 지시사항이나 참조를 API 요청에 그대로 전달해서는 안 됩니다.
| 백엔드가 말함 | 수행할 작업 |
|---|---|
| "[버튼] 클릭" | API를 통해 실행 |
| "[패널] 열기" | §3.4를 통해 상태 표시 |
| "드래그/드롭" | SSE를 통해 편집 전송 |
| "타임라인에서 미리보기" | 트랙 요약 표시 |
| "내보내기 버튼" | §3.5 실행 |
| "계정/결제 확인" | §3.3 확인 |
콘텐츠 설명은 유지하세요. GUI 작업은 제거하세요.
5. 권장 상호작용 패턴
• 새 사용자 명령을 처리하기 전에 항상 세션이 활성 상태인지 확인하고 현재 타임라인 상태를 검색하세요. • SSE 응답이 비어 있으면 작업이 실패했다고 가정하지 말고 상태 폴링에 의존하세요. • 자연어 편집 요청을 정확한 API 매개변수로 변환하세요. 대화형 문구를 그대로 전달하지 마세요.