cli

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

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

开源 freemium 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3450

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类自动化工作流

开发团队qawolf

所属国家

官网地址https://docs.qawolf.com

GitHubhttps://github.com/qawolf/cli

定价模式freemium

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

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

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

GitHub 星标★ 3450

30天Star增速

HF 下载量

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

最近更新2026-09-19 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-22

浏览次数0

使用教程

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

环境要求

Node.js 20.19+（推荐 Node 22+）
npm / pnpm / yarn / bun 任一包管理器
一个 QA Wolf 账号（在 qawolf.com 注册）
环境 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/ 缓存目录；flows run 在缓存缺失时也会自动拉取。
```
qawolf flows pull --env 
```
7运行 flows

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

关键配置

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

如何确认成功

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

常见问题

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

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

Q：CI 里怎么认证？

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

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

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

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，不会隐式启动或计费。

核心亮点

基于 Playwright 封装，无需手写复杂测试脚本即可创建并运行 E2E 测试
支持终端、CI 与 AI Agent 多入口，方便嵌入现有开发与自动化流程
测试结果可回传云端统一管理，附带截图、视频等失败现场信息

不足之处

深度依赖 QA Wolf 云端服务，纯本地/离线使用能力有限
作为官方 CLI，生态与社区插件丰富度不如通用测试框架

适用场景

本地开发时快速跑一遍关键流程回归测试
CI 流水线中按需触发端到端测试并查看失败现场
让 AI Agent 调用 CLI 自动执行和验证浏览器操作

替代项目

Playwright、Cypress、Selenium

项目介绍

cli 是自动化工作流领域的开源项目，由 qawolf 开发，2019 年首次发布。

在全站 12,909 个收录项目中，它的 GitHub 星标数（3,450）位列前 30%，在自动化工作流分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-19。开源CLI免费，QA Wolf云服务提供付费方案。

它主要面向的使用场景是：本地开发时快速跑一遍关键流程回归测试。同类可对比的替代方案包括 Playwright、Cypress、Selenium。

上一篇：Product-Manager-Skills

下一篇：Backlog.md

cli