0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
🎙️ 안녕하세요! 비디오 편집 AI가 준비되었습니다. 비디오 파일을 보내거나 원하는 작업을 말씀해 주세요!
다음과 같이 말해 보세요:
- "페이드 인 전환 추가해 줘"
- "영화처럼 보이게 해 줘"
- "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)하여 즉시 작업할 준비를 합니다.
사용자에게 간략히 알립니다: "설정 중입니다… 준비 완료!" 그런 다음 요청을 진행합니다.
클릭 없이 말로 비디오 편집하기
대부분의 비디오 편집 도구는 실행의 부담을 사용자에게 둡니다. 이 클립을 드래그하고, 타임스탬프를 찾고, 효과를 적용하는 식입니다. video-editor-ai는 이 모델을 완전히 뒤집습니다. 원하는 결과를 설명하면 스킬이 이를 생성하는 방법을 스스로 파악합니다. 처음 30초를 트리밍하든, 두 클립을 크로스페이드로 연결하든, 긴 녹화물에서 특정 장면을 추출하든, 의도를 표현하면 시스템이 작업을 처리합니다.
내부적으로 OpenClaw 에이전트는 사용자의 편집 지침을 해석하여 비디오 파일에 직접 적용되는 정확하고 순서화된 작업으로 변환합니다. 에이전트는 대화 전반에 걸쳐 컨텍스트를 유지하므로, 단일 세션에서 여러 편집을 구체화, 실행 취소 또는 연결할 수 있으며 처음부터 다시 시작할 필요가 없습니다. '중간쯤 느린 부분을 잘라 줘' 또는 '발표자가 말하는 부분만 남겨 줘'와 같은 상대적인 언어를 이해하고 실제 파일 구조에 따라 지침을 처리합니다.
이 스킬은 비디오를 자주 작업하지만 일상적인 작업에 기존 편집 소프트웨어에 시간을 투자하고 싶지 않은 사람들을 위해 특별히 제작되었습니다. 일괄 처리, 스크립트 기반 워크플로우 및 반복 가능한 편집 패턴을 모두 쉽게 사용할 수 있습니다. 입력 파일은 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 | 아니요 | 설치 경로에서 자동 감지, fallback 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일 후 만료되며 설정 → API 토큰(nemovideo.com)에서 언제든지 취소할 수 있습니다. 토큰이 만료되면 동일한 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 frontmattername$SKILL_VERSION= 이 파일의 YAML frontmatterversion$SKILL_SOURCE= 런타임에 다음 첫 번째 일치 항목을 사용하여 감지:- 설정된 경우 env
SKILL_SOURCE - 이 파일의 경로에 알려진 플랫폼 디렉토리가 포함된 경우 (예:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- 설정된 경우 env
중요: 모든 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분 동안 하트비트만 있음 → 시간 초과로 간주. 생성 중에는 절대 재전송하지 마세요 (중복 및 이중 청구).
이전 응답이 정상이었다면 후행 "I encountered a temporary issue"는 무시합니다.
무음 응답 대체 (중요)
약 30%의 편집 작업이 SSE 스트림에서 텍스트 응답 없이 완료됩니다. 텍스트 응답이 감지되지 않으면 실패로 처리하지 마세요. 대신: (1) 스트림이 깨끗하게 닫힐 때까지 기다리고, (2) 즉시 상태 쿼리 엔드포인트를 호출하여 현재 프로젝트 상태를 검색하고, (3) 업데이트된 상태를 사용자에게 작업 성공 확인으로 표시하고, (4) 대화를 정상적으로 계속하세요.
2단계 생성: 백엔드가 원시 비디오 결과를 전달하면 자동으로 배경 음악을 추가하고 제목 오버레이를 생성하는 두 번째 처리 단계가 트리거됩니다 — AI의 추가 지침이 필요하지 않습니다. 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 최종 출력 내보내기 및 전달
내보내기는 크레딧을 소모하지 않습니다. 생성/편집만 크레딧을 소비합니다.
완료된 프로젝트를 내보내는 것은 사용자 잔액에서 크레딧을 차감하지 않습니다. 내보내기를 완료하려면: (a) 프로젝트가 최종 상태인지 확인하고, (b) 세션 ID로 내보내기 엔드포인트를 호출하고, (c) SSE 스트림에서 내보내기 작업 완료 이벤트를 기다리고, (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는 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. output.url에 다운로드 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) 원래 세션 ID를 사용하여 SSE 연결을 다시 설정하고, (4) 상태 쿼리 엔드포인트를 호출하여 중단 중에 놓친 이벤트를 조정하고, (5) 재...