测试
完整测试套件(套件、实时、Docker):测试
pnpm test:force:终止任何占用默认控制端口的残留网关进程,然后使用隔离的网关端口运行完整的 Vitest 套件,以便服务器测试不会与正在运行的实例冲突。当先前的网关运行占用了 18789 端口时使用此命令。pnpm test:coverage:使用 V8 覆盖率运行 Vitest。全局阈值为 70% 的行/分支/函数/语句覆盖率。覆盖率排除了集成密集型入口点(CLI 连接、网关/Telegram 桥接、网页聊天静态服务器),以保持目标专注于可单元测试的逻辑。pnpm test:e2e:运行网关端到端冒烟测试(多实例 WS/HTTP/节点配对)。pnpm test:live:运行提供商实时测试(minimax/zai)。需要 API 密钥和LIVE=1(或特定提供商的*_LIVE_TEST=1)才能取消跳过。
模型延迟基准测试(本地密钥)
用法:
source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10- 可选环境变量:
MINIMAX_API_KEY、MINIMAX_BASE_URL、MINIMAX_MODEL、ANTHROPIC_API_KEY - 默认提示:"Reply with a single word: ok. No punctuation or extra text."
最后运行(2025-12-31,20 次运行):
- minimax 中位数 1279ms(最小 1114,最大 2431)
- opus 中位数 2454ms(最小 1224,最大 3170)
入门引导 E2E(Docker)
Docker 是可选的;这仅用于容器化的入门引导冒烟测试。
在干净的 Linux 容器中的完整冷启动流程:
bash
scripts/e2e/onboard-docker.sh此脚本通过伪终端驱动交互式向导,验证配置/工作空间/会话文件,然后启动网关并运行 openclaw health。
QR 导入冒烟测试(Docker)
确保 qrcode-terminal 在 Docker 中的 Node 22+ 下加载:
bash
pnpm test:docker:qr