A diagnostic and recovery utility designed to fix browser tool timeouts and port conflicts within the OpenClaw environment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-browser-recover
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-browser-recover using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenClaw Browser Recover?
The OpenClaw Browser Recover skill is an essential maintenance tool for developers using AI agents for web-based tasks. It provides a structured methodology to diagnose and repair connection failures between the AI agent and the browser gateway, specifically targeting port conflicts on 18789, 18791, and the Chrome DevTools Protocol port 9222. By leveraging this component of Openclaw Skills, users can prevent unnecessary retries and restore automation stability when the MCP connection closes or the browser tool stops responding.
OpenClaw Browser Recover Use Cases
- Resolving browser tool timeout errors that suggest restarting the gateway.
- Fixing MCP Connection closed errors during active browser automation sessions.
- Troubleshooting Port 9222 in use conflicts when multiple Chrome profiles are active.
- Diagnosing failures to start the OpenClaw browser tool in local or remote environments.
How OpenClaw Browser Recover Works
- The skill initiates a brief cooldown period of 20-30 seconds to allow transient network or process locks to clear naturally.
- It performs a system-level check of gateway status and scans for active listeners on critical ports like 18789 and 9222.
- Lightweight probes are sent to the browser status and tab tools to identify if the issue is restricted to a specific user profile.
- If failures persist, the skill executes a sequence of recovery actions, starting with a gateway restart and escalating to user-guided Chrome reboots.
OpenClaw Browser Recover Setup
To begin using the recovery tools provided by Openclaw Skills, you can verify your environment with the following commands:
# Check gateway status
openclaw gateway status
# Check for port conflicts on 18789, 18791, and 9222
ss -lntp | egrep '(:18789|:18791|:9222)' || true
# Run the automated healthcheck script
bash skills/openclaw-browser-recover/scripts/healthcheck.sh
OpenClaw Browser Recover Data Schema & Taxonomy
The skill interacts with the following port and profile configuration schema to manage browser states:
| Component | Default Port | Profile | Dependency |
|---|---|---|---|
| Gateway | 18789 | N/A | OpenClaw Core |
| Browser Control | 18791 | user/openclaw | Gateway Service |
| Chrome CDP | 9222 | user | Local Chrome Instance |
| OpenClaw CDP | 9222 | openclaw | Internal Browser Process |
OpenClaw Browser Recover Advanced Features
- Intelligent port conflict detection to identify which specific process is blocking the Chrome DevTools Protocol.
- Automated gateway restart logic that prevents redundant stop/start loops.
- Profile-specific troubleshooting that distinguishes between user-managed Chrome instances and agent-managed browser sessions.
- Pre-formatted user communication templates to guide manual intervention when automated recovery is not possible.
SKILL.md
Loading
Related Openclaw Skills
Novada Search
A versatile multi-engine AI search platform designed for intelligent agent consumption and deep web research.
GTM Inbound Strategy
A strategic framework for designing automated lead routing logic, PLG activation flows, and ICP-based triage systems to align marketing and sales.
CCTV Video Hot Trends Analysis
A professional tool for extracting and summarizing performance data from public CCTV video columns and trending rankings.
IPO Market Monitor Skill
An automated tracker for IPO dynamics across seven major global stock exchanges with real-time Feishu integration.
BOSS Zhipin Hot Trend
A specialized skill for analyzing public job listings and company data on BOSS Zhipin to extract market trends and requirements.
AMap Location
A comprehensive mapping integration for Openclaw Skills that enables route planning, POI discovery, and coordinate conversion via the AMap API.
Featured*
