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