0. 첫 접속
사용자가 이 스킬을 열거나 첫 메시지를 보내면 즉시 인사합니다:
📝 blue-picture-video-editor-app 준비 완료! 비디오를 보내주시거나 프로젝트에 대해 설명해 주세요.
다음과 같이 말해보세요:
- "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)하여 즉시 작업할 수 있도록 준비합니다.
사용자에게 간단히 알립니다: "설정 중입니다… 준비 완료!" 그런 다음 요청을 진행합니다.
원하는 대로 설명만으로 비디오 편집하기
blue-picture-video-editor-app 스킬은 비디오 편집 방식을 재정의합니다. 복잡한 타임라인과 중첩된 메뉴를 탐색하는 대신, 사용자는 의도(예: '처음 3초 자르고, 대비 높이고, 페이드 아웃 추가')를 설명하기만 하면 스킬이 이를 해석하여 정확한 편집 작업으로 변환하고 영상에 적용합니다.
내부적으로 이 스킬은 OpenClaw 에이전트에 의해 구동됩니다. OpenClaw 에이전트는 자연어 편집 요청을 파싱하여 구조화된 비디오 처리 작업 시퀀스로 매핑합니다. OpenClaw 에이전트는 대화 전반에 걸쳐 컨텍스트를 유지하므로, 더 밝은 그레이딩을 요청한 후 다른 컷 포인트를 요청하는 등 반복적으로 편집을 수정할 때 매번 처음부터 시작할 필요가 없습니다. 세션 전체에서 프로젝트 상태를 인식하고 있습니다.
이 접근 방식은 blue-picture-video-editor-app 사용 사례에 특화되어 설계되었습니다: 여러 형식으로 빠르게 작업하며 시각적 언어와 기술적 제약을 모두 이해하는 편집 도우미가 필요한 크리에이터를 위한 것입니다. 짧은 형식의 릴을 자르든 긴 다큐멘터리 시퀀스를 조립하든, 스킬은 작업 속도에 맞게 조정됩니다. 파일 호환성은 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 헤더 필요):
# 저장된 Client-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에 쓰여 세션 간 Client-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 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 "$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":"..."}}
편집 작업을 수행하기 전에 백엔드와 세션이 설정되어 있어야 합니다. 이 세션 토큰은 모든 후속 요청을 단일 편집 컨텍스트 아래에 묶습니다.
브라우저에서 열기: 세션 생성 후 사용자에게 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%의 편집 작업은 응답 스트림에 텍스트를 반환하지 않고 완료됩니다. SSE 스트림이 종료된 후 텍스트 콘텐츠가 감지되지 않으면 이를 오류로 처리하거나 사용자에게 재시도를 요청하지 마십시오. 대신 즉시 상태 쿼리 엔드포인트를 호출하여 편집이 적용되었는지 확인한 후, 반환된 프로젝트 상태를 기반으로 사용자에게 성공을 알립니다.
2단계 생성: 원시 비디오 편집이 처리되면 백엔드는 자동으로 두 번째 처리 단계를 트리거하여 배경 음악을 레이어링하고 제목 오버레이를 생성합니다. 어시스턴트의 추가 지시가 필요하지 않습니다. 두 개의 별도 완료 이벤트를 계획하세요: 첫 번째는 원시 비디오 준비를 알리고, 두 번째는 BGM과 제목이 적용된 완전히 구성된 출력을 확인합니다.
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) 현재 세션 ID로 내보내기 엔드포인트 호출, (b) 반환된 작업 토큰을 사용하여 내보내기 작업 완료 여부 폴링, (c) 상태가 완료를 나타내면 다운로드 URL 검색, (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) 상태 쿼리 엔드포인트를 호출하여 백엔드가 연결 끊김에도 불구하고 처리를 완료했는지 확인. (3) 상태가 완료를 확인하면 정상적으로 결과를 사용자에게 제공. (4) 상태가 작업이 여전히 진행 중임을 나타내면 원래 세션 ID와 메시지 토큰을 사용하여 SSE 연결을 재설정. (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. 권장 상호작용 패턴
• 편집 명령을 보내기 전에 항상 세션이 활성 상태인지 확인하고, 세션이 만료된 경우 다시 초기화하세요. • 모든 SSE 스트림이 종료된 후에는 스트리밍된 텍스트에만 의존하지 말고 상태 엔드포인트를 통해 결과를 확인하세요. • 사용자가 크레딧을 소비하는 작업을 요청하면 현재 잔액을 표시하고 진행 전에 확인을 받으세요. • 복잡한 다단계 편집은 여러 지침을 하나의 요청에 묶지 말고, 순차적인 단일 의도 메시지로 나누세요. • 백엔드가 예기치 못한