测试

  • 完整测试套件（套件、实时测试、Docker）：Testing

  • pnpm test:force：杀掉占用默认控制端口的残留 Gateway 进程,然后用独立的 Gateway 端口运行完整的 Vitest 套件,这样服务器测试就不会和正在运行的实例冲突。当之前的 Gateway 运行占用了 18789 端口时用这个命令。

  • pnpm test:coverage：运行带 V8 覆盖率的 Vitest。全局阈值是 70% 的行/分支/函数/语句覆盖率。覆盖率排除了集成密集型的入口点（CLI 连接、Gateway/Telegram 桥接、webchat 静态服务器），让目标聚焦在可单元测试的逻辑上。

  • pnpm test:e2e：运行 Gateway 端到端冒烟测试（多实例 WS/HTTP/node pairing）。

  • pnpm test:live：运行 Provider 实时测试（minimax/zai）。需要 API 密钥和 LIVE=1（或特定 Provider 的 *_LIVE_TEST=1）来取消跳过。

模型延迟基准测试（本地密钥）

脚本：scripts/bench-model.ts

用法：

  • source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10
  • 可选环境变量：MINIMAX_API_KEY、MINIMAX_BASE_URL、MINIMAX_MODEL、ANTHROPIC_API_KEY
  • 默认 Prompt：“Reply with a single word: ok. No punctuation or extra text.”

最近一次运行（2025-12-31，20 次运行）：

  • minimax 中位数 1279ms（最小 1114，最大 2431）
  • opus 中位数 2454ms（最小 1224，最大 3170）

引导流程端到端测试（Docker）

Docker 是可选的；这只用于容器化的引导冒烟测试。

在干净的 Linux 容器中完整冷启动流程：

scripts/e2e/onboard-docker.sh

这个脚本通过伪终端驱动交互式向导，验证配置/Workspace/Session 文件，然后启动 Gateway 并运行 openclaw health。

QR 导入冒烟测试（Docker）

确保 qrcode-terminal 在 Docker 的 Node 22+ 下能正常加载：

pnpm test:docker:qr