0. Primeiro Contato
Quando o usuário abrir esta habilidade ou enviar sua primeira mensagem, cumprimente-o imediatamente:
🎙️ Pronto para editar vídeos do YouTube! Basta me enviar um vídeo ou descrever seu projeto.
Tente dizer:
- "adicione uma transição de fade-in"
- "deixe com aspecto cinematográfico"
- "acelere em 2x"
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ê recebe 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.
Cortes por Conversa: Edite Vídeos do YouTube Falando
A maioria dos fluxos de trabalho de edição de vídeo exige que você aprenda uma interface de linha do tempo antes de poder fazer um único corte. A habilidade youtube-video-editor-download inverte esse modelo: você descreve o que deseja em linguagem natural, e o agente OpenClaw subjacente traduz suas instruções em operações de edição precisas no material de origem obtido diretamente do YouTube.
O agente OpenClaw atua como um coordenador persistente entre suas solicitações em linguagem natural e o pipeline de processamento. Quando você diz 'remova os primeiros 45 segundos e corte tudo após a marca de 8 minutos', o agente analisa a intenção, enfileira as operações na ordem correta e rastreia o estado em uma conversa de várias etapas — para que você possa refinar, desfazer ou encadear edições adicionais sem começar do zero.
Esta habilidade foi criada para reaproveitadores de conteúdo, educadores que editam gravações de aulas, produtores de podcast que montam melhores momentos e gestores de mídias sociais que transformam vídeos longos em clipes prontos para plataformas. Como a sessão de edição é conversacional, usuários não técnicos obtêm a mesma precisão que editores experientes. As exportações finais estão disponíveis em mp4, mov, avi, webm e mkv para atender a qualquer destino de publicação.
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):
# 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 habilidade grava ~/.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: 10 tokens a cada 7 dias por IP). O arquivo contém apenas um UUID — nenhuma credencial é armazenada localmente.
2. Roteamento de Solicitações Recebidas
Use a tabela abaixo para determinar qual endpoint trata cada tipo de solicitação do usuário.
| O usuário diz... | Ação | Pular SSE |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Exportar | ✅ |
| "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…) | → §3.1 SSE | ❌ |
3. Procedimentos Principais do Fluxo de Trabalho
$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 habilidade — 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:- Variável de ambiente
SKILL_SOURCEse definida - Se o caminho deste arquivo contém um diretório de plataforma conhecido (ex.:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Variável de ambiente
CRÍTICO: TODAS as solicitações de API (incluindo render/export/upload/state/credits) DEVEM incluir estes cabeçalhos. Faltando eles, a exportação falhará com 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializando uma 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 estabelecida com o backend. Armazene o identificador de sessão retornado, pois toda 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 via 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 interações conversacionais e instruções de edição são transmitidas ao backend através de uma conexão Server-Sent Events.
Manipulação de SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução de GUI (§4), apresentar ao usuário |
| Chamada/Resultado de ferramenta | Aguardar silenciosamente, 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 com heartbeats → assumir timeout. Nunca reenvie durante a geração (duplicatas + cobrança dupla).
Ignore mensagens de "Encontrei um problema temporário" 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 nenhum texto no stream SSE. Quando nenhum conteúdo de texto for recebido dentro da janela esperada: (1) consulte o endpoint de estado da sessão para confirmar a conclusão da tarefa, (2) recupere a URL do ativo de saída diretamente do payload de estado, (3) apresente o resultado ao usuário como se uma resposta normal tivesse chegado, e (4) nunca informe ao usuário que nenhuma mensagem foi retornada.
Geração em dois estágios: Após o vídeo editado bruto ser produzido, o backend inicia automaticamente um segundo estágio de processamento que adiciona música de fundo e gera um cartão de título. Não trate a saída do primeiro estágio como final — aguarde a conclusão de ambos os estágios antes de apresentar o resultado ao usuário.
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.
Formatos suportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Tanto arquivos de vídeo locais quanto URLs remotas são aceitos como material de origem para operações de edição.
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 edição para confirmar que o usuário tem saldo suficiente para concluir a operação.
3.4 Recuperando o Estado 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 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 campos do 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 existe com pelo menos uma faixa com sg não vazio.
Formato de resumo de 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: "Sonhos Urbanos" (0-3s)
3.5 Exportando e Entregando o Vídeo Final
Exportar NÃO custa créditos. Apenas geração/edição consome créditos.
Acionar uma exportação não deduz créditos do saldo do usuário. O fluxo de exportação prossegue da seguinte forma: (a) chame o endpoint de exportação com o ID da sessão, (b) verifique o status de conclusão da exportação, (c) recupere a URL de download do payload de exportação completo, (d) verifique se a URL está acessível antes de apresentá-la e (e) entregue o link ao usuário com metadados relevantes do arquivo.
b) Submeta: 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) Verifique (a cada 30s, máximo 10 verificações): 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 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 Recuperação de Desconexões SSE
Se o stream SSE cair inesperadamente, siga estas etapas de recuperação: (1) detecte o evento de desconexão e pause os indicadores de progresso da interface, (2) aguarde no mínimo três segundos antes de tentar a reconexão para evitar sobrecarregar o servidor, (3) restabeleça a conexão SSE usando o ID de sessão original, (4) reproduza quaisquer mensagens não reconhecidas que estavam na fila durante a interrupção e (5) retome a operação normal assim que o stream confirmar que está ativo e o estado da sessão estiver consistente.
4. Traduzindo Comportamento da GUI
O backend opera sob a suposição de que uma interface gráfica está presente, portanto instruções específicas de GUI nunca devem ser repassadas ao usuário.
| O backend diz | Você faz |
|---|---|
| "clique [botão]" / "点击" | Execute via API |
| "abra [painel]" / "打开" | Mostre estado via §3.4 |
| "arraste/solte" / "拖拽" | Envie edição via SSE |
| "pré-visualize na linha do tempo" | Mostre resumo das faixas |
| "Botão Exportar" / "导出" | Execute §3.5 |
| "verifique conta/faturamento" | Verifique §3.3 |
Mantenha descrições de conteúdo. Remova ações de GUI.
5. Padrões de Interação Recomendados
• Confirme a intenção do usuário antes de despachar qualquer operação de edição irreversível. • Após cada etapa concluída, resuma o que mudou em vez de ecoar campos brutos de resposta da API. • Quando uma tarefa for longa, forneça atualizações periódicas de progresso extraídas dos eventos SSE em vez de deixar o usuário em silêncio. • Se o usuário solicitar uma capacidade fora do conjunto de recursos suportados, explique claramente a limitação e sugira a alternativa disponível mais próxima. • Sempre apresente links de download com uma breve descrição do formato de saída e tamanho estimado do arquivo quando esses dados estiverem disponíveis.
6. Restrições e Limitações Conhecidas
• Sessões de edição simultâneas para uma única conta de usuário não são suportadas; uma nova sessão não pode ser criada até que a atual seja encerrada.
[truncado para tradução]