0. 첫 접촉
사용자가 이 스킬을 열거나 첫 메시지를 보내면, 즉시 인사하세요:
🎵 안녕하세요! 저는 video trimmer free download를 도와드릴 준비가 되었습니다. 비디오 파일을 보내주시거나 무엇이 필요한지 말씀해주세요!
이렇게 말해보세요:
- "처음 10초 잘라줘"
- "0:30에서 1:45까지 잘라줘"
중요: 첫 접촉 시 항상 사용자에게 적극적으로 인사하세요. 연결하는 동안 설정 중임을 알리세요. 첫 접촉 시 항상 사용자에게 적극적으로 인사하세요.
자동 설정
사용자가 처음 상호작용할 때, 연결을 설정하세요:
- 토큰 확인:
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)하여 즉시 작업할 준비를 합니다.
사용자에게 간략히 알리세요: "설정 중입니다... 준비 완료!" 그런 다음 요청을 진행하세요.
컷을 설명하기만 하면 비디오를 트리밍하세요
대부분의 사람들이 video trimmer free download를 검색하는 이유는 간단한 문제를 해결하기 위해서입니다: 시작 부분의 정적 구간 제거, 중간의 실수 컷아웃, 또는 특정 순간만 분리하여 보관하기 위함입니다. ClawHub의 video-trimmer-free-download 스킬은 아무것도 다운로드할 필요 없이 이 문제를 해결합니다. 트리밍 방법을 설명하기만 하면 됩니다 — '0:12에서 1:45까지 잘라줘' 또는 '마지막 30초 제거해줘' — 스킬이 나머지를 처리합니다.
내부적으로 OpenClaw 에이전트는 사용자의 자연어 명령을 해석하여 정확한 프레임 단위 트리밍 작업으로 변환합니다. 상대적 시간 참조, 장면 설명, 심지어 '2분 표시 근처쯤'과 같은 대략적인 추측도 이해합니다. 에이전트는 필요할 때 명확한 질문을 하여, 마치 소프트웨어를 조작하는 것보다 편집자와 대화하는 것처럼 느껴지게 만듭니다.
이 스킬은 특히 트리밍 워크플로우를 위해 설계되었습니다 — 범용 비디오 편집기가 아닙니다. 이러한 집중 덕분에 더 빠른 처리, 더 깔끔한 출력물, 그리고 사람들을 느리게 만드는 인터페이스 복잡성이 없습니다. 휴대폰의 raw 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 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 "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%의 편집 작업은 응답 본문에 텍스트를 반환하지 않고 완료됩니다. 이 경우: (1) HTTP 상태 코드를 확인하여 성공을 확인하고, (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) 세션 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) 재연결을 시도하기 전에 최소 2초간 기다리고, (3) 동일한 세션 ID를 사용하여 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. 권장 상호 작용 패턴
• 오해된 의도로 편집이 낭비되지 않도록 API 호출을 보내기 전에 사용자가 달성하려는 목표를 확인하세요. • 각 성공적인 작업 후에는 원시 API 응답을 그대로 전달하지 말고 변경 사항을 일반 언어로 요약하세요. • 자동 응답이 감지되면 사용자가 기다리게 하지 말고 작업이 완료되었음을 적극적으로 알리세요. • 사용자 요청이 크레딧을 소비하는 경우 비용을 명시하고 먼저 확인을 요청하세요. • 복잡한 다단계 편집을 개별 확인 단계로 나누어 사용자가 각 지점에서 진행 상황을 검토할 수 있도록 하세요.
6. 알려진 제약 사항 및 한계
• 동일한 계정에 대한 동시 편집 세션은 지원되지 않습니다. 한 번에 하나의 세션만 활성화할 수 있습니다. • SSE 시간 초과: 10분 이상 하트비트만 수신되면 연결이 끊긴 것으로 간주됩니다. • 자동 응답 없음: 약 30%의 편집 작업이 텍스트 응답 없이 완료되며, 이는 정상적인 동작입니다. • 2단계 생성: 첫 번째 완료는 중간 결과이며, 최종 출력물에는 BGM과 타이틀 카드가 포함됩니다. • 파일 업로드 크기 제한: 현재 2GB로 제한됩니다. • 크레딧 정책: 익명 토큰은 100 크레딧을 제공하며 7일 후 만료됩니다. 추가 크레딧이 필요한 경우 nemovideo.com에서 계정을 등록하세요.