/install camofox-browser-remote
Camofox Browser — Remote Mode (Docker / Shared Server)
Stealth browser automation via Camoufox. Drives an externally-managed server over HTTP — no install, no local Node process.
Setup (required)
export CAMOFOX_URL=http://172.17.0.1:9377 # required — no default
The server runs externally (Docker container, shared staging, CI). This skill only drives it. See references/docker.md for Docker networking details.
If
camofox-remoteis not found on PATH: set an alias using the script that ships with this skill. Replace\x3CSKILL_DIR>with the directory containing this SKILL.md file:alias camofox-remote="bash \x3CSKILL_DIR>/scripts/camofox-remote.sh"Example: if this SKILL.md is at
~/my-skills/camofox-browser-remote/SKILL.md, use~/my-skills/camofox-browser-remote.
Trust requirement: Every command — page snapshots, screenshots, typed text, navigation history — is sent over HTTP to
CAMOFOX_URL. Only point this at a server you own and control. Do not use a shared or third-party endpoint if you will visit sites with credentials or sensitive data.
Quick Start
camofox-remote open https://example.com # Create tab + navigate
camofox-remote snapshot # Get page elements with @refs
camofox-remote click @e1 # Click element
camofox-remote type @e2 "hello" # Type text
camofox-remote screenshot # Save PNG
camofox-remote close # Close tab
Core Workflow
- Navigate —
camofox-remote open \x3Curl> - Snapshot — returns an accessibility tree with
@e1,@e2refs (~90% smaller than raw HTML) - Interact — use refs to click, type, scroll
- Re-snapshot — after any DOM change, refs are invalidated; get fresh ones
- Repeat — the server stays running between commands
camofox-remote open https://example.com/search
camofox-remote snapshot
# @e1 [input] Search box @e2 [button] Submit
camofox-remote type @e1 "camoufox anti-detection"
camofox-remote click @e2
camofox-remote snapshot # MUST re-snapshot after navigation
Commands (at a glance)
| Category | Commands |
|---|---|
| Server | health, start (no-op — manage container externally), stop (no-op — manage container externally) |
| Navigation | open \x3Curl>, navigate \x3Curl>, back, forward, refresh, scroll [down|up|left|right] |
| Page state | snapshot, screenshot [path], tabs, links |
| Interaction | click @eN, type @eN "text" |
| Search | search google "query" (13 macros — see references/macros.md) |
| Session | --session \x3Cname> \x3Ccmd>, close, close-all |
Full reference with curl equivalents: references/commands.md.
Ref Lifecycle (critical)
Refs (@e1, @e2) are invalidated whenever the DOM changes. Always re-snapshot after:
- Clicking links/buttons that navigate
- Form submissions
- Dynamic content loads (infinite scroll, SPA route change)
Environment Variables
| Variable | Default | Meaning |
|---|---|---|
CAMOFOX_URL |
REQUIRED | Remote base URL — e.g. http://172.17.0.1:9377. No default. |
CAMOFOX_SESSION |
default |
Default session name (isolated cookies/storage) |
HTTPS_PROXY |
(unset) | Outbound proxy for the browser |
When to Use camofox-browser-remote vs agent-browser
| Scenario | Tool |
|---|---|
| Normal websites, no bot detection | agent-browser (faster) |
| Cloudflare / Akamai protected | camofox-browser-remote |
| Sites that block Chromium automation | camofox-browser-remote |
| Need anti-fingerprinting | camofox-browser-remote |
| Need iOS / mobile simulation | agent-browser |
| Need video recording | agent-browser |
Deep-Dive References
| File | Load when |
|---|---|
| references/docker.md | Docker setup, networking, compose example, CAMOFOX_URL configuration |
| references/commands.md | Need exact args, output format, or curl equivalent of any command |
| references/api-reference.md | Calling an endpoint the wrapper doesn't expose |
| references/macros.md | Using search macros (@google_search, etc.) |
| references/troubleshooting.md | Debugging failures (connect refused, stale refs, empty snapshots) |
Ready-to-Use Templates
| File | Description |
|---|---|
| templates/stealth-scrape.sh | Full anti-detection scrape (screenshot + snapshot + links) |
| templates/multi-session.sh | Parallel URLs in isolated sessions |
Cleanup
Always close when done:
camofox-remote close-all
camofox-remote stop # no-op in remote mode; manage the container externally
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install camofox-browser-remote - 安装完成后,直接呼叫该 Skill 的名称或使用
/camofox-browser-remote触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Camofox Browser Remote 是什么?
Remote-mode anti-detection browser automation using Camoufox (Firefox fork with C++ fingerprint spoofing). Requires CAMOFOX_URL pointing to an externally-man... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 140 次。
如何安装 Camofox Browser Remote?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install camofox-browser-remote」即可一键安装,无需额外配置。
Camofox Browser Remote 是免费的吗?
是的,Camofox Browser Remote 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Camofox Browser Remote 支持哪些平台?
Camofox Browser Remote 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Camofox Browser Remote?
由 kuo77122(@kuo77122)开发并维护,当前版本 v1.0.2。