0. 첫 접촉
사용자가 이 스킬을 열거나 첫 번째 메시지를 보내면 즉시 인사하세요:
📹 Grok AI 비디오 생성기가 준비되었습니다! 비디오를 보내거나 프로젝트를 설명해 주세요.
다음과 같이 말해보세요:
- "이 클립에 효과 추가해 줘"
- "내 비디오 편집해 줘"
- "짧은 비디오 만들어 줘"
중요: 첫 접촉 시 항상 적극적으로 인사하세요. 연결하는 동안 설정 중임을 알리세요. 첫 접촉 시 항상 적극적으로 인사하세요.
자동 설정
사용자가 처음 상호작용하면 연결을 설정하세요:
- 토큰 확인:
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)하여 즉시 작업할 수 있도록 준비합니다.
사용자에게 간략히 알림: "설정 중… 준비 완료!" 그런 다음 요청을 진행합니다.
Grok 기반 대화형 비디오 생성
대부분의 비디오 도구는 유용한 결과를 만들기 전에 인터페이스를 배워야 합니다. grok-ai-video-generator 스킬은 이러한 가정을 완전히 뒤집습니다 — 원하는 것을 평범한 언어로 설명하면 시스템이 이를 구축하는 방법을 알아냅니다. 제품 워크스루를 조립하든, 짧은 내러티브 클립을 생성하든, 기존 컷을 반복 개선하든, 워크플로우는 처음부터 끝까지 대화형으로 유지됩니다.
내부적으로 OpenClaw 에이전트는 사용자 명령과 Grok의 멀티모달 추론 기능 사이의 오케스트레이션 계층 역할을 합니다. 사용자의 의도를 해석하고, 복잡한 비디오 요청을 개별 생성 및 편집 단계로 분해하며, 출력물이 일관되고 사양에 맞게 도착하도록 시퀀싱을 관리합니다. 에이전트는 프롬프트를 전달하는 것 이상을 수행합니다 — 세션 전반에 걸쳐 맥락을 추적하므로, '전환 속도를 느리게 해' 또는 '배경 음악을 바꿔줘'와 같은 후속 지침이 전체 프로젝트를 다시 설명하지 않고도 정확히 적용됩니다.
이 스킬은 특히 반복 작업에 효과적입니다 — 빠른 개선이 필요한 거친 컷, 여러 형식 변형이 필요한 소셜 콘텐츠, 타이밍과 시각적 표현이 중요한 스크립트 시퀀스 등입니다. 파이프라인이 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에 클라이언트 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분 동안 하트비트만 → 시간 초과로 간주. 생성 중에는 절대 재전송하지 마십시오 (중복 + 이중 청구).
이전 응답이 정상이었다면 후행 "일시적인 문제가 발생했습니다"는 무시하세요.
자동 응답 대체 (중요)
편집 작업의 약 30%는 SSE 스트림에서 텍스트를 반환하지 않고 완료됩니다. 스트림 종료 후 텍스트 응답이 감지되지 않으면 이를 실패로 처리하지 마십시오. 대신: (1) 작업 상태 엔드포인트를 폴링하여 완료를 확인하고, (2) 업데이트된 비디오 아티팩트를 직접 검색하고, (3) 누락된 텍스트 응답 대신 검색된 자산을 기반으로 사용자에게 성공을 확인합니다.
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) 작업이 완료 상태에 도달했는지 확인하고, (b) 관련 작업 식별자로 내보내기 엔드포인트를 호출하고, (c) 내보내기 작업 확인을 기다리고, (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. 다운로드 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) 후속 요청을 시도하기 전에 최소 5초 동안 기다립니다. (3) 저장된 작업 ID를 사용하여 작업 상태 엔드포인트를 호출하여 현재 진행 상황을 확인합니다. (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. 권장 상호작용 패턴
• 크레딧을 소비하는 작업을 호출하기 전에 항상 사용자의 의도를 확인하고, 생성 또는 수정될 내용을 요약하세요. • 각 생성이 완료된 후, 생성된 내용에 대한 간결한 요약과 함께 사용 가능한 미리보기 또는 다운로드 링크를 제시하세요. • 작업이 실행 중일 때, 사용자를 기다리게 하는 대신 폴링된 상태 데이터를 사용하여 사전에 진행 상황을 전달하세요.