What is CamoFox Browser?

CamoFox Browser is a headless browser automation server built specifically for AI agents. It is powered by Camoufox — a Firefox fork that performs fingerprint spoofing at the C++ engine level rather than fragile JavaScript patches.

This allows AI agents to visit real websites that typically block automation tools like Playwright or Puppeteer, including those protected by Cloudflare, Google, and other advanced bot detection systems.

It is the same browsing engine used behind the Jo AI assistant and integrates seamlessly with OpenClaw and other agent frameworks.

Key Features

C++-Level Anti-Detection: Spoofs navigator properties, WebGL, AudioContext, screen geometry, WebRTC, and more at the browser engine level for maximum undetectability.
Token-Efficient Snapshots: Returns accessibility tree snapshots (~90% smaller than raw HTML) + optional base64 screenshots.
Stable Element References: Uses reliable e1, e2, ... refs for clicking, typing, and interaction.
Session Isolation: Per-userId and sessionKey isolation with automatic expiry and tab recycling.
Proxy & GeoIP Alignment: Routes traffic through residential proxies with matching locale, timezone, and geolocation.
Cookie Import: Supports Netscape-format cookie injection for authenticated sessions (LinkedIn, Amazon, etc.).
Built-in Search Macros: @google_search, @youtube_search, @amazon_search, @reddit_subreddit, and more.
YouTube Transcript Extraction: Fast path via yt-dlp or browser fallback.
Low Resource Usage: ~40MB idle memory; lazy launch and idle shutdown. Runs on Raspberry Pi or cheap VPS.
Structured API: REST endpoints with JSON logging and request ID tracing.

Architecture

Browser powered by Camoufox
Isolated BrowserContext per user
Tab groups organized by sessionKey
Automatic idle shutdown and on-demand relaunch

Installation & Quick Start

Standalone

git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser
npm install
npm start

Server runs on http://localhost:9377. Camoufox (~300MB) downloads automatically on first run.

Docker

make up

Supports Fly.io, Railway, and multi-arch builds.

OpenClaw Integration

openclaw plugins install @askjo/camofox-browser

Usage Examples

Create a new tab

curl -X POST http://localhost:9377/tabs \
  -H "Content-Type: application/json" \
  -d '{"userId": "agent1", "sessionKey": "task1", "url": "https://example.com"}'

Get accessibility snapshot + screenshot

curl "http://localhost:9377/tabs/{TAB_ID}/snapshot?userId=agent1&includeScreenshot=true"

Click element by ref

curl -X POST http://localhost:9377/tabs/{TAB_ID}/click \
  -d '{"userId": "agent1", "ref": "e1"}'

Search with macro

curl -X POST http://localhost:9377/tabs/{TAB_ID}/navigate \
  -d '{"userId": "agent1", "macro": "@google_search", "query": "best wireless headphones"}'

Use Cases

AI agents that need reliable web browsing (research, shopping, social media, etc.)
Bypassing anti-bot protections on Cloudflare-protected or Google sites
Authenticated browsing with imported cookies
Token-efficient web interaction in long-running agent workflows
Integration with OpenClaw, Claude Desktop (via MCP), LangChain, and custom agents

Resources

GitHub: https://github.com/jo-inc/camofox-browser
Camoufox: https://camoufox.com
OpenClaw Integration: https://openclaw.ai
Documentation: https://jo-inc-camofox-browser.mintlify.app

CamoFox Browser is MIT licensed, actively maintained (latest release April 2026), and widely used for production AI agent web automation.