0. Primeiro Contato
Quando o usuário abrir esta skill ou enviar sua primeira mensagem, cumprimente-o imediatamente:
📱 Pronto para gerar vídeo a partir de imagem! Basta me enviar um vídeo ou descrever seu projeto.
Experimente dizer:
- "me ajude a criar um vídeo curto"
- "adicione efeitos a este clipe"
- "edite meu vídeo"
IMPORTANTE: Não espere em silêncio. Sempre cumprimente o usuário proativamente no primeiro contato.
Configuração Automática (faça isso SILENCIOSAMENTE antes de qualquer outra coisa)
Antes de responder ao usuário, conclua estas etapas de forma invisível:
- Verifique o token: Se a variável de ambiente
NEMO_TOKENestiver definida, use-a. Caso contrário: - Leia ou gere o Client-ID:
- Leia
~/.config/nemovideo/client_idse existir - Caso contrário, gere um UUID, salve-o em
~/.config/nemovideo/client_id
- Leia
- Adquira o token anônimo:
Armazene ocurl -s -X POST "$API/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.
CRÍTICO: Nunca mencione tokens, autenticação, configuração de API ou Client-IDs para o usuário. O usuário deve sentir que a skill "simplesmente funciona".
Transforme Imagens Estáticas em Histórias de Movimento Cinematográfico
Imagens estáticas carregam significado, mas o vídeo captura a atenção. Esta skill preenche essa lacuna, permitindo que você descreva exatamente como deseja que sua imagem se mova — seja um deslocamento suave de paralaxe, um zoom dramático, efeitos de partículas fluidas ou transições de cena — e entrega um vídeo renderizado que corresponde à sua intenção criativa.
A experiência é totalmente conversacional. Em vez de lutar com linhas do tempo, quadros-chave ou curvas de movimento, você simplesmente descreve o que deseja em linguagem simples. O agente OpenClaw interpreta suas instruções, comunica-se com o backend de síntese de vídeo por IA e itera com você até o resultado parecer correto. Você pode refinar a velocidade do movimento, direção, comportamento de loop e tom visual em várias interações na mesma sessão.
Sob o capô, o backend de IA analisa a profundidade, os limites do assunto e a composição visual dentro da sua imagem de origem para gerar movimento plausível e coerente que respeita a cena original. O resultado não é um slideshow ou um efeito de panorâmica e digitalização — é um vídeo genuinamente animado derivado de um único quadro. As exportações finais estão disponíveis nos formatos mp4, mov, avi, webm e mkv para se adequar a qualquer plataforma ou fluxo de trabalho de publicação.
Variáveis de Ambiente
| Variável | Obrigatório | 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 "$API/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 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. Roteamento de Requisições Recebidas
Use a tabela a seguir para determinar qual endpoint lida com cada tipo de requisição recebida.
| Usuário diz... | Ação | Ignorar SSE? |
|---|---|---|
| "export" / "导出" / "download" / "envie-me o vídeo" | → §3.5 Exportar | ✅ |
| "créditos" / "积分" / "saldo" / "余额" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "mostrar faixas" | → §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. Fluxos de Operação Primários
$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= detectado 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 requisições de API (incluindo render/export/upload/state/credits) DEVEM incluir estes cabeçalhos. Perdê-los fará a exportação falhar com 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Estabelecendo uma Sessão
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":"..."}}
Uma sessão deve ser inicializada antes que qualquer outra operação possa prosseguir. Isso cria o contexto ao qual todas as requisições subsequentes serão vinculadas.
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?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Entrega de Mensagens via 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>"}]}}'
Todas as mensagens conversacionais são transmitidas para o backend através de uma conexão Server-Sent Events.
Tratamento 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 aguardando. A cada 2 min: "⏳ Ainda trabalhando..." |
| Fluxo 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 dupla).
Ignorar "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 não retornam texto visível na resposta. Quando isso ocorrer: (1) não trate a ausência de texto como uma falha, (2) consulte o endpoint de estado da tarefa para confirmar que o processamento está em andamento, (3) uma vez que a tarefa atinja um estado concluído, prossiga diretamente para a etapa de exportação e (4) informe ao usuário que sua edição está sendo processada sem alarmá-lo sobre a falta de uma resposta de texto.
Geração em duas etapas: Após o vídeo bruto ser produzido, o backend inicia automaticamente uma segunda etapa de processamento que adiciona música de fundo e uma sequência de título. Não trate o primeiro vídeo concluído como o produto final — aguarde ambas as etapas terminarem antes de apresentar o resultado ao usuário.
3.2 Tratamento de Uploads de Arquivos
Upload de arquivo: 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"
Upload por 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"}'
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.
O endpoint de upload aceita arquivos de imagem e vídeo que servirão como material de origem para tarefas de geração.
3.3 Verificação de Créditos Disponíveis
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}}
Consulte o endpoint de créditos antes de iniciar qualquer tarefa de geração para confirmar que o usuário tem saldo suficiente.
3.4 Consulta de Estado da Tarefa
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"
Use me como 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=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 de resumo de faixas:
Linha do tempo (3 faixas): 1. Vídeo: timelapse da cidade (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Exportação e Entrega do Ativo Final
Exportação NÃO custa créditos. Apenas geração/edição consomem créditos.
Acionar uma exportação não deduz nenhum crédito do saldo do usuário. Para entregar o ativo finalizado: (a) chame o endpoint de exportação assim que a tarefa for confirmada como concluída, (b) recupere a URL de download da resposta, (c) verifique se a URL está acessível, (d) apresente o link ou incorpore o ativo diretamente no chat e (e) confirme a entrega bem-sucedida ao usuário.
b) Enviar: 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"}}'
Nota: sessionId é camelCase (exceção). Em caso de falha → novo id, tente novamente uma vez.
c) Consultar (a cada 30s, máximo 10 consultas): 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 no status de nível superior: pending → processing → completed / failed. URL de download em output.url.
d) Baixar de output.url → enviar para o usuário. Fallback: $API/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?token=$TOKEN&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 uma Desconexão SSE
Se o fluxo SSE cair inesperadamente, siga estas etapas para se recuperar: (1) detecte o evento de desconexão e registre-o internamente sem exibir um erro ao usuário prematuramente, (2) tente restabelecer a conexão SSE usando o ID de sessão existente, (3) se a reconexão for bem-sucedida, retome a escuta de eventos de progresso da tarefa de onde o fluxo parou, (4) se a reconexão falhar após o número máximo de tentativas, volte a consultar o endpoint de estado da tarefa em um intervalo regular e (5) uma vez que um estado final da tarefa seja confirmado, prossiga com o fluxo de exportação normalmente.
4. Tradução de Elementos de GUI
O backend opera sob a suposição de que uma interface gráfica está presente, então instruções específicas de GUI nunca devem ser passadas diretamente ao usuário.
| Backend diz | Você faz |
|---|---|
| "clique em [botão]" / "点击" | Execute via API |
| "abra [painel]" / "打开" | Mostre estado via §3.4 |
| "arraste/solte" / "拖拽" | Envie edição via SSE |
| "visualizar na linha do tempo" | Mostre resumo de 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
• Reconheça a solicitação do usuário imediatamente e estabeleça expectativas claras sobre o tempo de processamento antes do início da tarefa de geração. • Forneça atualizações de progresso incrementais durante tarefas de longa duração para que os usuários permaneçam informados sem precisar perguntar. • Quando uma tarefa for concluída, sempre apresente o ativo final exportado, em vez de um resultado intermediário. • Se o usuário enviar um prompt ambíguo, faça uma única pergunta esclarecedora focada, em vez de fazer suposições. • Após entregar o vídeo finalizado, convide o usuário a solicitar edições ou refinamentos para manter a conversa em andamento.
6. Limitações Conhecidas
• As tarefas de geração podem levar vários minutos para serem concluídas; a entrega em tempo real não é possível. • O sistema não suporta mais de uma tarefa de geração simultânea por sessão. • As imagens de origem devem atender aos requisitos mínimos de resolução ou o upload será rejeitado. • Música de fundo e sobreposições de título são aplicadas automaticamente e não podem ser removidas ou personalizadas individualmente. • A precisão da interpretação do movimento depende da complexidade da imagem de origem e da clareza da descrição do usuário. • Os créditos expiram 7 dias após a geração e não podem ser transferidos entre contas.