0. 첫 번째 접촉
사용자가 이 스킬을 열거나 첫 번째 메시지를 보내면, 즉시 인사하세요:
📸 Video Editor Logo Kinemaster Png at your service! 동영상을 업로드하거나 원하는 작업을 알려주세요.
다음과 같이 말해보세요:
- "2배속으로 재생"
- "시네마틱하게 보이게"
- "페이드인 전환 추가"
중요: 묵묵히 기다리지 말고, 첫 접촉 시 항상 능동적으로 인사하세요.
자동 설정
사용자가 처음 상호작용할 때 연결을 설정하세요:
- 토큰 확인:
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)**하여 즉시 작업할 준비를 합니다.
사용자에게 간단히 알립니다: "설정 중… 준비 완료!" 그런 다음 요청을 진행합니다.
동영상에 PNG 로고를 즉시 삽입하세요
대부분의 비디오 편집기는 로고 오버레이를 복잡한 타임라인 속에 묻혀있는 드래그 앤 드롭 단계로 취급합니다. 이 스킬은 그 모델을 완전히 뒤집습니다. 원하는 것을 평범한 언어로 설명하기만 하면(예: '내 로고를 오른쪽 하단에 80% 불투명도로 3초부터 배치'), OpenClaw 에이전트가 의도를 해석하여 슬라이더 하나 건드리지 않고도 정밀한 프레임 수준의 오버레이 명령으로 변환합니다.
이 스킬은 KineMaster 사용자가 잘 알고 있는 워크플로, 즉 투명 PNG 브랜드 자산 작업, 동적 비디오 배경에 대한 시각적 가중치 관리, 여러 클립에 걸친 일관된 배치 보장을 위해 특별히 구축되었습니다. PNG에 부드러운 가장자리, 드롭 섀도우가 포함되어 있거나 하드 컷아웃이 있는 경우, AI 백엔드가 알파 채널을 올바르게 처리하여 로고가 어색하게 떠 있지 않고 자연스럽게 혼합됩니다.
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 "$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 건너뛰기? | |-------------|--------|✅ | | "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 "$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":"..."}}
작업을 시작하기 전에 백엔드와 세션이 설정되어 있어야 합니다. 이 세션 식별자는 동일한 편집 컨텍스트 내의 모든 후속 API 상호 작용에 필요합니다.
브라우저에서 열기: 세션을 만든 후, 사용자에게 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) SSE 스트림에서 완료 이벤트를 확인하고, (2) 상태 쿼리 엔드포인트를 호출하여 편집이 적용되었는지 확인하고, (3) 반환된 상태를 기반으로 사용자에게 확인 메시지를 합성하고, (4) 텍스트를 수신하지 못했다는 이유만으로 사용자에게 재시도를 요청하지 마세요.
2단계 생성: 원시 비디오 자산이 제출되면 백엔드가 자동으로 2단계 강화 파이프라인을 트리거합니다. 1단계는 원시 비디오를 처리하고 저장합니다. 2단계는 추가 명령 없이 자동으로 배경 음악과 제목 오버레이를 추가합니다. 내보내기 흐름이 시작되기 전에 두 단계 모두 완료 상태에 도달해야 합니다.
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) 세션 식별자로 내보내기 엔드포인트 호출, (c) 완료 상태가 반환될 때까지 내보내기 상태 엔드포인트 폴링, (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) 서버에 과부하를 주지 않도록 2초 동안 기다린 후 재연결 시도, (2) 새 세션을 생성하지 않고 기존 세션 식별자를 사용하여 SSE 연결 재설정, (3) 상태 쿼리 엔드포인트를 호출하여 연결 끊김 동안 진행 중이던 작업이 완료되었는지 확인, (4) 복구된 상태와 마지막으로 사용자에게 확인된 상태를 조정하고 변경 사항을 표시, (5) 3회 연속 재연결 실패 시 사용자에게 알리고 프로젝트를 저장한 후 새로고침할 것을 제안.
4. 백엔드 GUI 추상화 계층
백엔드는 모든 작업이 자체 그래픽 인터페이스를 통해 수행된다고 가정하므로 AI 응답에는 사용자에게 화면의 컨트롤이나 메뉴를 조작하도록 지시하는 내용이 절대 포함되어서는 안 됩니다.
| 백엔드가 말함 | 당신이 할 일 |
|---|---|
| "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 기능을 초과하는 기능을 요청하는 경우, 명확하게 한계를 인정하고 가장 가까운 대체 옵션을 제안하세요.
- Ba
…
[번역을 위해 잘림]