反检测浏览器

Install

Tell your AI agent (e.g. OpenClaw):

Install this CLI and skills from https://github.com/Bin-Huang/camoufox-cli

Or install manually:

npm install -g camoufox-cli
camoufox-cli install              # Download browser

Or with pip:

pipx install camoufox-cli
camoufox-cli install              # Download browser

On Linux, install system dependencies with:

camoufox-cli install --with-deps

The browser is downloaded from GitHub releases. If the anonymous GitHub API rate limit is exhausted (common on shared server/CI IPs), the installer automatically falls back to scraping github.com release pages.

Quick Start

```bash camoufox-cli open https://example.com # Launch browser & navigate camoufox-cli snapshot -i # Interactive elements only

Config File

Tired of repeating the same flags on every call? Put defaults in ~/.camoufox-cli/config.json (override the path with $CAMOUFOX_CLI_CONFIG):

{
  "default": {
    "persistent": true,
    "timeout": 3600,
    "proxy": "http://user:pass@host:8080"
  },
  "sessions": {
    "<your-session-name>": {
      "proxy": "socks5://127.0.0.1:1080",
      "locale": "zh-CN"
    }
  }
}

• default applies to every session.
• sessions is optional. You never pre-register sessions — the name is just whatever you pass to --session. A sessions.<name> block only kicks in when you happen to run --session <name>, layering its keys on top of default; any other session (or no --session at all) just uses default. Above, camoufox-cli --session <your-session-name> open <url> swaps in that block's proxy + locale, while every other session keeps the default proxy.
• Command-line flags always win over the file, which in turn wins over built-in defaults.
• Settable keys: proxy, locale, geoip, persistent (true / false / path string), headed, timeout, json. session is command-line only (it selects which block to apply), and per-command options like --full or -i are never read from config.
• A broken config never blocks a command — it's ignored with a warning on stderr.
• Config is read when a session's daemon first launches. If one is already running for that session, run camoufox-cli --session <name> close first for changes to take effect.