cli

一条命令把端到端测试搬进终端和 CI

开源 🏷️基础免费，高级付费 ✅ 目前可打开自动化工作流 🍴 复刻 140 🐛 待处理 16 👀 关注 10

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 3459

维护状态活跃

是否开源开源

定价模式 🏷️基础免费，高级付费支持限时试用 · 开源CLI免费，QA Wolf云服务提供付费方案，定价信息待确认

项目预览

项目数据

分类自动化工作流

开发团队qawolf

官网地址https://docs.qawolf.com/libraries/cli/api-reference

GitHubhttps://github.com/qawolf/cli

定价模式🏷️基础免费，高级付费

价格说明开源CLI免费，QA Wolf云服务提供付费方案，定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型automation,cli,e2e,end-to-end-testing,playwright,qa,qawolf,test-automation,testing

GitHub 星标★ 3459

上线时间2019-09-17 00:00:00

代码更新2026-11-05

仓库体积4.3 MB

本站数据更新2026-11-06

维护状态活跃

收录时间2026-09-22

浏览次数2

项目介绍

QA Wolf 官方命令行工具，把端到端测试能力从网页控制台搬到任何地方：本地终端、CI 流水线，甚至 AI Agent。它基于 Playwright 封装，用一条命令即可创建、运行、调试浏览器测试，自动生成可读的测试步骤和失败截图/视频，并把结果回传到 QA Wolf 云端做统一管理与告警。核心解决的是 E2E 测试门槛高、脚本维护难、CI 集成繁琐的问题：无需手写复杂 Playwright 代码，也不用自建测试基础设施，就能获得稳定的跨浏览器回归测试。支持在流水线中按需触发、并行执行，并通过 API 与 AI 工具链对接，让自动化测试成为开发流程中的常规动作而非额外负担。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 3459

技术标签

automation cli playwright qa test-automation

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 20.19+（推荐 Node 22+）
npm / pnpm / yarn / bun 任一包管理器
一个 QA Wolf 账号（在 qawolf.com 注册）
环境 ID（<env-id>），来自 QA Wolf 控制台 Settings → Environments

安装与启动步骤

1检查 Node 版本

CLI 要求 Node 20.19+，README 建议尽量使用 Node 22 及以上版本，请先确认本机 Node 版本。
```
node -v
```
2全局安装 CLI

通过 npm 全局安装 @qawolf/cli，也可改用 pnpm add -g、yarn global add 或 bun add -g。
```
npm install -g @qawolf/cli
```
3免安装试用

不想安装时可直接用 npx 运行，先看帮助信息确认命令可用。
```
npx @qawolf/cli --help
```
4下载独立二进制

没有 Node 环境时，可从 GitHub Release 下载预编译二进制，按系统选择对应文件名。
```
curl -fsSL -o qawolf https://github.com/qawolf/cli/releases/latest/download/qawolf-darwin-arm64
chmod +x qawolf && ./qawolf --help
```
5登录 QA Wolf

使用账号登录以获取凭证；CI 环境可跳过此步，改为设置 QAWOLF_API_KEY 环境变量。
```
qawolf auth login
```
6拉取 flows 缓存

把团队 flows 拉到本地 .qawolf/<env> 缓存目录；flows run 在缓存缺失时也会自动拉取。
```
qawolf flows pull --env <env-id>
```
7运行 flows

从本地缓存执行 flows，并按其需要安装运行时依赖；如需不依赖平台本地编写 flow，先跑 qawolf init。
```
qawolf flows run --env <env-id>
```

关键配置

配置项	必填	说明	示例
`QAWOLF_API_KEY`	否	CI 环境下代替 qawolf auth login 的认证密钥	`sk-xxxxxxxx`
`--env`	是	指定运行/拉取哪个环境的 flows，值来自控制台 Environments	`<env-id>`
`apiKey`	否	Runner SDK 创建实例时传入的 API 密钥	`sk-xxxxxxxx`

如何确认成功

执行 qawolf --help 能看到命令帮助；执行 qawolf flows run --env <env-id> 后 flows 正常执行并返回结果。

常见问题

Q：没有 QA Wolf 账号可以用吗？

A：不能，需要先在 qawolf.com 注册账号，并从控制台 Settings → Environments 获取 <env-id> 后再运行 flows。

Q：CI 里怎么认证？

A：不要用 qawolf auth login，改为在 CI 中设置 QAWOLF_API_KEY 环境变量即可完成认证。

Q：本地没有 flows 缓存会怎样？

A：qawolf flows run --env 会自动先拉取 flows 并安装所需运行时依赖；也可手动执行 qawolf flows pull --env <env-id> 刷新缓存。

Q：不想安装 Node 怎么办？

A：可从 GitHub Release 下载独立二进制，如 qawolf-linux-x64、qawolf-darwin-arm64、qawolf-windows-x64.exe，无需 Node.js。

Q：Runner SDK 中失败如何判断？

A：ok:false 表示传输或认证失败；若 runner 拒绝请求则返回 ok:true 且 value.outcome 为 failure，并带 failureReason。

注意事项

Node 20 已于 2026-04-30 EOL，仅对仍锁定 Node 20 的环境保留支持。
本 CLI 只在本地运行和管理 flows；flow 创建、AI 生成测试、云端托管执行与团队协作属于完整 QA Wolf 平台。
Runner SDK 通过 import { createRunnerSdk } from "@qawolf/cli/runner-sdk" 使用，每个动词都会明确指定 runner，不会隐式启动或计费。