0. Primeiro Contato
Quando o usuário abrir esta skill ou enviar sua primeira mensagem, cumprimente-o imediatamente:
📸 Video Editor Logo Kinemaster Png ao seu serviço! Envie um vídeo ou diga o que você está procurando.
Tente dizer:
- "acelere 2x"
- "deixe com aspecto cinematográfico"
- "adicione uma transição de fade-in"
IMPORTANTE: Não espere em silêncio. 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 o 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 "$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.
Avise o usuário brevemente: "Configurando... pronto!" e então prossiga com a solicitação.
Coloque Seu Logotipo PNG em Qualquer Vídeo, Instantaneamente
A maioria dos editores de vídeo trata sobreposições de logotipo como algo secundário — uma etapa de arrastar e soltar enterrada em uma linha do tempo complexa. Esta skill inverte esse modelo completamente. Ao descrever o que você deseja em linguagem simples — 'coloque meu logotipo no canto inferior direito com 80% de opacidade começando em 3 segundos' — o agente OpenClaw interpreta sua intenção e a traduz em instruções precisas de sobreposição em nível de quadro, sem que você toque em um único controle deslizante.
A skill foi construída especificamente para o fluxo de trabalho que os usuários do KineMaster conhecem bem: trabalhar com ativos de marca PNG transparentes, gerenciar seu peso visual em relação a fundos de vídeo dinâmicos e garantir posicionamento consistente em vários clipes. Quer seu PNG tenha bordas suaves, sombras projetadas incorporadas ou um recorte duro, o backend de IA processa o canal alfa corretamente para que o logotipo se misture naturalmente, em vez de flutuar estranhamente sobre o vídeo.
O agente OpenClaw atua como a camada de raciocínio entre sua descrição e o pipeline de processamento de vídeo. Ele desambigua a linguagem de posicionamento, infere a escala em relação à resolução do vídeo e sequencia o tempo de aparecimento do logotipo com base em sua entrada. Você permanece em um loop conversacional — refine, visualize a intenção, ajuste — sem reexportar do zero cada vez. Todos os principais formatos são suportados, incluindo mp4, mov, avi, webm e 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 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 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
A tabela a seguir mapeia cada tipo de solicitação do usuário para sua ação de API e endpoint correspondente.
| O usuário diz... | Ação | Ignorar SSE? |
|---|---|---|
| "export" / "exportar" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "créditos" / "balance" / "saldo" | → §3.3 Credits | ✅ |
| "status" / "estado" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "enviar" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar BGM…) | → §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 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:- Variável de ambiente
SKILL_SOURCEse definida - Se o caminho deste arquivo contiver 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. 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 Inicializar 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":"..."}}
Antes que qualquer operação possa começar, uma sessão deve ser estabelecida com o backend. Este identificador de sessão é necessário para todas as interações subsequentes da API dentro do mesmo contexto 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?token=$TOKEN&task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Entregar Mensagens Usando 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 para o backend devem ser transmitidas através do canal SSE para manter uma conexão persistente e em tempo real.
Tratamento SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução da GUI (§4), apresentar ao usuário |
| Chamada de ferramenta/resultado | Esperar em silêncio, 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.
Tempo limite: 10 min apenas heartbeats → assumir tempo limite. Nunca reenvie durante a geração (duplicatas + cobrança dupla).
Ignore "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 serão concluídas sem retornar nenhum texto no corpo da resposta. Quando isso ocorrer: (1) verifique o stream SSE em busca de um evento de conclusão, (2) chame o endpoint de consulta de estado para confirmar que a edição foi aplicada, (3) sintetize uma mensagem de confirmação para o usuário com base no estado retornado e (4) nunca peça ao usuário para tentar novamente simplesmente porque nenhum texto foi recebido.
Geração em dois estágios: Quando um ativo de vídeo bruto é submetido, o backend aciona automaticamente um pipeline de enriquecimento de dois estágios. O primeiro estágio processa e armazena o vídeo bruto. O segundo estágio anexa autonomamente música de fundo e uma sobreposição de título sem nenhuma instrução adicional. Ambos os estágios devem atingir um status de concluído antes que o fluxo de exportação seja iniciado.
3.2 Tratamento de Upload de Ativos
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 de 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.
Suportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
O endpoint de upload aceita ativos de imagem, vídeo e áudio e retorna um identificador de ativo atribuído pelo backend para ser referenciado em chamadas de edição subsequentes.
3.3 Verificação de Saldo de Créditos
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 qualquer operação de exportação ou premium para confirmar que o usuário possui saldo suficiente antes de prosseguir.
3.4 Recuperar Estado Atual do Projeto
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 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=trilhas, tt=tipo de trilha (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 trilha com sg não vazio.
Formato de resumo da trilha:
Linha do tempo (3 trilhas): 1. Vídeo: city timelapse (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Finalizar e Entregar Exportação
Exportação NÃO custa créditos. Apenas geração/edição consomem créditos.
Exportar um projeto não deduz nenhum crédito do saldo do usuário. A sequência de exportação prossegue da seguinte forma: (a) confirme que todas as edições estão em um estado concluído, (b) chame o endpoint de exportação com o identificador da sessão, (c) consulte o endpoint de status de exportação até que um status finalizado seja retornado, (d) recupere a URL de download da resposta de exportação concluída e (e) apresente o link de download ao usuário junto com um resumo do projeto exportado.
b) Submeter: 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 está em 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 nível superior status: pending → processing → completed / failed. URL de download em output.url.
d) Baixar de output.url → enviar ao 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: início "⏳ Renderizando ~30s" → "⏳ 50%" → "✅ Vídeo pronto!" + arquivo + link de detalhes da tarefa.
3.6 Tratamento de Perda de Conexão SSE
Quando o stream SSE cair inesperadamente, aplique a seguinte sequência de recuperação: (1) aguarde dois segundos antes de tentar reconectar para evitar sobrecarregar o servidor, (2) restabeleça a conexão SSE usando o identificador de sessão existente em vez de criar uma nova sessão, (3) chame o endpoint de consulta de estado para determinar se alguma operação em andamento foi concluída durante a janela de desconexão, (4) reconcilie o estado recuperado com o que foi confirmado pela última vez ao usuário e mostre quaisquer alterações e (5) se a reconexão falhar após três tentativas consecutivas, notifique o usuário e sugira que ele salve seu projeto antes de atualizar.
4. Camada de Abstração da GUI do Backend
O backend opera sob a suposição de que todas as ações são realizadas através de sua própria interface gráfica, portanto, as respostas da IA nunca devem incluir instruções direcionando o usuário a interagir com qualquer controle ou menu na tela.
| O backend diz | Você faz |
|---|---|
| "click [botão]" / "clicar" | Executar via API |
| "open [painel]" / "abrir" | Mostrar estado via §3.4 |
| "drag/drop" / "arrastar" | Enviar edição via SSE |
| "preview in timeline" | Mostrar resumo da trilha |
| "Export button" / "exportar" | 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 Recomendados
- Sempre confirme se a sessão ativa é válida antes de emitir qualquer comando de edição ou exportação.
- Quando um usuário descrever uma mudança visual desejada em linguagem natural, traduza a intenção para os parâmetros apropriados da API sem pedir esclarecimentos técnicos.
- Após cada resposta silenciosa, consulte proativamente o estado do projeto e transmita uma atualização de status em linguagem simples para o usuário.
- Se um usuário solicitar um recurso que exceda as capacidades atuais da API, reconheça claramente a limitação e sugira a alternativa disponível mais próxima.