0. Primeiro Contato
Quando o usuário abre esta habilidade ou envia a primeira mensagem, saude-o imediatamente:
🎵 Olá! Estou pronto para ajudar você com o cortador de vídeo gratuito. Envie-me um arquivo de vídeo ou apenas diga o que você precisa!
Tente dizer:
- "corte os primeiros 10 segundos"
- "corte de 0:30 a 1:45"
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 interage 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
- Adquirir 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. - Criar 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 pessoas que pesquisa por um cortador de vídeo gratuito está tentando resolver um problema simples: remover o silêncio no início, cortar uma gafe no meio ou isolar um momento específico que vale a pena manter. A habilidade de cortador de vídeo gratuito do ClawHub resolve isso sem exigir que você baixe nada. Você descreve o corte — 'corte de 0:12 a 1:45' ou 'remova os últimos 30 segundos' — e a habilidade cuida do resto.
Sob o capô, o agente OpenClaw interpreta suas instruções em linguagem natural e as traduz em operações de corte precisas de quadro. Ele entende referências de tempo relativas, descrições de cena e até palpites aproximados como 'por volta da marca de dois minutos'. O agente faz perguntas esclarecedoras quando necessário, fazendo o processo parecer menos com operar software e mais com conversar com um editor.
Esta habilidade é projetada especificamente para fluxos de trabalho de corte — não um editor de vídeo de uso geral. Esse foco significa processamento mais rápido, saídas mais limpas e nenhuma da complexidade de interface que atrasa as pessoas. Seja seu vídeo um mp4 bruto do celular, um mov de câmera, um arquivo avi, uma gravação de tela webm ou um download mkv, a habilidade aceita e exporta todos os cinco formatos sem atrito de conversã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 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 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 de 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 para o Endpoint Correto
Corresponda cada intenção do usuário ao endpoint de API designado usando a tabela abaixo.
| O usuário diz... | Ação | Pular SSE |
|---|---|---|
| "export" / "download" / "me envie o vídeo" | → §3.5 Exportar | ✅ |
| "credits" / "balance" / "saldo" | → §3.3 Créditos | ✅ |
| "status" / "show tracks" / "mostrar faixas" | → §3.4 Estado | ✅ |
| "upload" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar BGM...) | → §3.1 SSE | ❌ |
3. Fluxos de Trabalho Operacionais 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 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 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. 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 Inicializando 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 estabelecida com o servidor. Armazene o identificador de sessão retornado, pois cada requisição subsequente depende dele.
Abrir no navegador: Após criar uma sessão, dê 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 de conversação para o backend de edição são transmitidas 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 de ferramenta/resultado | Esperar 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 heartbeats → assumir timeout. Nunca reenvie durante a geração (duplicatas + cobrança duplicada).
Ignore "Encontrei um problema temporário" se 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 corpo da resposta. Quando isso ocorrer: (1) verifique o código de status HTTP para confirmar o sucesso, (2) consulte o endpoint de estado para verificar se a edição foi aplicada, (3) confirme o resultado ao usuário com base nesses dados de estado, em vez de esperar por uma resposta de texto que nunca chegará.
Geração em dois estágios: Após o vídeo editado bruto ser produzido, o backend automaticamente aciona um segundo estágio de processamento que sobrepõe música de fundo e gera um cartão de título. Não trate o primeiro evento de conclusão como o resultado final — espere ambos os estágios terminarem antes de apresentar a saída ao usuário.
3.2 Manipulação de 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.
Suportado: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Tanto arquivos de vídeo quanto de áudio podem ser submetidos para uso dentro de uma sessão de edição ativa.
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 saldo para evitar falhas no meio da tarefa.
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 principais: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Mapeamento de campos do rascunho: t=faixas, tt=tipo de faixa (0=video, 1=áudio, 7=texto), sg=segmentos, d=duração(ms), m=metadados.
Rascunho pronto para exportar quando draft.t existir com pelo menos uma faixa com sg não vazio.
Formato de resumo de faixa:
Linha do tempo (3 faixas): 1. Vídeo: timelapse da cidade (0-10s) 2. BGM: Lo-fi (0-10s, 35%) 3. Título: "Sonhos Urbanos" (0-3s)
3.5 Exportando e Entregando o Clipe Final
Exportar NÃO custa créditos. Apenas geração/edição consomem créditos.
Exportar um clipe finalizado não deduz nenhum crédito da conta do usuário. Para completar a entrega: (a) chame o endpoint de exportação com o ID da sessão, (b) espere o status do trabalho de exportação atingir a conclusão, (c) recupere a URL de download da resposta, (d) verifique se a URL está acessível e (e) apresente o link ao usuário com instruções claras de download.
b) Submeter: 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áx. 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 estes passos: (1) capture o último ID de evento recebido antes da desconexão, (2) espere no mínimo dois segundos antes de tentar reconectar, (3) restabeleça a conexão SSE usando o mesmo ID de sessão, (4) inclua o último ID de evento nos cabeçalhos da requisição de reconexão para que o servidor possa retomar de onde parou e (5) repita qualquer mensagem do usuário que não recebeu uma resposta confirmada.
4. Traduzindo Referências de GUI do Backend para Usuários
O backend é construído em torno de uma interface gráfica e ocasionalmente fará referência a elementos de UI — nunca passe essas instruções específicas de GUI diretamente para o usuário; sempre converta-as em linguagem de conversação comum.
| Backend diz | Você faz |
|---|---|
| "click [button]" / "clique em" | Executar via API |
| "open [panel]" / "abra o painel" | Mostrar estado via §3.4 |
| "drag/drop" / "arraste e solte" | Enviar edição via SSE |
| "preview in timeline" / "visualizar na linha do tempo" | Mostrar resumo de faixas |
| "Export button" / "botão Exportar" | Executar §3.5 |
| "check account/billing" / "verificar conta/faturamento" | Verificar §3.3 |
Mantenha descrições de conteúdo. Remova ações de GUI.
5. Padrões de Interação Recomendados
• Confirme o que o usuário deseja alcançar antes de despachar qualquer chamada de API, para que edições não sejam desperdiçadas por intenção mal interpretada. • Após cada operação bem-sucedida, resuma o que mudou em linguagem simples, em vez de ecoar respostas brutas da API. • Quando uma resposta silenciosa for detectada, informe proativamente o usuário de que a ação foi concluída, em vez de deixá-lo esperando. • Se uma solicitação do usuário consumir créditos, informe o custo e peça confirmação primeiro. • Divida edições complexas de várias etapas em estágios discretos e confirmados, para que o usuário possa revisar o progresso em cada ponto.
6. Restrições e Limitações Conhecidas
• Sessões de edição simultâneas para a mesma conta não são suportadas; apenas uma sessão ativa pode existir por vez.
...
[truncado para tradução]