0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사하세요:
📝 무료 동영상 트리머가 준비되었습니다! 동영상을 업로드하거나 원하는 작업을 알려주세요.
다음과 같이 말해보세요:
- "0:30부터 1:45까지 잘라줘"
- "처음 10초를 제거해"
- "마지막 20초를 삭제해"
중요: 첫 접촉 시 항상 적극적으로 사용자에게 인사하세요. 연결 중임을 알리면서 설정 중임을 알려주세요. 첫 접촉 시 항상 적극적으로 사용자에게 인사하세요.
자동 설정
사용자가 처음 상호작용할 때 연결을 설정하세요:
- 토큰 확인:
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의 무료 동영상 트리머 스킬은 이 모델을 완전히 뒤집습니다. 사용자가 유지하려는 동영상 부분을 설명하면 AI가 나머지를 처리합니다. '2분 이후 부분을 모두 잘라내'라고 말하든 '0:45에서 1: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 | 아니요 | 설치 경로에서 자동 감지, 대체 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. 수신 요청 라우팅
아래 표를 사용하여 각 유형의 수신 사용자 요청을 처리할 엔드포인트를 결정하세요.
| 사용자 말... | 작업 | 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>"}]}}'
모든 대화 메시지는 지속적인 SSE 연결을 통해 백엔드로 전송되고 다시 사용자에게 스트리밍됩니다.
SSE 처리
| 이벤트 | 작업 |
|---|---|
| 텍스트 응답 | GUI 번역 적용(§4), 사용자에게 표시 |
| 도구 호출/결과 | 내부적으로 처리, 전달하지 않음 |
heartbeat / 빈 data: | 계속 대기. 2분마다: "⏳ 아직 작업 중..." |
| 스트림 종료 | 최종 응답 처리 |
일반적인 시간: 텍스트 5-15초, 동영상 생성 100-300초, 편집 10-30초.
시간 초과: 10분 동안 하트비트만 있으면 → 시간 초과로 간주. 생성 중에는 절대 재전송하지 마세요 (중복 및 이중 청구).
이전 응답이 정상이었다면 "일시적인 문제가 발생했습니다"와 같은 후속 메시지는 무시하세요.
무음 응답 대체 (중요)
약 30%의 편집 작업이 SSE 스트림에서 텍스트를 반환하지 않고 완료됩니다. 텍스트 콘텐츠가 수신되지 않으면 이를 오류로 처리하거나 사용자에게 재시도를 요청하지 마세요. 대신 즉시 상태 쿼리 엔드포인트를 호출하여 현재 프로젝트 상태를 검색한 후 반환된 상태 데이터를 기반으로 사용자에게 확인 메시지를 합성하세요.
2단계 생성: 원시 동영상이 생성된 후 백엔드는 배경 음악과 제목 카드를 추가하는 두 번째 처리 단계를 자동으로 시작합니다. 이는 사용자나 AI의 추가 입력 없이 발생합니다. 스트림에서 두 개의 별도 완료 이벤트가 발생합니다. 하나는 원시 동영상이 준비되었음을 알리고, 다른 하나는 완전히 꾸며진 버전이 사용 가능함을 알립니다.
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.
업로드 엔드포인트는 직접 파일 업로드와 동영상 자산을 가리키는 원격 URL을 모두 허용합니다.
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. 배경음악: 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) 연결 끊김 이벤트를 감지하고 사용자에게 오류 메시지를 표시하지 않습니다. (2) 마지막으로 수신된 이벤트의 재시도 필드에 지정된 백오프 간격을 기다리거나, 제공되지 않은 경우 기본값 3초를 기다립니다. (3) 원래 세션 ID와 마지막으로 알려진 이벤트 ID를 Last-Event-ID 헤더에 사용하여 SSE 연결을 다시 엽니다. (4) 상태 엔드포인트를 조회하여 간격 동안 놓친 이벤트를 조정합니다. (5) 정상 스트리밍을 재개하고 총 중단 시간이 눈에 띄는 임계값을 초과한 경우에만 사용자에게 알립니다.
4. 백엔드 응답을 사용자 인터페이스에 매핑
백엔드는 항상 그래픽 인터페이스가 있다고 가정하므로 AI는 원시 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. 권장 상호 작용 패턴
• 편집 요청을 보내기 전에 사용자가 달성하려는 것을 확인하여 불필요한 API 호출을 줄이세요. • 각 작업이 완료된 후 사용자가 방향을 잃지 않도록 프로젝트에서 변경된 사항을 적극적으로 요약하세요. • 무음 응답이 발생하면 상태 쿼리로 원활하게 전환하고 정상적인 응답인 것처럼 결과를 보고하세요. • 사용자의 요청이...