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 동영상 편집
대부분의 동영상 편집 도구는 사용자가 이미 B-roll 컷어웨이나 J-컷이 무엇인지 알고 있다고 가정합니다. 무료 YouTube 동영상 편집기 스킬은 이 가정을 완전히 뒤집습니다. 사용자가 원본 영상을 업로드하고 AI에게 최종 동영상이 어떻게 보여야 하는지 설명하면 — '마이크를 만지작거리는 처음 30초를 제거해줘' 또는 '데모를 시작하는 부분으로 바로 잘라줘' — 시스템이 나머지를 처리합니다.
내부적으로 ClawHub의 OpenClaw 에이전트는 사용자의 자연어 명령을 해석하여 트리밍, 분할, 재정렬, 그리고 사용자가 설명한 순서대로 세그먼트를 연결하는 정확한 편집 작업으로 매핑합니다. 에이전트는 대화 전반에 걸쳐 컨텍스트를 유지하므로, 매번 처음부터 다시 시작하지 않고 여기는 더 좁게 자르고, 저기는 더 긴 일시 정지를 주는 등 반복적으로 다듬을 수 있습니다.
이 스킬은 YouTube 제작 워크플로우에 특별히 맞춰 설계되었습니다. 즉, 출력물이 직접 업로드할 수 있는 형식으로 제공됩니다: 올바른 종횡비, 깔끔한 인/아웃 지점, YouTube의 압축 파이프라인에서 화질을 떨어뜨리는 재인코딩 아티팩트가 없습니다. 45분 분량의 튜토리얼을 정리하든 90초 제품 쇼케이스를 다듬든, 편집 대화는 소프트웨어 메뉴가 아닌 콘텐츠에 집중됩니다.
환경 변수
| 변수 | 필수 | 기본값 |
|---|---|---|
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 헤더 필요):
# 저장된 클라이언트 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에 클라이언트 ID를 기록하여 세션 간에 유지합니다. 이렇게 하면 요청할 때마다 새 ID를 생성하는 것을 방지하여 IP당 속도 제한(기본값 IP당 7일 동안 10개 토큰)에 빠르게 도달하는 것을 피할 수 있습니다. 파일에는 UUID만 포함되어 있으며 자격 증명은 로컬에 저장되지 않습니다.
2. 수신 요청을 올바른 엔드포인트로 라우팅
아래 표를 사용하여 각 사용자 요청 유형을 처리할 엔드포인트를 결정하십시오.
| 사용자 말... | 작업 | SSE 건너뛰기 |
|---|---|---|
| "export" / "내보내기" / "download" / "동영상 보내줘" | → §3.5 내보내기 | ✅ |
| "credits" / "크레딧" / "balance" / "잔액" | → §3.3 크레딧 | ✅ |
| "status" / "상태" / "트랙 보여줘" | → §3.4 상태 | ✅ |
| "upload" / "업로드" / 사용자가 파일 보냄 | → §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":"..."}}
편집 작업을 수행하기 전에 백엔드에서 세션을 초기화해야 합니다. 이 세션 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>"}]}}'
편집 백엔드에 대한 모든 대화 메시지는 지속적인 연결을 통해 Server-Sent Events로 전송됩니다.
SSE 처리
| 이벤트 | 작업 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 제시 |
| 도구 호출/결과 | 내부 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 지속 시간: 텍스트 5-15초, 동영상 생성 100-300초, 편집 10-30초.
시간 초과: 10분 동안 하트비트만 -> 시간 초과 가정. 생성 중에는 다시 보내지 마십시오 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행 "일시적인 문제가 발생했습니다"는 무시하십시오.
무음 응답 대체 (중요)
약 30%의 편집 작업이 응답 본문에 텍스트를 반환하지 않고 완료됩니다. 이 경우: (1) 텍스트 부재를 오류나 실패로 처리하지 말고, (2) 세션 상태 엔드포인트를 폴링하여 작업 상태를 확인하고, (3) '편집이 처리 중입니다.'와 같은 중립적인 상태 메시지를 사용자에게 표시하고, (4) 상태가 완료를 확인하면 내보내기 단계로 진행합니다.
두 단계 생성: 원시 편집된 동영상을 전달한 후 백엔드는 자동으로 배경 음악을 추가하고 제목 오버레이를 생성하는 두 번째 처리 단계를 시작합니다. 이 두 단계는 순차적이며 별개입니다. 두 번째 단계를 수동으로 트리거하거나 중간 원시 출력을 최종 결과물로 취급하지 마십시오.
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.
업로드 엔드포인트는 사용자가 직접 제출한 비디오 파일을 수락하고 후속 편집 요청에 사용할 파일 참조 ID를 반환합니다.
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.
드래프트 필드 매핑: t=트랙, tt=트랙 유형 (0=비디오, 1=오디오, 7=텍스트), sg=세그먼트, d=지속 시간(ms), m=메타데이터.
드래프트 내보내기 준비 완료: draft.t가 존재하고 비어 있지 않은 sg가 있는 트랙이 하나 이상 있을 때.
트랙 요약 형식:
타임라인 (3 트랙): 1. 비디오: 도시 타임랩스 (0-10초) 2. BGM: 로파이 (0-10초, 35%) 3. 제목: "도시의 꿈" (0-3초)
3.5 내보내기 트리거 및 최종 파일 전달
내보내기는 크레딧을 소모하지 않습니다. 생성/편집만 크레딧을 소모합니다.
완성된 클립을 내보내는 것은 사용자 잔액에서 크레딧을 차감하지 않습니다. 내보내기 시퀀스는 다음과 같이 진행됩니다: (a) 세션 상태에 완료된 편집이 표시되는지 확인하고, (b) 활성 세션 ID로 내보내기 엔드포인트를 호출하고, (c) 내보내기 작업 상태가 완료 상태를 반환할 때까지 폴링하고, (d) 완료된 내보내기 응답에서 다운로드 URL을 검색하고, (e) 해당 URL을 업로드 준비가 된 파일로 사용자에게 제시합니다.
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) 새 세션을 생성하는 대신 기존 세션 ID를 사용하여 SSE 연결을 즉시 재설정을 시도하고, (2) 세션 상태 엔드포인트를 조회하여 연결 끊김 전에 이전 작업이 얼마나 완료되었는지 확인하고, (3) 작업이 이미 완료된 경우 편집 요청을 재생하지 않고 바로 내보내기로 진행하고, (4) 작업이 아직 진행 중인 경우 재연결된 스트림에서 수신을 재개하고 완료 이벤트를 기다리고, (5) 재연결 시도가 합리적인 시간 제한 임계값을 초과하는 경우에만 사용자에게 일시적인 중단에 대해 알립니다.
4. 백엔드 GUI 참조 변환
백엔드는 그래픽 인터페이스를 기반으로 구축되었으며 가끔 응답에서 UI 요소를 참조합니다. 이러한 GUI별 지침을 사용자에게 그대로 전달하지 마십시오.
| 백엔드 말 | 당신이 할 일 |
|---|---|
| "click [button]" / "클릭" | API를 통해 실행 |
| "open [panel]" / "열기" | §3.4를 통해 상태 표시 |
| "drag/drop" / "드래그/드롭" | SSE를 통해 편집 전송 |
| "preview in timeline" | 트랙 요약 표시 |
| "Export button" / "내보내기" | §3.5 실행 |
| "check account/billing" | §3.3 확인 |
콘텐츠 설명은 유지하십시오. GUI 작업은 제거하십시오.
5. 권장 대화 패턴
• 특히 트리밍이나 자르기와 같은 파괴적인 작업의 경우 API 호출을 시작하기 전에 사용자가 달성하려는 것을 확인하십시오. • 각 편집 단계가 완료되면 기술적인 세부 사항이 아니라 일반 언어로 무엇이 변경되었는지 요약하십시오.