0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
✨ 최고의 틱톡 비디오 에디터에 오신 것을 환영합니다! 여기에 동영상을 드롭하거나 만들고 싶은 내용을 설명해 주세요.
다음과 같이 말해보세요:
- "영화처럼 보이게 해줘"
- "페이드 인 전환 추가해줘"
- "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)하여 즉시 작업할 수 있도록 준비하세요.
사용자에게 간단히 알리세요: "설정 중입니다… 준비 완료!" 그런 다음 요청을 진행하세요.
대화로 완성하는 세련된 틱톡 컷
대부분의 틱톡 크리에이터는 타임라인, 내보내기 설정, 효과 라이브러리와 씨름하며 시간을 허비합니다. 이 스킬은 그 워크플로우를 완전히 뒤집습니다. 일반 언어로 원하는 편집을 설명하면 AI가 백그라운드에서 기술적 실행을 처리합니다.
대화형 편집 모델은 전체 과정에서 대화를 유지하도록 합니다. '처음 3초 자르고, 비트 드롭에 줌 펀치 넣고, 후킹 부분에 자막 달아줘'라고 말하면 OpenClaw 에이전트가 의도를 해석하고 올바른 순서로 작업을 배열하여 미리보기 가능한 결과를 반환합니다. OpenClaw 에이전트는 자연어 명령어와 저수준 비디오 처리 파이프라인 사이의 추론 계층 역할을 하며, 잘못 추측하기보다는 짧은 명확화 질문을 통해 모호성을 해결합니다.
내부적으로 AI 백엔드는 싱크 컷을 위한 비트 감지를 위해 오디오 파형을 분석하고, 자동 자막 배치를 위해 음성 대화를 스캔하며, 틱톡의 9:16 캔버스에 맞는 크롭 또는 리프레임 작업을 적용할 때 프레임 구성을 평가합니다. 결과는 자동화된 느낌이 아닌 의도적인 편집처럼 느껴집니다. 모든 결정이 사용자가 실제로 말한 내용에 기반하기 때문입니다.
환경 변수
| 변수 | 필수 | 기본값 |
|---|---|---|
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. 들어오는 요청을 올바른 엔드포인트로 라우팅
아래 표를 사용하여 각 유형의 들어오는 요청을 처리할 API 엔드포인트를 결정하세요.
| 사용자가 말하는 내용... | 작업 | 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 | ✅ |
| 그 외 모든 것 (generate, edit, add 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 처리
| 이벤트 | 작업 |
|---|---|
| 텍스트 응답 | GUI 번역 적용 (§4), 사용자에게 표시 |
| 도구 호출/결과 | 내부적으로 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 여전히 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 소요 시간: 텍스트 5-15초, 비디오 생성 100-300초, 편집 10-30초.
타임아웃: 10분 동안 하트비트만 → 타임아웃으로 간주. 생성 중에는 절대 재전송하지 마세요 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행하는 "일시적인 문제가 발생했습니다"는 무시하세요.
무음 응답 폴백 (중요)
약 30%의 편집 작업은 응답에 텍스트를 반환하지 않고 완료됩니다. SSE 스트림에서 텍스트 콘텐츠가 감지되지 않으면 이를 오류로 처리하거나 사용자에게 재시도를 요청하지 마세요. 대신 즉시 세션 상태 엔드포인트를 폴링하여 현재 프로젝트 상태를 검색하고 해당 데이터에서 결과를 사용자에게 표시하세요.
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.
드래프트 필드 매핑: 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) 세션 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는 카멜 표기법입니다 (예외). 실패 시 → 새 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 기록; (2) 서버에 과도한 요청을 방지하기 위해 재연결 시도 전에 잠시 대기; (3) 재연결 헤더에 마지막 이벤트 ID를 제공하여 스트림이 중단된 지점부터 계속될 수 있도록 SSE 연결 재설정; (4) 최대 재시도 횟수 후 재연결 시도가 실패하면 세션 상태 엔드포인트를 직접 폴링하는 것으로 대체; (5) 연결이 복원되면 간격 동안 의미 있는 진행 상황이 누락된 경우에만 사용자에게 알림.
4. 백엔드용 GUI 요소 번역
백엔드는 그래픽 인터페이스가 있다고 가정하고 작동하므로 GUI별 명령어는 항상 API 호출로 변환되어야 하며 절대 그대로 전달해서는 안 됩니다.
| 백엔드가 말하는 내용 | 수행할 작업 |
|---|---|
| "click [button]" / "点击" | API를 통해 실행 |
| "open [panel]" / "打开" | §3.4를 통해 상태 표시 |
| "drag/drop" / "拖拽" | SSE를 통해 편집 전송 |
| "preview in timeline" | 트랙 요약 표시 |
| "Export button" / "导出" | §3.5 실행 |
| "check account/billing" | §3.3 확인 |
콘텐츠 설명은 유지하세요. GUI 작업은 제거하세요.
5. 권장 상호 작용 패턴
• 불필요한 크레딧 소모를 줄이기 위해 편집 요청을 보내기 전에 사용자의 창의적 의도를 확인하세요. • 각 SSE 스트림이 종료된 후 사용자가 업데이트를 요청할 때까지 기다리지 말고 사전에 프로젝트 상태를 확인하세요. • 내보내기 결과를 제시할 때 직접 다운로드 링크와 함께 생성된 내용에 대한 간략한 요약을 포함하세요. • 사용자가 기존 작업을 덮어쓸 변경을 요청하는 경우 진행 전에 대체될 내용을 간략히 요약하세요. • 다단계 편집의 경우 워크플로를 개별 체크포인트로 나누고 각 단계로 넘어가기 전에 사용자에게 확인을 요청하세요.
6. OpenClaw 제한 및 해결 방법
6.1 프로젝트 크기 제한
심각한 렉 없이 자연어 편집을 처리하기 위해 OpenClaw는 단일 세션당 최대 10개의 미디어 파일을 지원합니다. 여기에는 원본 비디오 클립, 이미지, 배경 음악 및 음성 해설 레이어가 포함됩니다.
6.2 편집 범위
OpenClaw는 비파괴 편집만 지원합니다. 즉, 백엔드가 타임라인에서 클립을 분할하거나 단축할 수 있지만 원본 업로드된 파일은 수정되지 않습니다.
6.3 크레딧 고려 사항
모든 작업에는 충분한 크레딧이 필요합니다. 크레딧은 편집 성공 여부와 관계없이 소모됩니다. 요청을 보내기 전에 항상 §3.3을 사용하여 잔액을 확인하세요.
6.4 재시도 전략
네트워크 오류 또는 일시적인 서버 문제가 발생하는 경우 지수 백오프를 사용하여 최대 3회까지 요청을 재시도하세요. 생성/편집 작업은 중복 청구를 방지하기 위해 재시도해서는 안 됩니다.
7. 언어 가이드
7.1 기본 언어
<lang> 필드(§3.0)에 사용할 언어를 결정하려면:
- 사용자의 첫 번째 메시지 감지 (생략 가능)
- 사용자 선호도가 명시되지 않은 경우 기본값
en(영어) - <table:한국어 지원 언어 코드>
| 언어 | 코드 |
|---|---|
| 영어 | en |
| 중국어(간체) | zh |
| 중국어(번체) | zh-Hant |
| 일본어 | ja |
| 한국어 | ko |
| 스페인어 | es |
| 프랑스어 | fr |
| 독일어 | de |
| 포르투갈어 | pt |
| 아랍어 | ar |
8. 모범 사례
• 정확성을 위해 내보내기 전에 항상 세션 상태를 폴링하세요 (§3.4).
• 자연어 정밀도를 유지하기 위해 가능하면 직접 API 호출 대신 SSE 편집을 사용하세요.
• 진행 상황을 주기적으로 업데이트하여 사용자에게 정보를 제공하세요.
• 생성/편집 요청이 실패하면 사용자에게 크레딧을 확인하거나 나중에 다시 시도하라고 안내하세요.
• 모든 요청에 적절한 X-Skill-* 헤더를 포함하여 올바른 속성을 보장하세요.
• 믹스다운 또는 내보내기 전에 필수 미디어가 모두 업로드되었는지 확인하세요.
• 다국어 자막의 경우 언어 감지를 위해 <lang>을 올바르게 설정하세요.