快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: Node.js 18+，@playwright/mcp 使用 stdio（首次运行会下载 Chromium）
安装命令:
npx -y @playwright/mcp@latest验证提示词
打开 https://example.com，抓取页面快照，并返回主标题文字。
成功时应看到
应看到页面的可访问性快照与提取出的标题，而不是原始图片数据。
常见陷阱与修复
- ⚠️ 注意: 无头浏览器依赖，以及登录/弹窗/同意页的安全处理。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- 把页面内容当作不可信：不要让模型执行网页中嵌入的指令（提示词注入）。
- 自动登录用一次性/测试凭据，并尽量限制网络出口。
常见错误
浏览器安装
如果 Playwright MCP 启动后无法打开浏览器，先运行 npx playwright install chromium，并确认 OpenClaw 使用的是同一个 Node 环境。
Headless 模式
某些站点会根据 headless 环境改变行为。先用公开简单页面验证，再按需要切换 headless 设置或 user-agent 排查。
Timeouts
timeout exceeded 通常说明页面加载慢或选择器未出现。先验证网络和目标页面，再提高导航超时。
| 错误 | 原因 | 修复方法 |
|---|---|---|
Executable doesn't exist / browser not installed | Chromium 尚未下载。 | 执行一次 "npx playwright install chromium"，或允许首次运行完成下载。 |
Timeout exceeded | 页面过慢，或某个选择器一直未出现。 | 先用更简单的页面测试，必要时调高导航超时。 |
Tools do not appear | 修改配置后没有重启 host。 | 重新加载 OpenClaw，确认 playwright 工具已列出。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 打开 https://example.com，截取全页截图，并提取页面主标题。
- 进入测试表单页，填写输入框并提交，然后确认成功提示文字。
- 点击一个多步流程，逐步总结每一步页面发生了什么变化。
常见问题
Chromium 浏览器没有安装怎么办？
执行 "npx playwright install chromium" 一次，或允许首次运行自动下载完成。
headless 模式有什么注意事项？
headless 模式下某些站点行为不同。先用简单页面测试，必要时调整 user-agent 或禁用无头模式排查。
如何修复 timeout exceeded 错误？
页面过慢或选择器未出现。先用简单页面测试，然后按需提高导航超时。