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-video-editor-download 스킬은 이 모델을 뒤집습니다. 사용자가 평범한 언어로 원하는 것을 설명하면, 기본 OpenClaw 에이전트가 사용자의 지침을 YouTube에서 직접 가져온 원본 푸티지에 대한 정확한 편집 작업으로 변환합니다.
OpenClaw 에이전트는 자연어 요청과 처리 파이프라인 사이의 지속적인 조정자 역할을 합니다. 사용자가 '처음 45초를 제거하고 8분 이후는 모두 자르기'라고 말하면 에이전트는 의도를 분석하고, 올바른 순서로 작업을 대기열에 넣고, 여러 단계의 대화에 걸쳐 상태를 추적합니다. 따라서 처음부터 다시 시작하지 않고도 추가 편집을 다듬거나, 취소하거나, 연결할 수 있습니다.
이 스킬은 콘텐츠 재목적화 작업자, 강의 녹화 클립을 만드는 교육자, 하이라이트 릴을 제작하는 팟캐스트 프로듀서, 긴 형식의 동영상을 플랫폼에 맞는 짧은 클립으로 자르는 소셜 미디어 관리자를 위해 설계되었습니다. 편집 세션이 대화형이므로 비기술적 사용자도 숙련된 편집자와 동일한 정밀도를 얻을 수 있습니다. 최종 내보내기는 게시 대상에 맞게 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. 수신 요청 라우팅
아래 표를 사용하여 각 유형의 사용자 요청을 처리할 엔드포인트를 결정하세요.
| 사용자 요청 | 액션 | 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":"..."}}
편집 작업을 수행하기 전에 백엔드와 세션이 설정되어 있어야 합니다. 반환된 세션 식별자를 저장하세요. 이후 모든 요청이 이에 의존합니다.
브라우저에서 열기: 세션 생성 후, 사용자에게 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(Server-Sent Events) 연결을 통해 백엔드로 전송됩니다.
SSE 처리
| 이벤트 | 액션 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 제시 |
| 도구 호출/결과 | 조용히 대기, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 동영상 생성 100-300초, 편집 10-30초.
시간 초과: 10분 동안 하트비트만 있을 경우 → 시간 초과로 간주. 생성 중에는 절대 재전송하지 않음 (중복 + 이중 청구).
이전 응답이 정상이었으면 후속 "일시적인 문제가 발생했습니다" 메시지는 무시하세요.
무음 응답 대체 처리 (중요)
약 30%의 편집 작업은 SSE 스트림에서 텍스트를 반환하지 않고 완료됩니다. 예상 시간 내에 텍스트 콘텐츠를 받지 못한 경우: (1) 세션 상태 엔드포인트를 폴링하여 작업 완료를 확인하고, (2) 상태 페이로드에서 출력 자산 URL을 직접 검색하고, (3) 정상 응답이 도착한 것처럼 결과를 사용자에게 제시하고, (4) 메시지가 반환되지 않았다는 사실을 사용자에게 절대 알리지 마세요.
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.
로컬 동영상 파일과 원격 URL 모두 편집 작업의 소스 자료로 허용됩니다.
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) 세션 ID로 내보내기 엔드포인트 호출, (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는 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에서 다운로드 → 사용자에게 전송. 대체값: 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) 연결 끊김 이벤트를 감지하고 UI 진행 표시기를 일시 중지, (2) 서버에 과부하를 주지 않도록 재연결 시도 전 최소 3초 대기, (3) 원래 세션 ID를 사용하여 SSE 연결 재설정, (4) 중단 중에 대기열에 있던 확인되지 않은 메시지를 재전송, (5) 스트림이 활성 상태이고 세션 상태가 일관됨을 확인하면 정상 작동 재개.
4. GUI 동작 번역
백엔드는 그래픽 인터페이스가 있다고 가정하고 작동하므로 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 응답 필드를 그대로 전달하는 대신 변경된 내용을 요약하세요. • 장기 실행 작업의 경우 사용자를 침묵 상태로 두지 말고 SSE 이벤트에서 가져온 정기적인 진행 업데이트를 제공하세요. • 사용자가 지원되지 않는 기능을 요청하면 명확하게 제한 사항을 설명하고 가장 가까운 대체 가능한 옵션을 제안하세요. • 다운로드 링크를 제공할 때는 가능한 경우 출력 형식과 예상 파일 크기에 대한 간략한 설명을 항상 포함하세요.
6. 알려진 제약 사항 및 한계
• 단일 사용자 계정에 대한 동시 편집 세션은 지원되지 않습니다. 새 세션은 이전 세션이 완전히 종료된 후에만 생성할 수 있습니다.
• SSE 응답은 최대 10분으로 제한됩니다. 이 시간이 지나면 연결이 종료됩니다.
• 크레딧은 100개로 제한되어 있습니다. 추가 크레딧이 필요한 경우 nemovideo.com에서 구매해야 합니다.
• 스킬은 현재 YouTube 동영상만 지원합니다. 다른 소스의 동영상은 직접 업로드해야 합니다.
• 생성된 동영상의 최대 길이는 10분입니다.
• 편집 작업은 기본적으로 영어를 지원합니다. 다른 언어의 경우 정확도가 떨어질 수 있습니다.
7. 보안 및 개인 정보 보호
• NEMO_TOKEN은 세션 전용입니다. 로컬에 저장하지 마세요.
• client_id 파일에는 UUID만 포함되며 자격 증명은 포함되지 않습니다.
• 모든 API 통신은 HTTPS를 통해 암호화됩니다.
• 사용자 데이터는 처리 목적으로만 사용되며 제3자와 공유되지 않습니다.
• 토큰은 언제든지 nemovideo.com의 설정에서 취소할 수 있습니다.