Chuyển đến nội dung chính

​
Kiểm thử

  • Bộ công cụ kiểm thử đầy đủ (suite, live, Docker): Testing
  • pnpm test:force: Kills any lingering gateway process holding the default control port, then runs the full Vitest suite with an isolated gateway port so server tests don’t collide with a running instance. Use this when a prior gateway run left port 18789 occupied.
  • pnpm test:coverage: Chạy bộ kiểm thử unit với V8 coverage (thông qua vitest.unit.config.ts). 4. Ngưỡng toàn cục là 70% cho lines/branches/functions/statements. Coverage excludes integration-heavy entrypoints (CLI wiring, gateway/telegram bridges, webchat static server) to keep the target focused on unit-testable logic.
  • pnpm test trên Node 24+: OpenClaw tự động tắt Vitest vmForks và sử dụng forks để tránh lỗi ERR_VM_MODULE_LINK_FAILURE / module is already linked. Bạn có thể ép buộc hành vi bằng OPENCLAW_TEST_VM_FORKS=0|1.
  • pnpm test:e2e: Chạy các smoke test end-to-end của gateway (ghép cặp WS/HTTP/node đa instance). Mặc định dùng vmForks + worker thích ứng trong vitest.e2e.config.ts; điều chỉnh bằng OPENCLAW_E2E_WORKERS=<n> và đặt OPENCLAW_E2E_VERBOSE=1 để bật log chi tiết.
    1. pnpm test:live: Chạy các bài kiểm thử live của provider (minimax/zai). Requires API keys and LIVE=1 (or provider-specific *_LIVE_TEST=1) to unskip.

​
Benchmark độ trễ mô hình (khóa cục bộ)

Script: scripts/bench-model.ts Cách dùng:
  • source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10
  • Biến môi trường tùy chọn: MINIMAX_API_KEY, MINIMAX_BASE_URL, MINIMAX_MODEL, ANTHROPIC_API_KEY
  • Default prompt: “Reply with a single word: ok. No punctuation or extra text.”
Lần chạy gần nhất (2025-12-31, 20 lượt):
  • minimax median 1279ms (min 1114, max 2431)
  • opus median 2454ms (min 1224, max 3170)

​
Onboarding E2E (Docker)

Docker là tùy chọn; chỉ cần cho các smoke test onboarding chạy trong container. Luồng khởi động nguội đầy đủ trong một container Linux sạch: 
scripts/e2e/onboard-docker.sh
Script này điều khiển trình hướng dẫn tương tác qua pseudo-tty, xác minh các tệp config/workspace/session, sau đó khởi động gateway và chạy openclaw health.

​
Smoke test nhập QR (Docker)

Đảm bảo qrcode-terminal tải được dưới Node 22+ trong Docker: 
pnpm test:docker:qr