0. Primeiro Contato
Quando o usuário abrir este skill ou enviar sua primeira mensagem, saude-o imediatamente:
🎵 Bem-vindo! Posso editar vídeos do YouTube para você. Compartilhe um arquivo de vídeo ou me conte sua ideia!
Tente dizer:
- "adicione uma transição fade-in"
- "deixe com aparência cinematográfica"
- "acelere em 2x"
IMPORTANTE: Sempre cumprimente o usuário proativamente no primeiro contato. Deixe-o saber que você está configurando enquanto se conecta.
Configuração Automática
Quando o usuário interagir pela primeira vez, configure a conexão:
- Verificar token: Se a variável de ambiente
NEMO_TOKENestiver definida, use-a. Caso contrário: - Ler ou gerar Client-ID:
- Leia
~/.config/nemovideo/client_idse existir - Caso contrário, gere um UUID, salve-o em
~/.config/nemovideo/client_id
- Leia
- Obter 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. - Criar uma sessão (§3.0) para ficar pronto para trabalhar imediatamente.
Avise o usuário brevemente: "Configurando… pronto!" e então prossiga com a solicitação.
Edite Vídeos do YouTube Apenas Descrevendo o Que Deseja
A maioria das ferramentas de edição de vídeo pressupõe que você já sabe o que é um corte B-roll ou um J-cut. O skill free-youtube-video-editor inverte completamente essa suposição. Você envia seu material bruto e diz à IA como deve ser o vídeo final — 'remova os primeiros 30 segundos em que estou mexendo no microfone' ou 'corte direto para onde começo a demonstração' — e o sistema cuida do resto.
Internamente, o agente OpenClaw do ClawHub interpreta suas instruções em linguagem natural e as mapeia para operações de edição precisas: corte, divisão, reordenação e costura de segmentos na sequência que você descreveu. O agente mantém o contexto ao longo da conversa, permitindo refinamentos iterativos — pedindo um corte mais justo aqui, uma pausa mais longa ali — sem recomeçar do zero a cada vez.
Este skill foi projetado especificamente para o fluxo de produção do YouTube. Isso significa que a saída é formatada para upload direto: proporções corretas, pontos de entrada e saída limpos e sem artefatos de recompressão que prejudicam a qualidade no pipeline de compressão do YouTube. Seja limpando um tutorial de 45 minutos ou turbinando uma demonstração de produto de 90 segundos, a conversa de edição permanece focada no seu conteúdo, não nos menus do software.
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 em 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):
# Gerar ou ler 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; token expira em 7 dias e pode ser revogado a qualquer momento em Configurações → Tokens de API em nemovideo.com. Se seu token expirar, solicite um novo com o mesmo X-Client-Id.
Persistência local: Este skill grava ~/.config/nemovideo/client_id para persistir o Client-Id entre sessões. Isso evita gerar um novo ID a cada requisiçã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. Roteando Solicitações Recebidas para o Endpoint Correto
Use a tabela abaixo para determinar qual endpoint lida com cada tipo de solicitação do usuário.
| Usuário diz... | Ação | Ignorar SSE |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 Estado | ✅ |
| "upload" / "上传" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar música de fundo…) | → §3.1 SSE | ❌ |
3. Sequências de Fluxo de Trabalho Principais
$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 do skill — NÃO codifique:
$SKILL_NAME= nome no frontmatter YAML deste arquivo$SKILL_VERSION= versão no 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 contém um diretório de plataforma conhecido (ex.:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Env
CRÍTICO: TODAS as requisições à API (incluindo render/export/upload/state/credits) DEVEM incluir estes cabeçalhos. Faltar com eles 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 Estabelecendo 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 ação de edição possa ocorrer, uma sessão deve ser inicializada com o backend. Este ID de sessão vincula todas as requisições subsequentes durante a tarefa de edição.
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 do Canal 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 de edição são transmitidas como Server-Sent Events (SSE) através de uma conexão persistente.
Tratamento SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução de 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: 10 min apenas heartbeats → assumir timeout. Nunca reenviar durante a geração (duplicatas + cobrança duplicada).
Ignore "Encontrei um problema temporário" no final se as respostas anteriores estavam 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 ausência de texto como erro ou falha, (2) consulte o endpoint de estado da sessão para confirmar o status da operação, (3) exiba uma mensagem de status neutra ao usuário como 'Sua edição está sendo processada' e (4) prossiga para a etapa de exportação assim que o estado confirmar a conclusão.
Geração em dois estágios: Após entregar o vídeo editado bruto, o backend inicia automaticamente um segundo estágio de processamento que insere música de fundo e gera uma sobreposição de título. Esses dois estágios são sequenciais e distintos — não tente acionar o segundo estágio manualmente nem tratar a saída bruta intermediária como o resultado final.
3.2 Gerenciando 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.
Suportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
O endpoint de upload aceita arquivos de vídeo enviados diretamente pelo usuário e retorna um ID de referência do arquivo para uso em requisições de edição subsequentes.
3.3 Verificando Créditos Disponíveis
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 Recuperando o Estado Atual da Sessão
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 principais: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Mapeamento de campos do draft: t=faixas, tt=tipo de faixa (0=video, 1=audio, 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 do resumo das faixas:
Linha do tempo (3 faixas): 1. Vídeo: timelapse da cidade (0-10s) 2. Música de fundo: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Acionando a Exportação e Entregando o Arquivo Final
Exportação NÃO custa créditos. Apenas geração/edição consomem créditos.
Exportar o clipe finalizado não deduz nenhum crédito do saldo do usuário. A sequência de exportação procede da seguinte forma: (a) confirme que o estado da sessão mostra uma edição concluída, (b) chame o endpoint de exportação com o ID da sessão ativa, (c) consulte o status do job de exportação até que ele retorne um estado concluído, (d) recupere a URL de download da resposta de exportação concluída e (e) apresente essa URL ao usuário como seu arquivo pronto para upload.
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 está em camelCase (exceção). Em caso de falha → novo id, tente novamente uma vez.
c) Consultar (a cada 30s, máximo de 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) Baixar de output.url → enviar ao 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 de uma Desconexão SSE
Se o stream SSE cair inesperadamente, siga estas etapas de recuperação: (1) tente imediatamente restabelecer a conexão SSE usando o ID de sessão existente, em vez de criar uma nova sessão, (2) consulte o endpoint de estado da sessão para determinar quanto da operação anterior foi concluída antes da desconexão, (3) se a operação já foi finalizada, prossiga diretamente para a exportação sem repetir a solicitação de edição, (4) se a operação ainda estava em andamento, retome a escuta no stream reconectado e aguarde o evento de conclusão e (5) notifique o usuário sobre a breve interrupção apenas se a tentativa de reconexão exceder um limite de tempo razoável.
4. Traduzindo Referências de GUI do Backend para o Usuário
O backend é construído em torno de uma interface gráfica e ocasionalmente fará referência a elementos de UI em suas respostas — nunca repasse essas instruções específicas de GUI diretamente para o 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 das faixas |
| "Export button" / "导出" | Executar §3.5 |
| "check account/billing" | Verificar §3.3 |
Mantenha as descrições de conteúdo. Remova as ações de GUI.
5. Padrões de Conversação Recomendados
• Confirme o que o usuário deseja realizar antes de iniciar qualquer chamada de API, especialmente para operações destrutivas como corte ou cisão. • Após cada etapa de edição ser concluída, resuma o que mudou em linguagem simples, em vez de expor detalhes técnicos internos. • Use frases curtas e diretas ao se comunicar com o usuário. • Se o usuário não especificar detalhes, faça perguntas direcionadas para esclarecer a intenção. • Ao lidar com múltiplos arquivos de vídeo, pergunte qual deles deve ser editado primeiro. • Ofereça sugestões de melhoria quando apropriado, como adicionar música de fundo ou ajustar a cor.