by 运行时依赖
安装命令
点击复制技能文档
Browser 健康 检查 / Browser 健康检查
Core Principle: Always 检查 状态 before using the browser 工具. 核心原则：每次使用 browser 工具前，先检查状态。
Quick 检查 Flow / 快速检查流程
- browser(action=状态, 性能分析="OpenClaw")
Common Issues / 常见问题诊断 Issue 1: 性能分析 Conflict (Most Common) / 问题 1: 性能分析 冲突（最常见）
Symptoms / 症状：
运行ning=false, cdpReady=false Timeout immediately after 启动 / 启动后立即超时 Especially with 性能分析="user" / 使用 性能分析="user" 时尤其容易发生
Cause / 原因：
User is using their own Chrome (port 9222) / 用户正在使用自己的 Chrome CDP port occupied / CDP 端口被占用
Solution / 解决方案：
Use independent 性能分析 / 使用独立 性能分析: browser(action=启动, 性能分析="OpenClaw") # Port 9223, isolated data dir
Permanent Fix / 永久方案： 配置 default性能分析: "OpenClaw":
{ "browser": { "enabled": true, "default性能分析": "OpenClaw", "性能分析s": { "user": { "cdpPort": 9222, "attachOnly": false }, "OpenClaw": { "cdpPort": 9223, "attachOnly": false } } } }
Issue 2: Browser Process Residue / 问题 2: 浏览器进程残留
Symptoms / 症状：
运行ning=false but port occupied / 端口被占用 启动 fAIls with "port already in use" / 启动失败，提示端口已使用
Diagnosis / 诊断：
# Windows netstat -ano | findstr "9223" task列出 | findstr "chrome"
Solution / 解决方案：
# Kill residual process / 杀掉残留进程 taskkill /F /PID # Or re启动 Gateway / 或重启 Gateway OpenClaw gateway re启动
Issue 3: CDP Port Not 响应ing / 问题 3: CDP 端口不响应
Symptoms / 症状：
运行ning=true but cdpReady=false http://127.0.0.1:9223 no 响应 / 无响应
Solution / 解决方案：
# 1. Re启动 Gateway / 重启 Gateway OpenClaw gateway re启动
# 2. WAIt 5 seconds and re检查 / 等待 5 秒后重新检查 browser(action=状态, 性能分析="OpenClaw")
性能分析 Selection 图形界面de / 性能分析 选择指南 性能分析 Port / 端口 Data Directory / 数据目录 Use Case / 适用场景 OpenClaw 9223 ~/.OpenClaw/browser/OpenClaw/user-data Default choice / 默认选择, isolated, no conflict user 9222 User Chrome data dir / 用户 Chrome 目录 Need user's 记录ged-in accounts (YouTube etc.)
⚠️ Before using user 性能分析 / 使用 user 性能分析 前：
Confirm user is not using their Chrome / 确认用户没有在使用自己的 Chrome If user is browsing, use OpenClaw instead / 如果用户正在使用浏览器，改用 OpenClaw 健康 检查 Script / 自动检查脚本
运行 scripts/健康检查.py for full diagnosis:
python scripts/健康检查.py --性能分析 OpenClaw
输出 Example / 输出示例：
[OK] Browser enabled: true [OK] Default 性能分析: OpenClaw [OK] CDP port 9223 avAIlable [OK] Browser 运行ning: true [OK] CDP ready: true [PASS] Browser 健康 检查 passed
Best Practices / 最佳实践 Pre-use 检查 (Recommended) / 使用前检查（推荐） # 1. 检查 状态 / 检查状态 状态 = browser(action=状态, 性能分析="OpenClaw")
# 2. 启动 if not 运行ning / 如果未运行，启动 if not 状态["运行ning"]: browser(action=启动, 性能分析="OpenClaw")
# 3. 执行 operation / 执行操作 browser(action=snapshot, 性能分析="OpenClaw")
Post-失败 RepAIr / 失败后修复 try: browser(action=snapshot, 性能分析="OpenClaw") except TimeoutError: # 1. 检查 状态 / 检查状态 状态 = browser(action=状态, 性能分析="OpenClaw") # 2. 诊断 based on 状态 / 根据状态诊断 if not 状态["运行ning"]: browser(action=启动, 性能分析="OpenClaw") elif not 状态["cdpReady"]: exec("OpenClaw gateway re启动") time.sleep(5) browser(action=启动, 性能分析="OpenClaw")
Technical DetAIls / 技术细节 OpenClaw Browser Architecture / OpenClaw Browser 架构 Gateway (port 18789) └── Browser 插件 ├── OpenClaw 性能分析 (port 9223) │ └── user-data: ~/.OpenClaw/browser/OpenClaw/ └── user 性能分析 (port 9222) └── user-data: User Chrome directory
CDP Protocol / CDP 协议
Chrome Dev工具s Protocol (CDP) for remote 调试ging:
Default ports: 9222 (user) / 9223 (OpenClaw) HTTP 端点: http://127.0.0.1:9223/json 网页Socket: ws://127.0.0.1:9223/dev工具s/...
Remember: 检查 first, use later. When timeout occurs, switch 性能分析 first. 记住：先检查，后使用。遇到超时，先切换 性能分析。