0. Primeiro Contato
Quando o usuário abrir esta habilidade ou enviar sua primeira mensagem, cumprimente-o imediatamente:
📹 Youtube Video Editor Online ao seu serviço! Envie um vídeo ou me diga o que você está procurando.
Tente dizer:
- "deixe com aparência cinematográfica"
- "adicione uma transição de fade-in"
- "acelere 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 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 grátis. - Crie uma sessão (§3.0) para estar pronto para trabalhar imediatamente.
Avise o usuário brevemente: "Configurando… pronto!" então prossiga com a solicitação.
Edite Vídeos do YouTube Apenas Descrevendo o Que Você Quer
A maioria dos editores de vídeo exige que você aprenda linha do tempo, keyframes e predefinições de exportação antes de produzir um único quadro. A habilidade youtube-video-editor-online inverte esse modelo completamente. Você descreve o resultado desejado — 'corte os primeiros 8 segundos, adicione legendas em texto branco em negrito e exporte em 1080p' — e a habilidade cuida da execução técnica nos bastidores.
O agente OpenClaw atua como o coordenador inteligente entre suas instruções em linguagem natural e o pipeline de processamento subjacente. Ele interpreta a intenção, resolve ambiguidades (como perguntar qual segmento manter quando você diz 'a boa tomada') e sequencia as operações na ordem correta para que seu arquivo final esteja pronto para o YouTube sem intervenção manual.
Esta habilidade é especificamente construída para fluxos de trabalho do YouTube: ela entende convenções da plataforma como marcadores de capítulo, extração de frame de miniatura e o padrão de exibição 16:9. Esteja você limpando um vlog de cabeça falante, cortando um clipe de jogo ou montando uma resenha de produto a partir de várias tomadas, a habilidade se adapta ao seu tipo de conteúdo em vez de forçá-lo a um modelo de edição genérico. Os formatos de entrada aceitos incluem 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 grátis, 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):
# 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 de 10 tokens a cada 7 dias por IP). O arquivo contém apenas um UUID — nenhuma credencial é armazenada localmente.
2. Referência de Roteamento de Endpoint da API
A tabela abaixo mapeia cada operação para seu endpoint correspondente, método HTTP e requisito de autenticação.
| O usuário diz... | Ação | Pular SSE |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "上传" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar BGM…) | → §3.1 SSE | ❌ |
3. Fluxos de Trabalho de Operação Primária
$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= onamedo frontmatter YAML deste arquivo$SKILL_VERSION= oversiondo frontmatter YAML deste arquivo$SKILL_SOURCE= detectar em tempo de execução usando a primeira correspondência:- Env
SKILL_SOURCEse definido - Se o caminho deste arquivo contiver um diretório de plataforma conhecido (ex.:
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Env
CRÍTICO: TODAS as requisições de API (incluindo render/export/upload/state/credits) DEVEM incluir estes cabeçalhos. Faltar com eles fará a exportação falhar com 402.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Inicializar 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 edição possa começar, uma sessão deve ser estabelecida para obter um identificador de sessão único. Todas as requisições subsequentes dentro do mesmo contexto de edição devem referenciar este identificador.
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 Entregar 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>"}]}}'
As instruções do usuário são transmitidas ao backend como requisições SSE, que transmitem a resposta do assistente em tempo real.
Tratamento SSE
| Evento | Ação |
|---|---|
| Resposta de texto | Aplicar tradução de GUI (§4), apresentar ao usuário |
| Chamada/resultado de ferramenta | 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 reenvie durante a geração (duplicatas + cobrança dupla).
Ignorar "Encontrei um problema temporário" se as respostas anteriores estiverem 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, não trate isso como uma falha. Em vez disso: (1) confirme que a tarefa foi submetida com sucesso, (2) consulte o endpoint de estado da sessão para verificar se a edição foi aplicada, (3) recupere a linha do tempo atualizada e (4) resuma as alterações detectadas ao usuário como confirmação.
Geração em dois estágios: Quando o usuário solicitar uma saída de vídeo bruta, o backend enfileira automaticamente um segundo estágio de processamento que anexa música de fundo e um título de introdução. Comunique ambos os estágios ao usuário: primeiro notifique-o quando o corte bruto estiver pronto, depois notifique-o novamente quando a versão aprimorada com BGM e sobreposição de título for finalizada.
3.2 Tratamento de Upload de Ativos
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 ativos de imagem podem ser enviados diretamente através da API para uso na sessão de edição.
3.3 Verificação de Saldo de Créditos
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 para recuperar o saldo atual do usuário antes de iniciar qualquer operação que consuma créditos.
3.4 Recuperar Estado Atual 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; 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 rascunho: t=faixas, tt=tipo de faixa (0=video, 1=audio, 7=texto), sg=segmentos, d=duração(ms), m=metadados.
Rascunho pronto para exportação quando draft.t existir com pelo menos uma faixa com sg não vazio.
Formato do 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: "Sonhos Urbanos" (0-3s)
3.5 Renderizar, Exportar e Entregar o Vídeo Final
Exportar NÃO custa créditos. Apenas geração/edição consomem créditos.
Exportar o vídeo finalizado não deduz nenhum crédito do saldo do usuário. A sequência de exportação procede da seguinte forma: (a) chame o endpoint de exportação com as configurações de saída desejadas, (b) receba o ID do job de renderização na resposta, (c) consulte o endpoint de status do job até que o status retorne como concluído, (d) extraia a URL de download do payload do job concluído e (e) apresente o link de download ao usuário junto com o formato do arquivo e detalhes de resolução.
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 é 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 "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 para o usuário. Fallback: https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download.
e) Ao entregar o vídeo, sempre dê 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 Tratamento de Quedas de Conexão SSE
Se o stream SSE desconectar antes que uma resposta seja totalmente recebida, siga estas etapas de recuperação: (1) aguarde dois segundos antes de tentar qualquer ação para permitir que problemas de rede transitórios sejam resolvidos; (2) reconsulte o endpoint de estado da sessão para determinar se a operação foi concluída apesar da conexão perdida; (3) se o estado refletir a alteração esperada, trate a operação como bem-sucedida e informe o usuário; (4) se o estado não mostrar alteração, reenvie a requisição original usando o mesmo identificador de sessão; (5) se uma segunda desconexão ocorrer, exiba uma mensagem de erro ao usuário e recomende que ele verifique sua conexão de rede antes de tentar novamente.
4. Mapeamento de Elementos de GUI para Chamadas de API
O backend foi projetado com a suposição de que uma interface gráfica está presente, portanto, instruções ou referências específicas de GUI nunca devem ser encaminhadas literalmente em requisições de API.
| O 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 de faixas |
| "Export button" / "导出" | Executar §3.5 |
| "check account/billing" | Verificar §3.3 |
Manter descrições de conteúdo. Remover ações de GUI.
5. Padrões de Interação Recomendados
• Sempre confirme que a sessão está ativa e recupere o estado atual da linha do tempo antes de processar uma nova instrução do usuário. • Quando uma resposta SSE retornar vazia, confie na consulta de estado em vez de assumir que a operação falhou. • Traduza solicitações de edição em linguagem natural em parâmetros de API precisos; evite passar frases conversacionais...