Webwright CLI与配置系统详解-c标志YAML配置叠加技巧完整指南【免费下载链接】WebwrightA simple SWE style browser agent framework that achieves SOTA results on long horizon web tasks.项目地址: https://gitcode.com/gh_mirrors/web/WebwrightWebwright 是一个轻量级 SWE 风格浏览器智能体框架让编码模型通过终端驱动浏览器完成长程 Web 任务。本文详解 Webwright CLI 命令行入口与 YAML 配置系统重点讲解如何用可重复的-c标志叠加多份配置文件、内联覆盖参数以及官方内置配置的推荐组合方式帮助新手一次配好模型、浏览器与输出目录。Webwright CLI 是什么约 150 行的极简入口Webwright 把智能体 浏览器 模型三件事全部收敛到一个命令行入口 src/webwright/run/cli.py 中。它的理念是终端是智能体唯一需要的东西——模型在终端里写 Playwright 脚本、执行、看截图、修 bug最终交付一个可重复运行的 Python 脚本。整个流程只需要一条命令python -m webwright.run.cli \ -c base.yaml -c model_openai.yaml \ -t Search for flights from SEA to JFK on 2026-08-15 to 2026-08-20 \ --start-url https://www.google.com/flights \ --task-id demo_openai \ -o outputs/default每次运行都会在输出目录生成轨迹trajectory.json、截图和调试产物方便事后复盘。运行完成后你可以用内置的轨迹查看器对比不同智能体框架在同一个任务上的执行轨迹与 token 消耗一键安装3 步准备好 Webwright CLI步骤 1获取代码并安装git clone https://gitcode.com/gh_mirrors/web/Webwright cd Webwright pip install -e . playwright install chromium步骤 2设置 API Key 环境变量根据你选择的模型后端设置对应密钥后端配置文件需要的环境变量OpenAImodel_openai.yamlOPENAI_API_KEYAnthropicmodel_claude.yamlANTHROPIC_API_KEYOpenRoutermodel_openrouter.yamlOPENROUTER_API_KEY步骤 3运行第一个任务使用上面的 Quick Start 命令即可。注意image_qa与self_reflection两个内置工具默认复用你配置的主模型所以 Claude 运行不需要额外提供 OpenAI 密钥。-c 标志与常用参数完整速查表Webwright CLI 的参数设计非常克制核心就 5 个标志说明-c配置文件可重复使用按顺序叠加-t自然语言任务描述--start-url起始页面地址--task-id输出子文件夹命名-o输出根目录--debug以有头模式启动浏览器打开开发者工具退出时保持窗口打开关键细节如果你完全不传-cCLI 会回退到默认组合base.yaml model_openai.yaml定义在 cli.py 中的DEFAULT_CONFIGS。这解释了为什么新手第一条命令就能跑起来。另外--debug不只是打开浏览器窗口——它会额外向合并配置里注入 headlessfalse、devtoolstrue、slow_mo_ms250 等一组调试开关非常适合排查选择器问题。YAML 配置叠加-c 标志的核心机制Webwright 配置系统的精髓是分层叠加stacking-c可以写多次每份 YAML 都会被完整解析后按顺序递归合并。合并逻辑实现在 src/webwright/utils/serialize.py 的recursive_merge函数中规则简单直观深度合并同名的字典节点逐键递归合并而不是整体覆盖后者胜出后出现的-c文件覆盖先出现文件的同名字段UNSET 哨兵被标记为 UNSET 的值跳过不会把前一层的有效值清空一个典型叠加顺序从左到右、优先级递增-c base.yaml ← 基础配置模型超时、提示词模板、智能体循环 -c local_browser.yaml ← 变体配置改用常驻本地浏览器 -c model_openai.yaml ← 模型修饰器指定 openai 后端与模型名官方内置的 7 份 YAML 配置全部位于 src/webwright/config/ 目录配置文件角色典型用途base.yaml基础层所有共享设置提示词模板、步骤上限 100、输出目录等model_openai.yaml模型修饰器指定 GPT 系模型与 OpenAI 端点model_claude.yaml模型修饰器指定 Claude 模型与 Anthropic 端点model_openrouter.yaml模型修饰器通过 OpenRouter 路由到任意模型local_browser.yaml运行模式变体驱动实时本地浏览器会话无需工作区工件persistent_browser.yaml运行模式变体每个步骤复用同一常驻 Chromium 子进程task_showcase.yaml交付物变体额外产出 task.json report.json 供仪表盘渲染crafted_cli.yaml交付物变体最终脚本必须是带 argparse 参数的可复用 CLI 工具推荐组合示例# 生成可复用 CLI 工具叠加 crafted_cli.yaml python -m webwright.run.cli \ -c base.yaml -c model_openai.yaml -c crafted_cli.yaml \ -t Search a red 2018-2023 Toyota Corolla on CarMax \ --task-id my_cli_task -o outputs/default # 生成 Task Showcase 仪表盘数据叠加 task_showcase.yaml python -m webwright.run.cli \ -c base.yaml -c model_openai.yaml -c task_showcase.yaml \ -t 可重复的 Web 任务 \ --task-id my_repeatable_task -o outputs/default 注意report.json只有在叠加了-c task_showcase.yaml时才会生成仅用 base.yaml 运行只会产出 trajectory.json 与调试产物。进阶技巧keyvalue 内联覆盖不用写文件除了传文件路径-c还支持keyvalue格式直接内联覆盖单个配置项值会被按.拆分成嵌套结构python -m webwright.run.cli \ -c base.yaml -c model_openai.yaml \ -c agent.step_limit60 \ -c environment.command_timeout_seconds300 \ -t Your task -o outputs/default这是临时调整超参数最省事的方式不用新建 YAML 文件一行命令即可完成覆盖且优先级最高。配置快照每次运行自动归档Webwright 对可复现性很较真。每次运行时src/webwright/config/init.py 中的snapshot_config_specs会把你传入的所有配置原样复制到输出目录的config_snapshot/下并生成两份元数据config_spec_manifest.json记录每层配置的来源与解析路径merged_config.yaml最终合并后的完整配置这意味着几个月后重跑或排查问题时你能精确还原当时的每一层叠加效果。对做评测的用户来说这是判断某次高分/低分到底跑在哪份配置上的可靠依据——下图就是 Webwright 在 Online-Mind2Web 基准上以 100 步预算取得的结果这类评测正是依赖配置快照来保证可复现的常见问题速答Q-c 的顺序有影响吗有。按书写顺序依次递归合并后面的文件覆盖前面的同名字段所以把最具体的变体放在最后。Q能用自己的 YAML 文件吗可以。-c优先按相对/绝对路径解析文件找不到时才回退到内置配置目录因此你可以完全自定义配置只需保证顶层键属于model/environment/agent/run四个命名空间即可。Q忘记 --debug 看不到浏览器窗口加--debug即以有头模式启动本地 Playwright同时自动开启 devtools、放慢到 250ms 并让浏览器在退出时保持打开。Q任务失败后去哪找线索查看输出目录下的 trajectory.json、final_runs/run_id/final_script_log.txt和 screenshots 文件夹配合config_snapshot/可完整还原运行现场。【免费下载链接】WebwrightA simple SWE style browser agent framework that achieves SOTA results on long horizon web tasks.项目地址: https://gitcode.com/gh_mirrors/web/Webwright创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考