Camofox Browser
A REST API and OpenClaw plugin around Camoufox, designed to give agents a stealthier Firefox-based browser, compact accessibility snapshots, stable element references, isolated sessions, and deployment-friendly controls.
github.com/jo-inc/camofox-browser ↗What it does
- C++-level spoofing via Camoufox for WebGL, AudioContext, screen geometry, WebRTC, hardware concurrency, and related fingerprint surfaces.
- Agent-oriented snapshots with stable
e1/e2references; the project claims roughly 90% less text than raw HTML. - Click, type, press, scroll, navigate, wait, links, images, downloads, screenshots, structured extraction, and history navigation.
- Per-user session isolation, cookie import, persisted storage state, Playwright traces, proxies with GeoIP alignment, and VNC login support.
- Search macros and YouTube transcript extraction through optional
yt-dlp.
Best fit / watch-outs
- Best for: self-hosted browsing agents, authenticated research, compact page interaction, and sites hostile to stock headless browsers.
- First npm install downloads a Camoufox binary of roughly 300 MB.
- Anti-detection is an arms race; “bypass” is a project claim, not a permanent guarantee.
- Crash/hang telemetry is enabled by default, anonymized, and sent to an auditable Cloudflare Worker; disable with
CAMOFOX_CRASH_REPORT_ENABLED=false. - Use
CAMOFOX_ACCESS_KEYfor any exposure beyond loopback. Cookie import is separately gated byCAMOFOX_API_KEY.
Fastest start
# OpenClaw plugin
openclaw plugins install @askjo/camofox-browser
# Standalone
npx @askjo/camofox-browser
# http://localhost:9377 · OpenAPI: /openapi.json · Docs: /docs
API and deployment inventory
Tab lifecycle: create/list/stats/close tabs, close a group, or close all tabs for a user. Interaction: snapshot, click, type, keypress, scroll, navigate, wait, links, images, downloads, screenshot, back, forward, refresh, and schema-driven extract. Session APIs: cookie injection, storage-state export, trace listing/download/deletion. Server APIs: health, metrics, readiness, stop, and documentation.
Deployment: npm/source, Docker, Windows PowerShell build script, Fly.io guidance, and Railway configuration. Supports x86_64 and aarch64. Lazy startup and idle shutdown target about 40 MB while idle.
Notable limits: cookie files are sandboxed to a configured folder, capped at 5 MB and 500 cookies/request; traces default to 50 MB and 24-hour retention. Firefox-based Camoufox cannot use Playwright’s Chromium-only recordVideo, so the project uses richer Playwright trace archives instead.