Windows Support
Windows users can now build and run camofox-browser without WSL or make.
This release adds a PowerShell build.ps1 workflow, enforces LF line endings for shell scripts, and fixes Docker builds from Windows checkouts by invoking shell scripts through sh. Plugin loading also works correctly on Windows now: plugins are imported via file:// URLs instead of raw filesystem paths.
OpenClaw Compatibility
OpenClaw 2026.5.x requires packages to declare tool ownership in contracts.tools. camofox-browser now ships that manifest metadata, fixing tool registration failures in newer OpenClaw versions.
Cross-Origin Iframe Interaction
Accessibility snapshots now traverse supported iframes, and refs can resolve back into their owning frames. This makes embedded checkout/payment fields visible and clickable through the normal ref-based flow.
Tracking and analytics iframes are filtered out so snapshots stay focused on actionable page content.
Security Hardening
Several sensitive routes now require configured auth:
POST /tabs/:tabId/evaluateDELETE /sessions/:userIdPOST /pressure/cleanup
Cookie import now uses the shared auth middleware too. If you expose camofox-browser beyond loopback, verify your CAMOFOX_API_KEY / CAMOFOX_ACCESS_KEY setup before upgrading.
Production Reliability
This release pulls in reliability fixes from jo production usage:
- Idle shutdown no longer leaks orphaned Camoufox processes
- Browser close now force-cleans escaped child processes
- Health checks stay green after idle browser shutdown
- Stale tab errors are clearer and more recoverable
- Active tab operations refresh session access time so live sessions are not expired
- Popups from
target=_blankandwindow.openare tracked as managed tabs - Tab operations are better serialized with per-tab locks
- Navigation timeout cleanup avoids poisoning proxy-backed sessions
- YouTube transcript session cleanup handles races more safely
- Crash/stall reporter no longer treats
429relay responses as successful delivery
Fixes & Improvements
- Prometheus metrics are lazy-loaded and disabled by default unless explicitly enabled
- Snapshot size metrics added
- Navigate requests are aborted when their tab is deleted
- Retry-path
constreassignment crashes fixed - VNC plugin config is explicit and disabled by default
- Optional Sentry integration no longer prevents server startup when Sentry is not installed
Thank You
Thanks to:
- @kgarg2468 — OpenClaw contracts and Windows/Electron feedback
- @SirBrenton — reporter 429 handling
- @sebastiondev — auth hardening
- @Chen-538 — Windows plugin loading fix
- @dawsman — VNC config cleanup
- @pasmud — Windows build support