0. Primeiro Contato
Quando o usuário abrir esta habilidade ou enviar sua primeira mensagem, saude-o imediatamente:
⚡ Pronto para o gerador de vídeo qwen ai! Basta me enviar um vídeo ou descrever seu projeto.
Tente dizer:
- "me ajude a criar um vídeo curto"
- "adicione efeitos a este clipe"
- "edite meu vídeo"
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 um 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ê recebe 100 créditos grátis. - Crie uma sessão (§3.0) para estar pronto para trabalhar imediatamente.
Avise o usuário brevemente: "Configurando… pronto!" em seguida, prossiga com a solicitação.
Criação de Vídeo Conversacional com a Inteligência Qwen
A habilidade qwen-ai-video-generator conecta o framework de agente OpenClaw do ClawHub ao modelo multimodal Qwen, permitindo uma abordagem fundamentalmente diferente para criação de vídeos. Em vez de arrastar clipes em uma linha do tempo, você descreve o que deseja — cenas, transições, ritmo, tom da narração — e o agente interpreta sua intenção e estrutura a saída de acordo. Isso significa menos tempo lutando com software de edição e mais tempo refinando sua mensagem real.
O agente OpenClaw atua como a camada de orquestração, traduzindo seus prompts conversacionais em tarefas de geração estruturadas que o Qwen processa quadro a quadro. Esteja você criando um passo a passo de produto, um vídeo explicativo educacional ou um clipe curto para redes sociais, o agente mantém o contexto durante toda a sessão, para que instruções de acompanhamento como 'diminua a introdução' ou 'adicione uma sobreposição de texto aos 10 segundos' sejam tratadas sem recomeçar.
Internamente, a habilidade lida com a codificação e negociação de formato automaticamente, para que seu resultado final seja entregue no formato de contêiner que se adequa à sua plataforma — mp4 para ampla compatibilidade, mov para pipelines profissionais, webm para entrega na web, ou avi e mkv para fluxos de trabalho de arquivamento e edição. Nenhuma transcodificação manual necessária.
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 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 "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. Roteando Solicitações de Entrada para o Endpoint Correto
Use a tabela abaixo para determinar qual endpoint da API deve lidar com cada tipo de solicitação do usuário.
| O usuário diz… | Ação | Pular SSE |
|---|---|---|
| "export" / "exportar" / "download" / "envie-me o vídeo" | → §3.5 Exportar | ✅ |
| "credits" / "créditos" / "balance" / "saldo" | → §3.3 Créditos | ✅ |
| "status" / "status" / "mostrar trilhas" | → §3.4 Estado | ✅ |
| "upload" / "enviar" / usuário envia arquivo | → §3.2 Upload | ✅ |
| Todo o resto (gerar, editar, adicionar BGM…) | → §3.1 SSE | ❌ |
3. Sequências de Fluxo de Trabalho 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= 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/exportar/upload/estado/créditos) 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 interação possa começar, uma sessão deve ser estabelecida com o backend. Armazene o identificador de sessão retornado, pois cada requisição subsequente dentro dessa conversa depende dele.
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 Através de uma Conexão 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 as respostas são recebidas através de um fluxo persistente de Eventos Enviados pelo Servidor (Server-Sent Events).
Tratamento de 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..." |
| 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 de heartbeats → assumir timeout. Nunca reenvie durante a geração (duplicatas + cobrança em dobro).
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 retornam um resultado concluído sem nenhum texto acompanhante no stream SSE. Quando nenhum conteúdo de texto for detectado na resposta, não trate isso como um erro nem peça ao usuário para tentar novamente. Em vez disso: (1) verifique o endpoint de status da tarefa para confirmar a conclusão, (2) recupere o ativo de saída diretamente e (3) apresente o resultado finalizado ao usuário normalmente.
Geração em dois estágios: Quando um vídeo bruto é produzido, o backend inicia automaticamente um segundo estágio de processamento que adiciona música de fundo e uma sobreposição de título. Sua integração deve considerar ambos os estágios: primeiro apresente o vídeo bruto ao usuário, depois aguarde o evento de conclusão do segundo estágio e atualize o resultado exibido quando a versão aprimorada estiver pronta.
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.
Suportado: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
A API aceita arquivos de mídia fornecidos pelo usuário, que devem ser enviados através do endpoint de upload designado antes de serem referenciados em qualquer solicitação de geração ou edição.
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 tarefa de geração para confirmar que o usuário tem saldo suficiente para cobrir a operação.
3.4 Consultando o Status da Tarefa
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 o 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=trilhas, tt=tipo de trilha (0=video, 1=audio, 7=texto), sg=segmentos, d=duração(ms), m=metadados.
Draft pronto para exportar quando draft.t existir com pelo menos uma trilha com sg não vazio.
Formato do resumo da trilha:
Linha do tempo (3 trilhas): 1. Vídeo: time-lapse 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
Exportar NÃO custa créditos. Apenas geração/edição consomem créditos.
Iniciar uma exportação não deduz nenhum crédito do saldo do usuário. A sequência de exportação prossegue da seguinte forma: (a) chame o endpoint de exportação com o identificador do ativo de destino, (b) receba o ID do job de exportação na resposta, (c) consulte o status do job até que o estado atinja a conclusão, (d) extraia a URL de download do payload do job concluído e (e) apresente a URL ou faça o download do arquivo para o usuário.
b) Envie: 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 é camelCase (exceção). Em caso de falha → novo id, tente novamente uma vez.
c) Consulte (a cada 30s, no 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) Baixe de output.url → envie 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 Reconectando Após uma Queda de SSE
Se a conexão SSE cair inesperadamente, siga estas cinco etapas para se recuperar de forma suave: (1) Aguarde no mínimo dois segundos antes de tentar reconectar, para evitar sobrecarregar o servidor. (2) Reabra o stream SSE usando o identificador de sessão original — não crie uma nova sessão. (3) Uma vez reconectado, consulte imediatamente o endpoint de status da tarefa para determinar se o processamento foi concluído durante a interrupção. (4) Se a tarefa tiver sido concluída, recupere o ativo de saída e apresente-o ao usuário como se o stream nunca tivesse caído. (5) Se a tarefa ainda estiver em andamento, retome a escuta no stream restaurado até que o evento de conclusão chegue.
4. Traduzindo Conceitos de GUI para o Backend
O backend opera sob a suposição de que todas as interações se originam de uma interface gráfica, portanto sua integração nunca deve encaminhar rótulos específicos de GUI, nomes de botões ou instruções de interface diretamente para a API.
| Backend diz | Você faz |
|---|---|
| "clique em [botão]" / "点击" | Execute via API |
| "abra [painel]" / "打开" | Mostre o estado via §3.4 |
| "arraste/solte" / "拖拽" | Envie edição via SSE |
| "visualize na timeline" | Mostre o resumo da trilha |
| "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
• Sempre confirme a intenção do usuário antes de despachar uma solicitação de geração que consumirá créditos. • Forneça atualizações incrementais de progresso exibindo eventos de stream SSE conforme eles a…
… [truncado para tradução]