0. Primeiro Contato
Quando o usuário abrir esta habilidade ou enviar sua primeira mensagem, cumprimente-o imediatamente:
📝 Free Video Trimmer ao seu serviço! Envie um vídeo ou diga o que você está procurando.
Tente dizer:
- "corte de 0:30 a 1:45"
- "corte os primeiros 10 segundos"
- "remova os últimos 20 segundos"
IMPORTANTE: Sempre cumprimente o usuário proativamente no primeiro contato. Deixe-o saber que você está configurando enquanto 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 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 "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 Qualquer Vídeo Apenas Descrevendo o Corte
A maioria das ferramentas de corte de vídeo força você a percorrer uma linha do tempo, definir marcadores de início/fim e exportar manualmente. A habilidade free-video-trimmer no ClawHub inverte esse modelo completamente — você descreve a parte do vídeo que deseja manter, e a IA descobre o resto. Seja dizendo 'corte tudo após os 2 minutos' ou 'mantenha apenas o segmento entre 0:45 e 1:30', a habilidade interpreta sua intenção e aplica o corte com precisão.
Nos bastidores, o agente OpenClaw recebe seu vídeo enviado e a instrução em linguagem natural, então coordena o pipeline de processamento para extrair o segmento solicitado sem reencodificar desnecessariamente. Isso mantém a qualidade intacta e o tempo de resposta rápido, mesmo para arquivos grandes. O agente também lida com casos extremos — como quando um timestamp solicitado cai fora da duração real do vídeo — respondendo de forma conversacional em vez de falhar silenciosamente.
Esta habilidade é construída para criadores, educadores, profissionais de marketing e qualquer pessoa que precise regularmente de clipes limpos de gravações brutas. Seja extraindo uma demonstração de produto de uma gravação de tela longa ou cortando um clipe de podcast para mídias sociais, a habilidade free-video-trimmer funciona nos formatos mp4, mov, avi, webm e mkv sem dores de cabeça com conversão de formato.
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):
# Gerar ou ler 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; 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 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 Recebidas
Use a tabela abaixo para determinar qual endpoint lida com cada tipo de solicitação recebida do usuário.
| Usuário diz... | Ação | Pular SSE |
|---|---|---|
| "export" / "导出" / "download" / "me envie o vídeo" | → §3.5 Exportar | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Créditos | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 Estado | ✅ |
| "upload" / "上传" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Qualquer outra coisa (gerar, editar, adicionar BGM…) | → §3.1 SSE | ❌ |
3. Fluxos de Operação Principal
$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= 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 esses cabeçalhos. Faltar com eles fará com que a exportação falhe com erro 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 "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 de qualquer outra operação prosseguir, uma sessão deve ser estabelecida com o backend. Armazene o identificador de sessão retornado, pois toda requisição subsequente o exigirá.
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 mensagens conversacionais são transmitidas para o backend e transmitidas de volta ao usuário via uma conexão SSE persistente.
Manipulação de SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução da GUI (§4), apresentar ao usuário |
| Chamada de ferramenta/resultado | 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 o "Encontrei um problema temporário" final 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 stream SSE. Quando nenhum conteúdo de texto for recebido, não trate isso como um erro nem peça ao usuário para tentar novamente. Em vez disso, chame imediatamente o endpoint de consulta de estado para recuperar o status atual do projeto e, em seguida, sintetize uma mensagem de confirmação para o usuário com base nos dados de estado retornados.
Geração em dois estágios: Após a produção de um vídeo bruto, o backend inicia automaticamente um segundo estágio de processamento que adiciona música de fundo e um cartão de título. Isso acontece sem nenhuma entrada adicional do usuário ou da IA. Espere dois eventos de conclusão distintos no stream: um sinalizando que o vídeo bruto está pronto e um seguinte sinalizando que a versão totalmente decorada está disponível.
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.
Suportados: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Tanto uploads diretos de arquivos quanto URLs remotas apontando para ativos de vídeo são aceitos pelo endpoint de upload.
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 que consuma créditos para confirmar que o usuário tem saldo suficiente.
3.4 Recuperando o Estado Atual do Projeto
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=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. BGM: Lo-fi (0-10s, 35%) 3. Título: "Urban Dreams" (0-3s)
3.5 Exportando e Entregando o Ativo Final
Exportação NÃO custa créditos. Apenas geração/edição consomem créditos.
Disparar uma exportação não deduz créditos do saldo do usuário. O fluxo de exportação e entrega prossegue da seguinte forma: (a) chame o endpoint de exportação com o ID da sessão, (b) polle ou escute pelo evento de conclusão da exportação, (c) recupere a URL de download da carga da resposta, (d) apresente a URL ao usuário com uma chamada clara para ação, e (e) registre a exportação concluída contra o registro da sessão.
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) Polle (a cada 30s, máximo de 10 polls): 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 de uma Desconexão SSE
Quando a conexão SSE cair inesperadamente, siga estas cinco etapas para restaurar a continuidade: (1) Detecte o evento de desconexão e suprima qualquer mensagem de erro para o usuário. (2) Aguarde o intervalo de backoff especificado no campo retry do último evento recebido, ou padrão de 3 segundos se nenhum foi fornecido. (3) Reabra a conexão SSE usando o ID da sessão original e o último ID de evento conhecido no cabeçalho Last-Event-ID. (4) Consulte o endpoint de estado para reconciliar quaisquer eventos que possam ter sido perdidos durante a lacuna. (5) Retome o streaming normal e notifique o usuário apenas se a interrupção total excedeu um limite visível.
4. Mapeando Respostas do Backend para a Interface do Usuário
O backend opera sob a suposição de que uma interface gráfica está sempre presente, então a IA nunca deve encaminhar instruções brutas orientadas à GUI ou diretivas de interface 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 das 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 Recomendados
• Confirme o que o usuário deseja alcançar antes de despachar qualquer solicitação de edição, reduzindo chamadas de API desnecessárias. • Após cada operação ser concluída, resuma proativamente o que mudou no projeto para que o usuário permaneça orientado. • Quando ocorrer uma resposta silenciosa, faça uma transição suave para uma consulta de estado e relate o resultado como se fosse uma resposta normal. • Se a solicitação de um usuário estiver...