Saltar para o conteúdo principal

​
Testes

  • Kit completo de testes (suites, live, Docker): Testing
  • pnpm test:force: Encerra qualquer processo de gateway remanescente que esteja segurando a porta de controle padrão e, em seguida, executa a suíte completa do Vitest com uma porta de gateway isolada para que os testes de servidor não colidam com uma instância em execução. Use isto quando uma execução anterior do gateway deixou a porta 18789 ocupada.
  • pnpm test:coverage: Executa o Vitest com cobertura V8. Os limites globais são 70% para linhas/branches/funções/statements. A cobertura exclui entrypoints com muita integração (wiring da CLI, bridges gateway/telegram, servidor estático do webchat) para manter o alvo focado em lógica testável por testes unitários.
  • pnpm test no Node 24+: o OpenClaw desativa automaticamente o vmForks do Vitest e usa forks para evitar ERR_VM_MODULE_LINK_FAILURE / module is already linked. Você pode forçar o comportamento com OPENCLAW_TEST_VM_FORKS=0|1.
  • pnpm test:e2e: Executa testes de smoke end-to-end do gateway (pareamento multi-instância WS/HTTP/node). O padrão é vmForks + workers adaptativos em vitest.e2e.config.ts; ajuste com OPENCLAW_E2E_WORKERS=<n> e defina OPENCLAW_E2E_VERBOSE=1 para logs detalhados.
  • pnpm test:live: Executa testes live de provedores (minimax/zai). Requer chaves de API e LIVE=1 (ou *_LIVE_TEST=1 específico do provedor) para desativar o skip.

​
Bench de latência do modelo (chaves locais)

Script: scripts/bench-model.ts Uso:
  • source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10
  • Env opcional: MINIMAX_API_KEY, MINIMAX_BASE_URL, MINIMAX_MODEL, ANTHROPIC_API_KEY
  • Prompt padrão: “Responda com uma única palavra: ok. Sem pontuação ou texto extra.”
Última execução (2025-12-31, 20 execuções):
  • minimax mediana 1279ms (mín 1114, máx 2431)
  • opus mediana 2454ms (mín 1224, máx 3170)

​
Onboarding E2E (Docker)

Docker é opcional; isto é necessário apenas para testes de smoke de onboarding em contêiner. Fluxo completo de cold-start em um contêiner Linux limpo: 
scripts/e2e/onboard-docker.sh
Este script conduz o assistente interativo via pseudo-tty, verifica arquivos de configuração/workspace/sessão e, em seguida, inicia o gateway e executa openclaw health.

​
Smoke de importação por QR (Docker)

Garante que qrcode-terminal carregue no Node 22+ em Docker: 
pnpm test:docker:qr