camoufox-deploy

What This Skill Does

The camoufox-deploy skill is an automated provisioning tool designed to integrate the powerful Camoufox anti-detection browser with the agent-browser automation framework. By default, agent-browser is hardcoded for Chromium-based environments, which often triggers bot detection mechanisms on high-security websites like Bilibili or those protected by Cloudflare. This skill bridges that gap by patching the agent-browser source code to recognize Firefox/Camoufox executable paths and automating the entire Rust compilation and deployment pipeline. It ensures that users can leverage the fingerprint-masking capabilities of Camoufox while maintaining the programmatic control of the agent-browser ecosystem.

Installation

Installation is streamlined into a single command, though manual steps are provided for power users who require specific environment configurations:

1. Execute the installer: bash ~/.openclaw/workspace/skills/camoufox-deploy/scripts/install.sh.
2. The script will automatically install uv, fetch the Camoufox binary, install agent-browser, patch the browser.ts source files, and recompile the Rust CLI to ensure full compatibility.
3. Verify the installation by checking the versions and running the provided test path against your local Camoufox binary.

Use Cases

• Web Scraping: Bypassing sophisticated anti-bot challenges on modern web platforms.
• Automated Research: Conducting browsing tasks that require maintaining a low-profile footprint.
• Bot Development: Developing automation agents that remain undetected by standard WAF (Web Application Firewall) solutions.

Example Prompts

1. "OpenClaw, please run the camoufox-deploy script to set up my anti-detection browsing environment."
2. "Verify that my current agent-browser installation is correctly patched to support the Camoufox executable path."
3. "Run a browser automation test using the camoufox binary as the executable path for my current session."

Tips & Limitations

• Permissions: Ensure your shell environment has sufficient write permissions to global npm directories, as the skill performs system-level replacements.
• Rust Toolchain: You must have Rust installed via rustup to handle the recompilation step successfully if the pre-built binary does not match your specific architecture.
• Updates: Whenever you update the agent-browser package via npm, you may need to re-run the patch script, as updates typically overwrite custom source modifications.