camofox-cloaked-browser

name	camofox-cloaked-browser
description	Use Camofox/Camoufox as an opt-in anti-detection browser server for agent workflows that need cloaked browsing. Covers npm/npx startup, OpenClaw plugin tools, REST API commands, session/tab workflow, environment variables, process-scoped CAMOFOX_URL for Hermes, and hard rules such as always sending userId and re-snapshotting after state-changing actions. Do not use for normal web search, text extraction, curl fetches, or ordinary browser automation.
version	1.3.4
author	Trevin Chow
license	MIT-0
platforms	["macos","linux"]
metadata	{"hermes":{"tags":["browser","camofox","camoufox","cloaking","anti-detection","npm","openclaw"],"category":"browser","related_skills":["hermes-agent"],"config":[{"key":"camofox.base_url","description":"Local Camofox browser server base URL. Default is http://127.0.0.1:9377.","default":"http://127.0.0.1:9377","prompt":"Camofox server base URL"}]},"openclaw":{"emoji":"🦊","os":["macos","linux"],"homepage":"https://github.com/jo-inc/camofox-browser","requires":{"bins":["node","npm","curl"]},"install":[{"kind":"node","package":"@askjo/camofox-browser","bins":["camofox-browser"]}],"envVars":[{"name":"CAMOFOX_PORT","required":false,"description":"Optional server port. Defaults to 9377. PORT is also honored."},{"name":"PORT","required":false,"description":"Optional generic port override when CAMOFOX_PORT is not set."},{"name":"CAMOFOX_BASE_URL","required":false,"description":"Optional shell/client convention used by this skill's raw REST examples. Defaults to http://127.0.0.1:9377."},{"name":"CAMOFOX_USER_ID","required":false,"description":"Optional shell/client convention for raw REST examples. Always send a userId; defaults to agent1 in examples."},{"name":"CAMOFOX_SESSION_KEY","required":false,"description":"Optional shell/client convention for raw REST examples. Prefer a sessionKey when creating tabs."},{"name":"CAMOFOX_ACCESS_KEY","required":false,"description":"Optional global bearer token for all routes except /health. Use when exposing beyond localhost."},{"name":"CAMOFOX_API_KEY","required":false,"description":"Optional bearer token used only for sensitive endpoints such as cookie import and traces. Not needed for normal browsing, snapshots, navigation, clicks, or typing."},{"name":"CAMOFOX_CRASH_REPORT_ENABLED","required":false,"description":"Optional telemetry toggle. Set to false to disable anonymized crash/hang reports."},{"name":"CAMOFOX_CRASH_REPORT_URL","required":false,"description":"Optional self-hosted crash-report endpoint override."},{"name":"CAMOUFOX_EXECUTABLE","required":false,"description":"Optional external Camoufox executable/bundle to avoid npm postinstall browser download. Aliases: CAMOUFOX_EXECUTABLE_PATH, CAMOFOX_EXECUTABLE_PATH."},{"name":"CAMOUFOX_EXECUTABLE_PATH","required":false,"description":"Compatibility alias for CAMOUFOX_EXECUTABLE."},{"name":"CAMOFOX_EXECUTABLE_PATH","required":false,"description":"Legacy compatibility alias for CAMOUFOX_EXECUTABLE."},{"name":"CAMOFOX_URL","required":false,"description":"Hermes-only client-side backend switch. Footgun: if set in Hermes global env/.env/gateway env, Hermes routes all browser calls in that process through Camofox. Do not persist or export globally; use only inline for a dedicated Hermes process."}]}}

Camofox Cloaked Browser

When to use

Use this skill only when the task needs Camofox/Camoufox specifically:

• user names Camofox, Camoufox, anti-detection browsing, cloaked browser, browser fingerprint spoofing, or stealth browsing
• a site is likely to block normal Playwright/Chrome automation
• the task needs stable accessibility refs from a Camofox browser server
• OpenClaw has the camofox-browser plugin/tools available

Do not use it for ordinary web search, simple page fetches, static text extraction, or normal browser automation. Use the cheaper default stack unless cloaking is actually load-bearing.

If the user names another browser target explicitly — Browserbase, Selkies, a tailnet browser, normal Hermes browser, Chrome DevTools, etc. — stop and use that target/skill instead. Do not silently route through Camofox.

Default target

Default local server:

http://127.0.0.1:9377

Equivalent localhost URL is usually fine:

http://localhost:9377

Prefer 127.0.0.1 in examples to avoid IPv6/localhost oddities.

There is no container target in this skill. Do not mention or rely on container names; this skill is about the npm server and OpenClaw plugin/API.

Operating model

Camofox Browser is a Node server and OpenClaw plugin wrapper around Camoufox, a Firefox-based anti-detection browser.

Primary local startup:

npx -y @askjo/camofox-browser
# serves http://127.0.0.1:9377 by default

Alternative cloned-repo startup:

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

Alternative global install:

npm install -g @askjo/camofox-browser
camofox-browser

npm install / npx downloads the Camoufox browser binary on first run via the package postinstall unless CAMOUFOX_EXECUTABLE points to an existing compatible Camoufox bundle. Expect roughly a few hundred MB for the browser payload.

OpenClaw plugin mode

If OpenClaw has the upstream plugin installed, prefer the plugin tools over raw curl because they auto-manage userId from , use , and can auto-start the server.