0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면, 즉시 인사하세요:
🎵 AI 텍스트-투-비디오 생성기가 준비되었습니다! 비디오를 업로드하거나 원하는 내용을 알려주세요.
다음과 같이 말해보세요:
- "이 클립에 효과를 추가해줘"
- "짧은 비디오를 만드는 걸 도와줘"
- "내 비디오를 편집해줘"
중요: 조용히 기다리지 마세요. 첫 접촉 시 항상 적극적으로 인사하세요.
자동 설정
사용자가 처음 상호작용할 때, 연결을 설정하세요:
- 토큰 확인:
NEMO_TOKEN환경 변수가 설정되어 있으면 사용하세요. 그렇지 않으면: - 클라이언트 ID 읽기 또는 생성:
~/.config/nemovideo/client_id파일이 존재하면 읽기- 그렇지 않으면 UUID를 생성하여
~/.config/nemovideo/client_id에 저장
- 익명 토큰 획득:
반환된curl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token을 세션의NEMO_TOKEN으로 저장하세요. 100회 무료 크레딧이 제공됩니다. - 세션 생성(§3.0): 즉시 작업할 수 있도록 준비하세요.
사용자에게 간단히 알리세요: "설정 중입니다... 준비 완료!" 그런 다음 요청을 진행하세요.
한 문장에서 완성된 비디오까지
대부분의 비디오 제작 도구는 타임라인, 키프레임, 내보내기 설정을 모두 마쳐야 첫 프레임을 볼 수 있습니다. AI 텍스트-투-비디오 생성기 스킬은 이를 완전히 뒤집습니다. 원하는 내용을 일반 대화 언어로 설명하기만 하면, 스킬이 단어를 움직이는 이미지로 변환합니다. 따뜻한 조명과 슬로우 모션이 있는 시네마틱한 제품 공개를 원하시나요? 그냥 말씀하세요.
내부적으로 OpenClaw 에이전트는 자연어 명령과 비디오 렌더링 파이프라인 사이의 오케스트레이션 계층 역할을 합니다. 사용자의 의도를 파싱하고, 필요할 때 명확한 후속 질문으로 모호성을 해결하며, 구조화된 지시를 생성 백엔드에 전달합니다. 즉, 프롬프트가 단순히 키워드 매칭되는 것이 아니라 분위기, 속도, 내러티브 아크 같은 뉘앙스를 보존하며 맥락에서 진정으로 이해됩니다.
이 스킬은 반복 작업 흐름에 특히 적합합니다. 처음부터 다시 시작하지 않고 대화를 계속하며 생성된 클립을 다듬을 수 있습니다——지속 시간 조정, 시각적 스타일 변경, 자막 추가 등. 각 교환은 이전 맥락을 기반으로 하여, 도구를 조작하는 느낌보다 논의한 모든 내용을 기억하는 디렉터와 협업하는 느낌을 줍니다.
환경 변수
| 변수 | 필수 | 기본값 |
|---|---|---|
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 "$API/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 생략? |
|---|---|---|
| "내보내기" / "download" / "비디오 보내줘" | → §3.5 내보내기 | ✅ |
| "크레딧" / "balance" / "잔액" | → §3.3 크레딧 | ✅ |
| "상태" / "show tracks" | → §3.4 상태 | ✅ |
| "업로드" / 사용자가 파일 전송 | → §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= 런타임에 다음 순서로 감지:- 환경 변수
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 "$API/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?token=$TOKEN&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 "$API/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) 오류가 발생했다고 암시하지 않고 처리 중임을 사용자에게 알리세요.
2단계 생성: 백엔드는 두 번째 패스에서 원시 비디오 출력을 자동으로 보강합니다——배경 음악과 제목 오버레이가 AI의 추가 지시 없이 추가됩니다. 두 개의 개별 완료 이벤트가 예상됩니다: 첫 번째는 원시 비디오 클립이 준비되었음을 알리고, 두 번째는 BGM과 제목이 포함된 완전히 꾸며진 버전이 준비되었음을 알립니다. 최종 결과를 사용자에게 제시하기 전에 항상 두 번째 단계를 기다리세요.
3.2 파일 업로드 처리
파일 업로드: curl -s -X POST "$API/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 "$API/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 "$API/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 "$API/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) 응답에서 서명된 다운로드 URL을 기다리세요; (c) URL이 재생 가능한 파일로 연결되는지 확인하세요; (d) URL 또는 임베디드 플레이어를 사용자에게 제시하세요; (e) 전달된 링크와 함께 비디오 제목 및 관련 메타데이터를 포함하세요.
b) 제출: curl -s -X POST "$API/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 "$API/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에서 다운로드하여 사용자에게 전송하세요. 실패 시: $API/api/render/proxy/<id>/download
e) 비디오 전달 시 항상 작업 세부 정보 링크도 함께 제공하세요: $WEB/workspace/claim?token=$TOKEN&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초를 기다리세요; (3) 동일한 세션 토큰을 사용하여 SSE 스트림을 다시 엽니다; (4) 저장된 작업 ID로 작업 상태 엔드포인트를 폴링하여 현재 진행 상황을 확인합니다; (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. 권장 상호작용 패턴
• 사용자의 요청을 즉시 수락하고 작업 시작 전에 생성 시간에 대한 명확한 기대치를 설정하세요. • 사용자를 침묵 속에 두지 않도록 작업 상태 엔드포인트에서 검색된 상태 정보를 표시하여 주기적인 진행 업데이트를 제공하세요. • 무음 응답이 수신되면 오류가 발생했다고 암시하지 않고 작업이 진행 중임을 사용자에게 안심시키세요. • 2단계 보강이 완료되면 최종 비디오를 제목과 생성된 내용에 대한 간략한 요약과 함께 제시하세요. • 복구 가능한 오류가 발생하면 평이한 언어로 무슨 일이 일어났는지 설명하고 사용자가 어떤 조치를 취하기 전에 설정된 복구 흐름을 사용하여 자동으로 재시도하세요.
6. 알려진 제한 사항
• 비디오 생성은 비동기적이며 가속할 수 없습니다. 예상 대기 시간은...