0. 첫 접촉
사용자가 이 스킬을 열거나 첫 번째 메시지를 보내면 즉시 인사하세요:
🚀 환영합니다! 텍스트를 비디오로 생성해 드립니다. 비디오 파일을 공유하거나 아이디어를 알려주세요!
다음과 같이 말해보세요:
- "짧은 영상 만들어 줘"
- "내 비디오 편집해 줘"
- "이 클립에 효과 추가해 줘"
중요: 첫 접촉 시 항상 사용자에게 먼저 인사하세요. 연결 준비 중임을 알리세요. 첫 접촉 시 항상 사용자에게 먼저 인사하세요.
자동 설정
사용자가 처음 상호작용하면 연결을 설정하세요:
- 토큰 확인:
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)하여 즉시 작업할 수 있도록 준비합니다.
사용자에게 간략히 알립니다: "설정 중… 준비 완료!" 그런 다음 요청을 진행합니다.
종이 위의 글에서 몇 분 만에 비디오로
대부분의 비디오 제작 도구는 타임라인, 키프레임, 수동 자산 배치를 요구합니다. ClawHub의 텍스트-비디오 생성 스킬은 완전히 다른 접근 방식을 취합니다. 원하는 것을 일상 언어로 설명하면 시스템이 비디오를 구축합니다. 제품 설명, 짧은 소셜 클립, 또는 장면별 내러티브를 작성하든, 이 스킬은 텍스트를 해석하여 의도에 맞는 비디오 출력을 구성합니다.
이 스킬의 핵심은 OpenClaw 에이전트로, 자연어 입력과 기본 비디오 합성 파이프라인 사이에서 지능적인 코디네이터 역할을 합니다. 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 | 아니오 | 설치 경로에서 자동 감지, 기본값 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에 Client-Id를 기록하여 세션 간에 유지합니다. 이렇게 하면 모든 요청마다 새 ID가 생성되는 것을 방지하여 IP당 속도 제한(기본값: IP당 7일마다 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":"..."}}
작업을 시작하려면 먼저 세션을 만들어 유효한 세션 식별자를 얻어야 합니다. 동일한 대화 내의 모든 후속 요청은 이 세션이 먼저 초기화되어 있어야 합니다.
브라우저에서 열기: 세션을 생성한 후 사용자에게 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%의 편집 작업은 응답에 텍스트 내용을 반환하지 않습니다. 이 경우: (1) 빈 응답을 실패로 처리하지 말고, (2) 작업 상태 엔드포인트를 폴링하여 처리가 진행 중인지 확인하고, (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.
업로드 엔드포인트는 사용자가 비디오 프로젝트에 포함하고자 하는 미디어 자산을 받습니다.
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. 비디오: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. 제목: "Urban Dreams" (0-3s)
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는 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 스트림이 예기치 않게 끊어진 경우 다음 5단계를 따라 연속성을 복원하세요: (1) 연결 끊김 이벤트 감지 및 마지막으로 수신된 작업 식별자 기록, (2) 서버에 과도한 부하를 주지 않도록 재연결을 시도하기 전에 짧은 간격 대기, (3) 새 세션을 생성하지 않고 기존 세션 식별자를 사용하여 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. 권장 대화형 상호작용 패턴
• 생성 요청을 보내기 전에 항상 사용자의 의도를 확인하고 필요한 모든 매개변수를 수집한 후에 제출하세요. 불완전한 입력으로 제출하지 마세요. • 생성이 진행되는 동안 증분 진행 업데이트를 제공하여 사용자에게 작업 상태를 알리세요. • 생성이 완료되면 최종 출력을 표시하고 내보내기 전에 만족하는지 확인하세요.