Tests

这页说明书主要讲的是怎么用不同的“咒语”来测试我们的“积木城堡”。这些“咒语”都是 pnpm test 开头的，就像不同的游戏关卡一样。

1. pnpm test:force 这个咒语是“强力清洁工”。有时候，上一个游戏没关好门（端口被占用），它就会先帮忙把门关上（结束占用的进程），然后再开始认真地检查所有积木（运行完整的测试套件）。
2. pnpm test:coverage 这个咒语是“覆盖率检查员”。它会数一数，我们写的积木说明书（代码）有多少被实际测试到了。它要求至少70%的积木都被检查过才算合格哦！不过，一些特别大的、负责连接外部的积木（如CLI、网关桥接）不参加这个计数，这样目标更明确。
3. pnpm test 这是最常用的“快速检查”咒语。在 Node 24 以上的版本，它会自动用一种更安全的方式（用 forks 而不是 vmForks）来避免一些错误。你也可以用 OPENCLAW_TEST_VM_FORKS=0 或 1 来告诉它用哪种方式。
4. 其他检查咒语 我们还有专门检查不同部分积木的咒语：
   • pnpm test:channels： 检查“频道”相关的积木。
   • pnpm test:extensions： 检查“插件”和“扩展”积木。
   • 如果想连“网关”（一个重要的通信中心）一起检查，需要念 OPENCLAW_TEST_INCLUDE_GATEWAY=1 pnpm test 或者 pnpm test:gateway。
   • pnpm test:e2e： 这是“端到端”大检查，模拟真实用户从头到尾玩一遍。你可以用 OPENCLAW_E2E_WORKERS=<数字> 告诉它用几个小帮手一起检查，用 OPENCLAW_E2E_VERBOSE=1 让它说得更详细。
   • pnpm test:live： 这是“真实世界”检查，需要连接真正的AI服务商（比如minimax）。你需要准备好“钥匙”（API Keys），并告诉它 LIVE=1，它才会进行这个检查。

在提交作品前的完整检查清单 如果你想确保你的新积木搭得很好，可以按顺序念这些咒语：pnpm check -> pnpm build -> pnpm test -> pnpm check:docs。如果 pnpm test 因为电脑太忙而失败，可以再试一次。如果电脑内存小，可以念 OPENCLAW_TEST_PROFILE=low OPENCLAW_TEST_SERIAL_GATEWAY=1 pnpm test 来温柔地检查。

测测AI说话快不快（速度比赛） 有一个脚本可以比赛，看哪个AI模型回答“ok”这个词更快。你需要先准备好它们的钥匙（API Key），然后念：source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10。上次比赛（2025年底），minimax 中位数是1279毫秒，opus 是2454毫秒。

测测程序启动快不快 另一个脚本专门测“启动速度”。念 pnpm tsx scripts/bench-cli-startup.ts 就可以测几个常用命令（比如 --version, --help）从开始到结束花了多长时间，并告诉你平均时间、最快和最慢时间。

用“集装箱”（Docker）做完整的新手检查 这就像在一个全新的、干净的玩具箱里，从头开始搭积木并检查。只需要念一个咒语：scripts/e2e/onboard-docker.sh，它就会自动完成所有新手步骤，并检查最后城堡是否健康。

检查二维码导入 最后一个检查是确保在“集装箱”（Docker）里，生成二维码的功能是好的。念 pnpm test:docker:qr 就行。