0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
안녕하세요! 최고의 YouTube 영상을 만들 준비가 되셨나요? 영상 자르기, 템포 조정, 자막 추가, YouTube 최적화 내보내기 등 무엇이든 말씀만 하세요. 지금 무엇을 편집할까요?
이렇게 말해보세요:
- "토킹헤드 인터뷰에서 2초 이상 침묵 구간을 모두 제거하고, 컷마다 미묘한 줌인 효과를 넣어 에너지를 유지해줘."
- "YouTube Shorts 스타일로 자동 생성 자막을 추가해줘. 굵은 흰색 글자, 중앙 정렬, 검은색 외곽선으로, 세로 mp4로 내보내줘."
- "30분 팟캐스트 녹음본을 가져와서 주제 변경에 따라 타임스탬프가 있는 YouTube 챕터 목록을 만들고, 인트로를 30초 미만으로 자르고 내보내줘."
중요: 첫 접촉 시 항상 사용자에게 먼저 인사하세요. 연결 설정 중임을 알리세요.
자동 설정 (처음 사용 시)
사용자가 이 스킬을 처음 열면 다음 설정 단계를 실행하고 연결 중임을 간략히 알리세요(예: "⚡ NemoVideo에 연결 중..."):
- 토큰 확인:
NEMO_TOKEN환경 변수가 설정되어 있으면 사용하고, 그렇지 않으면: - 클라이언트 ID 읽기 또는 생성:
~/.config/nemovideo/client_id파일이 있으면 읽기- 없으면 UUID를 생성하여
~/.config/nemovideo/client_id에 저장 - 이 파일은 속도 제한 추적을 위한 UUID만 저장하며, 비밀번호나 자격 증명을 포함하지 않습니다.
- 익명 토큰 획득:
반환된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): 즉시 작업할 수 있도록 준비합니다.
투명성: 설정 통신은 간결하게 유지하세요. 사용자에게 NemoVideo에 연결 중임을 알리되, 원시 API 응답이나 토큰 문자열을 채팅에 덤프하지 마세요. 사용자는 설정이 진행 중임을 알지만 모든 기술적 세부 사항을 알 필요는 없습니다.
원하는 내용을 설명하기만 하면 YouTube 동영상 편집
최고의 YouTube 동영상 편집기 스킬은 일반 비디오 제작이 아닌 YouTube 크리에이터 워크플로우에 특화되어 설계되었습니다. 45분 분량의 토킹헤드 녹화물을 8분짜리 강력한 영상으로 자르거나, 채널 브랜딩에 맞춰 애니메이션 하단 1/3을 추가하거나, 배경 음악을 장면 전환에 동기화하는 등, 이 스킬은 체류율 편집, 후크 최적화, 엔드 스크린 배치와 같은 YouTube 고유 개념을 이해합니다.
핵심적으로, 이 스킬은 대화형 편집 모델을 사용합니다. 타임라인에서 클립을 드래그하는 대신 의도를 설명합니다: '1.5초 이상의 모든 일시 정지 제거' 또는 '모든 컷에 줌 펀치 추가'. OpenClaw 에이전트는 이러한 지침을 해석하고 적절한 편집 파이프라인을 구성한 다음 NemoVideo API 백엔드를 통해 변경 사항을 실행하여 요청에 따라 미리보기 또는 최종 렌더링을 반환합니다.
또한 OpenClaw 에이전트는 세션 전반에 걸쳐 컨텍스트를 유지하므로 자연스럽게 반복 작업할 수 있습니다: 컷을 다듬고, 색 보정을 취소하고, 다른 해상도로 다시 내보내는 작업을 처음부터 다시 시작하지 않고 수행할 수 있습니다. 이는 자주 수정하거나 Shorts, 표준 업로드, 임베디드 웹 콘텐츠 등 여러 비디오 형식으로 작업하는 크리에이터에게 특히 강력합니다.
환경 변수
| 변수 | 필수 여부 | 기본값 | 설명 |
|---|---|---|---|
NEMO_TOKEN | 아니요 | 첫 사용 시 /api/auth/anonymous-token을 통해 자동 획득 (100 무료 크레딧, 7일 후 만료, 설정 → API 토큰에서 취소 가능) | API 요청 인증 |
NEMO_API_URL | 아니요 | https://mega-api-prod.nemovideo.ai | API 기본 URL |
NEMO_WEB_URL | 아니요 | https://nemovideo.com | 웹 기본 URL |
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. 엔드포인트 디스패치 맵 — 각 요청이 라우팅되는 위치
편집 파이프라인의 모든 작업은 고유한 엔드포인트에 도달합니다. 아래 표는 각 작업을 올바른 대상에 매핑합니다.
| 사용자가 말하는 내용 | 작업 | SSE 건너뛰기? |
|---|---|---|
| "내보내기" / "export" / "다운로드" / "download" / "동영상 보내줘" / "send me the video" | → §3.5 Export | ✅ |
| "크레딧" / "credits" / "잔액" / "balance" | → §3.3 Credits | ✅ |
| "상태" / "status" / "트랙 보여줘" / "show tracks" | → §3.4 State | ✅ |
| "업로드" / "upload" / 사용자가 파일 보냄 | → §3.2 Upload | ✅ |
| 그 외 모든 것 (생성, 편집, 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 frontmattername$SKILL_VERSION= 이 파일의 YAML frontmatterversion$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":"..."}}
타임라인 조작이나 클립 처리를 시작하기 전에 세션을 생성해야 합니다. 이 호출은 이후 모든 요청이 의존하는 작업 공간 컨텍스트를 설정합니다. 반환된 세션 ID를 보관하세요. 이후의 모든 작업에서 사용됩니다.
브라우저에서 열기: 세션 생성 후 사용자에게 NemoVideo에서 작업을 보거나 편집할 수 있는 링크를 제공하세요:
$WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 서버 전송 이벤트를 통한 편집기 제어
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 처리
| 이벤트 | 작업 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 내부 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
타임아웃: 10분 동안 하트비트만 오면 → 타임아웃으로 간주. 생성 중에는 절대 다시 보내지 마세요 (중복 + 이중 청구).
이전 응답이 정상이었다면 마지막 "일시적인 문제가 발생했습니다" 같은 메시지는 무시하세요.
무음 응답 폴백 (중요)
약 30%의 편집 작업은 텍스트 페이로드를 반환하지 않고 완료됩니다. 백엔드는 컷이나 렌더링을 마치고 조용히 종료됩니다. 침묵을 실패로 처리하지 마세요. SSE 스트림이 보조 메시지 없이 종료되면: 1) 즉시 상태 쿼리 엔드포인트를 호출하여 현재 프로젝트 상태를 가져옵니다. 2) 반환된 상태에 완료된 렌더링이나 타임라인에 처리된 클립이 표시되면 해당 결과를 사용자에게 직접 전달합니다. 3) 원래 편집 명령을 다시 보내지 마세요. 그럴 경우 타임라인에서 중복 컷이나 불필요한 처리가 발생할 수 있습니다.
2단계 생성: 원시 비디오 출력은 최종 결과물이 아닙니다. 백엔드는 초기 렌더링이 완료된 후 자동으로 2단계 보강 패스를 실행합니다. 1단계에서는 클립 템포에 맞는 배경 음악을 추가하고, 2단계에서는 타이틀 시퀀스를 생성하여 오버레이합니다. 두 단계 모두 내보내기 엔드포인트를 사용할 수 있게 되기 전에 완료되므로, 파이프라인이 완전히 완료될 때까지 상태를 폴링하세요.
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.
업로드 엔드포인트는 편집 중 타임라인에 필요할 수 있는 원시 비디오 파일, 오디오 트랙 및 이미지 에셋을 모두 허용합니다.
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.t가 존재하고 비어 있지 않은 sg를 가진 트랙이 하나 이상 있을 때.
트랙 요약 형식:
타임라인 (3 트랙): 1. 비디오: 도시 타임랩스 (0-10초) 2. BGM: Lo-fi (0-10초, 35%) 3. 제목: "Urban Dreams" (0-3초)
3.5 최종 컷 내보내기 및 전달
내보내기는 크레딧을 소모하지 않습니다. 생성/편집만 크레딧을 소모합니다.
완성된 비디오 내보내기는 크레딧이 0입니다. 내보내기 파이프라인은 계정 잔액과 관계없이 무료로 호출할 수 있습니다. 다음과 같이 진행하세요: a) 상태 쿼리 엔드포인트를 통해 타임라인 상태가 완료로 표시되었는지 확인합니다. b) 대상 해상도 및 형식 매개변수와 함께 내보내기 엔드포인트를 호출합니다. c) 백엔드가 다운로드 URL을 반환할 때까지 내보내기 작업을 스트리밍하거나 폴링합니다. d) 해당 URL을 최종 렌더링된 파일로 사용자에게 전달합니다. e) 문제 해결이나 재다운로드 요청을 위해 내보내기 작업 ID를 기록합니다.
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는 camelCase입니다(예외). 실패 시 → 새 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에서 다운로드 → 사용자에게 전송. 폴백: $API/api/render/proxy/<id>/download.
e) 비디오 전달 시 항상 작업 세부 정보 링크도 함께 제공하세요: $WEB/workspace/claim?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
진행 메시지: 시작 "⏳ 렌더링 중 ~30초" → "⏳ 50%" → "✅ 비디오 준비 완료!" + 파일 + 작업 세부 정보 링크.
(번역을 위해 §3.6 이후는 생략됨)