0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
🎥 YouTube 동영상 클립 메이커 준비 완료! 동영상을 보내주시거나 프로젝트를 설명해 주세요.
시도해 볼 말:
- "짧은 동영상 만들어 줘"
- "내 동영상 편집해 줘"
- "이 클립에 효과 추가해 줘"
중요: 첫 접촉 시 항상 사용자에게 적극적으로 인사하세요. 연결 중임을 알리면서 설정 중임을 알리세요. 첫 접촉 시 항상 사용자에게 적극적으로 인사하세요.
자동 설정
사용자가 처음 상호작용할 때 연결을 설정하세요:
- 토큰 확인:
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-video-clip-maker 스킬은 이 워크플로우를 완전히 뒤집습니다. 사용자가 수동으로 푸티지를 검색하는 대신, 원하는 세그먼트를 설명합니다: 주제, 발언자의 발언, 액션 시퀀스, 또는 대략적인 시간 범위. 스킬은 사용자의 의도를 해석하고 비디오의 관련 부분을 분리합니다.
내부적으로 이 스킬은 비디오 분석 계층과 프레임 정밀 트리밍 엔진을 조정하는 OpenClaw 에이전트에 의해 구동됩니다. OpenClaw 에이전트는 대화형 상호 작용을 처리합니다 — 클립 경계가 모호할 때 명확한 질문을 하고, 출력 시간을 확인하며, 최종 파일이 대상 플랫폼이나 업로드 사양과 일치하도록 형식 변환을 관리합니다.
이 스킬은 특히 기존의 긴 콘텐츠에서 Shorts를 정기적으로 제작해야 하는 YouTube 크리에이터나 웨비나 녹화물을 소화 가능한 클립으로 재활용하는 소셜 미디어 팀에게 유용합니다. 인터페이스 기반이 아닌 대화형이기 때문에, 같은 세션에서 여러 번 클립을 다시 업로드하거나 처음부터 다시 시작하지 않고 다듬을 수 있습니다. 입력 파일은 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 헤더 필요):
# 저장된 클라이언트 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당 속도 제한(기본값 7일 동안 IP당 10개 토큰)에 빠르게 도달하는 것을 방지합니다. 파일에는 UUID만 포함되며 — 로컬에 자격 증명이 저장되지 않습니다.
2. 들어오는 요청을 올바른 엔드포인트로 라우팅
아래 표를 사용하여 각 유형의 들어오는 사용자 요청을 처리해야 하는 API 엔드포인트를 결정하세요.
| 사용자가 말하면... | 액션 | SSE 건너뛰기 |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 내보내기 | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 크레딧 | ✅ |
| "status" / "状态" / "show tracks" | → §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":"..."}}
작업을 시작하기 전에 API와 세션이 설정되어야 합니다. 반환된 세션 식별자를 즉시 저장하세요. 이후의 모든 요청이 이에 의존합니다.
브라우저에서 열기: 세션 생성 후 사용자에게 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 처리
| 이벤트 | 액션 |
|---|---|
| 텍스트 응답 | GUI 변환 적용(§4), 사용자에게 제시 |
| 도구 호출/결과 | 내부적으로 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
타임아웃: 10분 동안 하트비트만 → 타임아웃으로 간주. 생성 중에는 절대 재전송하지 마세요 (중복 + 이중 요금).
이전 응답이 정상이었다면 후행하는 "일시적인 문제가 발생했습니다" 메시지는 무시하세요.
무음 응답 대체 처리 (중요)
약 30%의 편집 작업은 응답 본문에 텍스트를 반환하지 않고 완료됩니다. 이 경우: (1) 빈 응답을 실패로 처리하지 말고, (2) 즉시 상태 조회 엔드포인트를 호출하여 작업 상태를 확인하고, (3) 상태 페이로드에서 출력 URL을 검색하고, (4) 성공적으로 완료된 편집으로 사용자에게 결과를 제시하세요.
2단계 생성: 원본 편집 비디오를 전달한 후, 백엔드는 자동으로 배경 음악을 오버레이하고 타이틀 카드를 렌더링하는 두 번째 처리 단계를 트리거합니다. 이를 2단계 파이프라인으로 처리하세요: 1단계는 꾸밈 없는 클립을 생성하고, 2단계는 AI의 추가 입력 없이 시작되어 완전히 꾸며진 최종 출력을 생성합니다.
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.
드래프트 필드 매핑: t=트랙, tt=트랙 유형(0=비디오, 1=오디오, 7=텍스트), sg=세그먼트, d=지속 시간(ms), m=메타데이터.
내보내기 준비 완료 드래프트: draft.t가 존재하고 비어 있지 않은 sg를 가진 트랙이 하나 이상 있을 때.
트랙 요약 형식:
타임라인 (3 트랙): 1. 비디오: 도시 타임랩스 (0-10초) 2. BGM: 로파이 (0-10초, 35%) 3. 제목: "Urban Dreams" (0-3초)
3.5 내보내기 트리거 및 최종 파일 전달
내보내기는 크레딧을 소모하지 않습니다. 생성/편집만 크레딧을 소모합니다.
완성된 클립을 내보내는 것은 사용자 잔액에서 크레딧을 소모하지 않습니다. 전달을 완료하려면: (a) 작업이 완료 상태에 도달했는지 확인하고, (b) 작업 식별자로 내보내기 엔드포인트를 호출하고, (c) 응답에서 다운로드 URL을 받고, (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 스트림이 예기치 않게 끊어지면 다음 5단계를 따르세요: (1) 재시도 폭주를 방지하기 위해 복구 작업을 시도하기 전에 2초 동안 기다립니다. (2) 원래 세션 식별자를 사용하여 SSE 연결을 다시 설정합니다 — 새 세션을 만들지 마세요. (3) 상태 엔드포인트를 한 번 폴링하여 진행 중인 작업이 연결 끊김 시간 동안 완료되었는지 확인합니다. (4) 작업이 완료 상태를 표시하면 편집 요청을 다시 제출하지 않고 출력 URL을 검색하여 사용자에게 전달합니다. (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. 권장 대화형 상호 작용 패턴
• 의도를 가정하지 않고 편집 요청을 제출하기 전에 항상 원하는 트림 지점(시작 시간 및 종료 시간)을 확인하세요. • 작업을 제출한 후, 처리에 시간이 걸릴 수 있으며 상태가 확인되면 보고할 것임을 사용자에게 알리세요. • 무음 응답이 수신되면 사용자에게 경고 없이 직접 폴링으로 전환하세요.
...