← Back to Skills Marketplace
471
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install stable-browser
Description
Set up reliable browser automation using Chrome DevTools Protocol (CDP) instead of the flaky browser extension relay. Use when browser relay keeps disconnect...
Usage Guidance
This skill appears coherent and implements what it promises, but review and consider the following before running:
- Inspect scripts before running: scripts/setup-cdp.sh is local and will create ~/.chrome-debug-profile, update ~/.openclaw/openclaw.json, and on macOS create/load ~/Library/LaunchAgents/com.openclaw.chrome-cdp.plist.
- Persistence: the LaunchAgent auto-starts Chrome at login (user-level). If you don't want that, skip the LaunchAgent step or remove the plist after setup.
- Profile/cookies: you will be asked to log into sites in the new profile; session cookies and tokens will be stored under ~/.chrome-debug-profile. Treat that directory as sensitive and back it up or delete it if you no longer need persistent sessions.
- Platform note: the included setup script assumes macOS Chrome path; on Linux/Windows you should follow the manual-setup instructions instead or edit the script to point to your Chrome binary.
- Process killing: the script uses pkill -f 'remote-debugging-port=9222' if port is in use; this may terminate other processes that were using that flag—verify before running on shared systems.
- Headless flags: the documentation shows using --no-sandbox for CI/headless. Be cautious: --no-sandbox reduces security and should only be used in controlled CI environments.
- Network exposure: the CDP endpoint is bound to 127.0.0.1 in these instructions (local only). Ensure you do not expose the debug port to other hosts if you want to keep it local.
If you're comfortable with the above and only want a dedicated, local CDP-backed browser for automation, this skill appears appropriate. If you need higher assurance, run the script line-by-line manually and verify the created files and LaunchAgent before enabling it.
Capability Analysis
Type: OpenClaw Skill
Name: stable-browser
Version: 1.0.0
The skill bundle is benign. It sets up a dedicated Chrome instance for OpenClaw's browser automation via the Chrome DevTools Protocol (CDP). The `scripts/setup-cdp.sh` script launches Chrome with a debug port, creates a dedicated user profile (`~/.chrome-debug-profile`), updates the local OpenClaw configuration (`~/.openclaw/openclaw.json`), and establishes a macOS LaunchAgent (or provides systemd instructions for Linux) to ensure Chrome auto-starts and persists. All actions, including file system modifications and persistence mechanisms, are explicitly stated in `SKILL.md` and are directly aligned with the skill's stated purpose of providing a stable browser connection. There is no evidence of data exfiltration, unauthorized remote execution, obfuscation, or prompt injection attempts to subvert the agent for malicious ends.
Capability Assessment
Purpose & Capability
The SKILL.md and setup script consistently implement a direct Chrome CDP setup for OpenClaw: creating a dedicated profile, launching Chrome with --remote-debugging-port, and updating ~/.openclaw/openclaw.json. Minor mismatch: the included setup script is macOS-centric (hard-coded Chrome path and creates a macOS LaunchAgent), while the documentation also documents Linux/Windows commands.
Instruction Scope
Instructions stay within the stated purpose: they launch Chrome, create a separate profile, update OpenClaw config, and optionally install an auto-start agent. They do not access unrelated system files or network endpoints beyond localhost. Be aware the script instructs the user to sign into sites in the new profile, which will persist cookies and session tokens in the created profile directory (~/.chrome-debug-profile).
Install Mechanism
No remote downloads or package installs. The skill is instruction-only with a local shell script; it writes files under the user's home (profile dir, OpenClaw config, LaunchAgents) and runs local commands only.
Credentials
No environment variables, secrets, or external credentials are requested. The script modifies user-local config and creates a Chrome profile (where the user may choose to log into accounts), which is proportionate to the stated functionality.
Persistence & Privilege
The script creates a per-user LaunchAgent (macOS) to auto-start Chrome and updates ~/.openclaw/openclaw.json. This is within scope for providing a persistent CDP endpoint, but it does grant persistent auto-start behavior—users should be aware and can opt out by not loading the LaunchAgent.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install stable-browser - After installation, invoke the skill by name or use
/stable-browser - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of stable-browser skill.
- Enables robust browser automation via Chrome DevTools Protocol (CDP), eliminating reliance on the flaky extension relay.
- One-step setup script creates a dedicated Chrome profile and configures direct CDP connection.
- Improves stability, eliminates WebSocket/port issues, and supports headless/headed automation for scraping, form filling, and more.
- Provides usage instructions and troubleshooting guidance for seamless migration from the extension relay.
Metadata
Frequently Asked Questions
What is Stable Browser?
Set up reliable browser automation using Chrome DevTools Protocol (CDP) instead of the flaky browser extension relay. Use when browser relay keeps disconnect... It is an AI Agent Skill for Claude Code / OpenClaw, with 471 downloads so far.
How do I install Stable Browser?
Run "/install stable-browser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Stable Browser free?
Yes, Stable Browser is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Stable Browser support?
Stable Browser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Stable Browser?
It is built and maintained by jarvis563 (@jarvis563); the current version is v1.0.0.
More Skills