Playwright Headless Browser (Chromium)

核心用法

本技能为 Clawdbot 提供 Playwright Chromium 无头浏览器自动化配置方案，专为 WSL/Linux 环境设计。核心流程包括：通过 ./scripts/setup.sh 一键脚本自动安装 Playwright Chromium、安装 NSS/ALSA 等系统库依赖，并自动修补 Clawdbot 配置文件以启用浏览器工具。支持手动分步部署，包括查找 Chromium 可执行路径、配置 executablePath/headless/noSandbox 等关键参数。

显著优点

• 环境适配性强：专为 WSL/容器环境优化，内置 noSandbox: true 等必要参数
• 部署便捷：提供一键脚本与手动配置双模式，覆盖自动化与精细化需求
• 验证机制完善：包含命令行测试流程，确保 Chromium 正确运行
• 文档详尽：区分 Ubuntu/Debian 新旧版本依赖差异，提供兼容性方案

潜在缺点与局限性

• 权限依赖：系统库安装需 sudo，在受限环境中可能受限
• 版本碎片化：Chromium 路径随 Playwright 版本变化，需动态查找
• 平台局限：仅覆盖 Linux/WSL，未提及 macOS/Windows 原生方案
• 安全风险：noSandbox 和 disable-gpu 为便利性与安全性权衡，在不受信网页场景下存在潜在隐患

适合人群

WSL 用户、Linux 服务器管理员、需要 Clawdbot 浏览器自动化能力的开发者，尤其适合无 GUI 环境的 CI/CD 或远程开发场景。

常规风险

1. 供应链风险：Playwright 自动下载的 Chromium 二进制需信任 Microsoft 分发渠道
2. 提权操作：脚本执行涉及系统包管理器，需审查脚本内容防止恶意指令
3. 配置持久化：clawdbot config patch 修改全局配置，可能影响其他技能运行

核心功能

该 Skill 提供一站式 Playwright Chromium 浏览器配置方案，专为 WSL/Linux 环境设计。通过自动化脚本完成：Chromium 安装、系统依赖配置（libnss3/libasound2）、Clawdbot 浏览器工具集成，支持无头（headless）和有界面两种模式。

显著优势

• 开箱即用：单命令 ./scripts/setup.sh 完成全流程，无需手动查找 Chromium 路径
• 环境适配：内置 WSL/容器支持，自动配置 noSandbox 和 headless 参数
• 安全实践：脚本使用 set -euo pipefail，具备良好的错误处理和流程控制
• 来源可信：从 npm registry 和 Microsoft Playwright 官方源下载，无嵌套拉取风险

潜在局限

• 权限依赖：安装系统库需 sudo，且使用 --noconfirm 自动确认
• 无条件配置：noSandbox: true 对所有环境生效，非容器环境存在理论沙箱绕过风险
• 许可证缺失：未明确声明开源许可证，存在合规隐患
• 无卸载机制：未提供回滚脚本，恢复原始配置需手动操作

适用人群

• WSL 用户需在 Linux 子系统中运行浏览器自动化
• 使用 Clawdbot 进行网页抓取、自动化测试的开发者
• CI/CD 场景需要无头浏览器环境的 DevOps 工程师
• 不适合：对沙箱安全有严格要求的生产环境、无法授予 sudo 权限的受限系统

常规风险

1. 远程代码执行：下载并执行 Chromium 二进制文件（来源可信，单层加载）
2. 权限提升：sudo 安装系统依赖为功能必需，但脚本权限边界清晰
3. 配置持久化：修改 ~/.clawdbot/clawdbot.json，建议操作前备份