测试
- 完整测试套件（测试集、实时测试、Docker）：测试
-
pnpm test:force：终止任何占用默认控制端口的遗留 Gateway 网关进程，然后使用隔离的 Gateway 网关端口运行完整的 Vitest 套件，这样服务器测试不会与正在运行的实例冲突。当之前的 Gateway 网关运行占用了端口 18789 时使用此命令。 14. 当先前的网关运行导致端口 18789 被占用时使用此命令。 -
pnpm test:coverage：使用 V8 覆盖率运行单元测试套件（通过vitest.unit.config.ts）。 16. 全局阈值为行/分支/函数/语句 70%。 17. 覆盖率排除了集成较重的入口点（CLI 接线、gateway/telegram 桥接、webchat 静态服务器），以便将目标集中在可进行单元测试的逻辑上。 -
在 Node 24+ 上运行
pnpm test：OpenClaw 会自动禁用 Vitest 的vmForks并改用forks，以避免ERR_VM_MODULE_LINK_FAILURE/module is already linked。 你可以通过OPENCLAW_TEST_VM_FORKS=0|1强制指定该行为。 -
pnpm test:e2e：运行 Gateway 网关端到端冒烟测试（多实例 WS/HTTP/节点配对）。 在vitest.e2e.config.ts中默认使用vmForks+ 自适应 workers；可通过OPENCLAW_E2E_WORKERS=<n>调整，并设置OPENCLAW_E2E_VERBOSE=1以启用详细日志。 -
pnpm test:live：运行提供商实时测试（minimax/zai）。需要 API 密钥和LIVE=1（或提供商特定的*_LIVE_TEST=1）才能取消跳过。 20. 需要 API 密钥以及LIVE=1（或特定提供方的*_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 - 默认提示词：“Reply with a single word: ok. No punctuation or extra text.”
- minimax 中位数 1279ms（最小 1114，最大 2431）
- opus 中位数 2454ms（最小 1224，最大 3170）
新手引导 E2E（Docker）
Docker 是可选的；这仅用于容器化的新手引导冒烟测试。 在干净的 Linux 容器中完整的冷启动流程：openclaw health。
QR 导入冒烟测试（Docker）
确保qrcode-terminal 在 Docker 中的 Node 22+ 下加载：