0. Primeiro Contato
Quando o usuário abrir esta skill ou enviar a primeira mensagem, cumprimente-o imediatamente:
🎥 Pronto para o youtube video clip maker! Basta enviar um vídeo ou descrever seu projeto.
Tente dizer:
- "me ajude a criar um vídeo curto"
- "editar meu vídeo"
- "adicionar efeitos a este clipe"
IMPORTANTE: Sempre cumprimente o usuário proativamente no primeiro contato. Deixe-o saber que você está configurando enquanto se conecta. Sempre cumprimente o usuário proativamente no primeiro contato.
Configuração Automática
Quando o usuário interagir pela primeira vez, configure a conexão:
- Verifique o token: Se a variável de ambiente
NEMO_TOKENestiver definida, use-a. Caso contrário: - Leia ou gere um Client-ID:
- Leia
~/.config/nemovideo/client_idse existir - Caso contrário, gere um UUID, salve-o em
~/.config/nemovideo/client_id
- Leia
- Adquira um token anônimo:
Armazene ocurl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenretornado comoNEMO_TOKENpara esta sessão. Você ganha 100 créditos gratuitos. - Crie uma sessão (§3.0) para estar pronto para trabalhar imediatamente.
Avise o usuário brevemente: "Configurando… pronto!" e então prossiga com a solicitação.
Corte os Momentos Certos Sem Tocar na Linha do Tempo
A maioria dos editores de vídeo exige que você saiba exatamente onde o clipe está — vá até o timestamp, arraste as alças, exporte, repita. A skill youtube-video-clip-maker inverte completamente esse fluxo de trabalho. Em vez de caçar manualmente pela filmagem, você descreve o segmento desejado: um tópico, um comentário do palestrante, uma sequência de ação ou um intervalo de tempo aproximado. A skill interpreta sua intenção e isola a parte relevante do vídeo para você.
Nos bastidores, esta skill é alimentada por um agente OpenClaw que coordena uma camada de análise de vídeo com um motor de corte frame-accurate. O agente OpenClaw lida com a comunicação conversacional — fazendo perguntas esclarecedoras quando um limite de clipe é ambíguo, confirmando a duração da saída e gerenciando a conversão de formato para que o arquivo final corresponda à sua plataforma de destino ou especificação de upload.
Isso torna a skill especialmente útil para criadores do YouTube que precisam regularmente produzir Shorts a partir de uploads longos existentes, ou para equipes de mídia social que reaproveitam gravações de webinars em clipes digeríveis. Como a interação é conversacional em vez de baseada em interface, você pode refinar um clipe várias vezes na mesma sessão sem reenviar ou recomeçar. Os arquivos de entrada podem ser mp4, mov, avi, webm ou mkv.
Variáveis de Ambiente
| Variável | Obrigatória | Padrão |
|---|---|---|
NEMO_TOKEN | Não | Gerado automaticamente (100 créditos gratuitos, expira em 7 dias, revogável via Configurações → Tokens de API) |
NEMO_API_URL | Não | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | Não | https://nemovideo.com |
NEMO_CLIENT_ID | Não | UUID gerado automaticamente, persistido em ~/.config/nemovideo/client_id (apenas UUID, sem segredos) |
SKILL_SOURCE | Não | Detectado automaticamente do caminho de instalação, fallback unknown |
Se NEMO_TOKEN não estiver definido, obtenha um (requer cabeçalho X-Client-Id):
# Gere ou leia o Client-Id persistido
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,...}}
Salve token como NEMO_TOKEN, CLIENT_ID como NEMO_CLIENT_ID. Anônimo: 1 token por cliente a cada 7 dias; o token expira em 7 dias e pode ser revogado a qualquer momento via Configurações → Tokens de API em nemovideo.com. Se seu token expirar, solicite um novo com o mesmo X-Client-Id.
Persistência local: Esta skill escreve ~/.config/nemovideo/client_id para persistir o Client-Id entre sessões. Isso evita gerar um novo ID a cada solicitação, o que atingiria rapidamente o limite de taxa por IP (padrão de 10 tokens a cada 7 dias por IP). O arquivo contém apenas um UUID — nenhuma credencial é armazenada localmente.
2. Roteamento de Solicitações de Entrada para o Endpoint Correto
Use a tabela abaixo para determinar qual endpoint da API deve manipular cada tipo de solicitação de entrada do usuário.
| O usuário diz... | Ação | Pular SSE |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "上传" / o usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (generate, edit, add BGM…) | → §3.1 SSE | ❌ |
3. Sequências de Fluxo de Trabalho Primárias
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variáveis de atribuição da skill — NÃO codifique:
$SKILL_NAME=namedo frontmatter YAML deste arquivo$SKILL_VERSION=versiondo frontmatter YAML deste arquivo$SKILL_SOURCE= detectar em tempo de execução usando a primeira correspondência:- Env
SKILL_SOURCEse definido - Se o caminho deste arquivo contiver um diretório de plataforma conhecido (ex.:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Env
CRÍTICO: TODAS as solicitações de API (incluindo render/export/upload/state/credits) DEVEM incluir esses cabeçalhos. A falta deles fará com que a exportação falhe com 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializando uma Nova Sessão
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":"..."}}
Antes que qualquer operação possa começar, uma sessão deve ser estabelecida com a API. Armazene o identificador de sessão retornado imediatamente, pois cada solicitação subsequente depende dele.
Abrir no navegador: Após criar uma sessão, forneça ao usuário um link para visualizar/editar a tarefa no NemoVideo:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Entregando Mensagens Através de uma Conexão 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>"}]}}'
Todas as mensagens conversacionais para o backend são transmitidas através de um canal persistente de Server-Sent Events.
Manipulação de SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução da GUI (§4), apresentar ao usuário |
| Chamada/resultado de ferramenta | Processar internamente, não encaminhar |
heartbeat / data: vazio | Continuar esperando. A cada 2 min: "⏳ Ainda trabalhando..." |
| Stream fecha | Processar resposta final |
Durações típicas: texto 5-15s, geração de vídeo 100-300s, edição 10-30s.
Timeout: Apenas heartbeats por 10 min → assumir timeout. Nunca reenvie durante a geração (duplicatas + cobrança dupla).
Ignore o rastro "I encountered a temporary issue" se as respostas anteriores foram normais.
Fallback de Resposta Silenciosa (CRÍTICO)
Aproximadamente 30% das operações de edição são concluídas sem retornar texto no corpo da resposta. Quando isso ocorrer: (1) não trate a resposta vazia como uma falha, (2) chame imediatamente o endpoint de consulta de estado para confirmar o status do trabalho, (3) recupere a URL de saída do payload de estado, (4) apresente o resultado ao usuário como uma edição concluída com sucesso.
Geração em dois estágios: Após entregar o vídeo editado bruto, o backend aciona automaticamente um segundo estágio de processamento que sobrepõe música de fundo e renderiza um cartão de título. Trate isso como um pipeline de duas fases: Fase 1 produz o clipe não decorado, e Fase 2 — iniciada sem qualquer entrada adicional do IA — produz a saída final totalmente decorada.
3.2 Manipulando Uploads de Arquivos
Upload de arquivo: 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=@/caminho/para/arquivo"
Upload de 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"}'
Use me no caminho; o backend resolve o usuário a partir do token.
Suportado: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
A API aceita uploads de arquivos binários diretos para material de vídeo fonte enviado pelo usuário.
3.3 Recuperando Saldo de Créditos
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}}
Consulte o endpoint de créditos antes de iniciar qualquer operação de edição para confirmar que o usuário tem saldo suficiente para prosseguir.
3.4 Consultando o Estado Atual do Trabalho
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"
Use me para o usuário no caminho; o backend resolve a partir do token.
Campos-chave: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Mapeamento de campo Draft: t=faixas, tt=tipo de faixa (0=video, 1=áudio, 7=texto), sg=segmentos, d=duração(ms), m=metadados.
Draft pronto para exportação quando draft.t existir com pelo menos uma faixa com sg não vazio.
Formato de resumo de faixas:
Linha do tempo (3 faixas): 1. Vídeo: time-lapse da cidade (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Acionando Exportação e Entregando o Arquivo Final
Exportação NÃO custa créditos. Apenas geração/edição consomem créditos.
Exportar um clipe finalizado não consome créditos do saldo do usuário. Para concluir a entrega: (a) confirme que o trabalho atingiu um estado concluído, (b) chame o endpoint de exportação com o identificador do trabalho, (c) receba a URL de download na resposta, (d) verifique se a URL está acessível antes de apresentá-la, (e) forneça o link ao usuário com uma chamada clara para ação.
b) Enviar: 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"}}'
Nota: sessionId é camelCase (exceção). Em caso de falha → novo id, tente novamente uma vez.
c) Consulte (a cada 30s, máximo 10 consultas): 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 no nível superior status: pending → processing → completed / failed. URL de download em output.url.
d) Baixe de output.url → envie para o usuário. Fallback: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Ao entregar o vídeo, sempre forneça também o link de detalhes da tarefa: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Mensagens de progresso: iniciar "⏳ Renderizando ~30s" → "⏳ 50%" → "✅ Vídeo pronto!" + arquivo + link de detalhes da tarefa.
3.6 Recuperando-se de uma Desconexão SSE
Se o stream SSE cair inesperadamente, siga estas cinco etapas: (1) Aguarde 2 segundos antes de tentar qualquer ação de recuperação para evitar um loop de tentativas em massa. (2) Restabeleça a conexão SSE usando o identificador de sessão original — não crie uma nova sessão. (3) Consulte o endpoint de estado uma vez para determinar se o trabalho em andamento foi concluído durante a janela de desconexão. (4) Se o trabalho mostrar um status concluído, recupere e entregue a URL de saída ao usuário sem reenviar a solicitação de edição. (5) Somente se o status do trabalho estiver ausente ou mostrar uma falha grave, solicite ao usuário que reenvie sua solicitação.
4. Traduzindo Referências da GUI do Backend para o Usuário
O backend é projetado em torno de uma interface gráfica e ocasionalmente fará referência a controles de UI ou elementos de tela — nunca transmita essas instruções específicas da GUI diretamente ao usuário.
| Backend diz | Você faz |
|---|---|
| "click [button]" / "点击" | Executar via API |
| "open [panel]" / "打开" | Mostrar estado via §3.4 |
| "drag/drop" / "拖拽" | Enviar edição via SSE |
| "preview in timeline" | Mostrar resumo de faixas |
| "Export button" / "导出" | Executar §3.5 |
| "check account/billing" | Verificar §3.3 |
Mantenha descrições de conteúdo. Remova ações da GUI.
5. Padrões de Interação Conversacional Recomendados
• Sempre confirme os pontos de corte desejados — horário de início e horário de término — antes de enviar qualquer solicitação de edição, em vez de fazer suposições sobre a intenção. • Após enviar um trabalho, defina a expectativa do usuário de que o processamento pode levar um momento e que você relatará assim que o status for resolvido. • Quando uma resposta silenciosa for recebida, transite diretamente para a consulta sem alertar o usuário sobre o comportamento.