CamoFox浏览器

CamoFox 浏览器是什么？

CamoFox 浏览器是一款专为AI智能体打造的无头浏览器自动化服务器。它由 Camoufox 提供支持——这是一个 Firefox 的分支版本，能够在 C++ 引擎层面执行浏览器指纹欺骗，而不是依赖脆弱的 JavaScript 补丁。

这使得 AI 智能体能够访问那些通常会屏蔽 Playwright 或 Puppeteer 等自动化工具的真实网站，包括受 Cloudflare、Google 和其他高级机器人检测系统保护的网站。

它与 Jo AI 助手背后使用的是相同的浏览引擎，并能与 OpenClaw 及其他智能体框架无缝集成。

主要特性

• C++ 层面反检测：在浏览器引擎层面欺骗导航器属性、WebGL、AudioContext、屏幕几何、WebRTC 等，实现最高级别的不可检测性。
• 高效的快照令牌：返回无障碍树快照（比原始 HTML 小约 90%）+ 可选的 base64 截图。
• 稳定的元素引用：使用可靠的 e1、e2 等引用进行点击、输入和交互操作。
• 会话隔离：按 userId 和 sessionKey 进行隔离，具备自动过期和标签页回收机制。
• 代理与 GeoIP 对齐：通过匹配语言环境、时区和地理位置的住宅代理路由流量。
• Cookie 导入：支持 Netscape 格式的 Cookie 注入，用于已认证的会话（例如 LinkedIn、Amazon 等）。
• 内置搜索宏：@google_search、@youtube_search、@amazon_search、@reddit_subreddit 及更多。
• YouTube 字幕提取：通过 yt-dlp 快速提取，或使用浏览器作为备用方案。
• 低资源占用：闲置内存约 40MB；支持延迟启动和空闲关闭。可在树莓派或廉价 VPS 上运行。
• 结构化 API：提供 REST 端点，具备 JSON 日志记录和请求 ID 追踪功能。

架构

• 浏览器由 Camoufox 驱动
• 每个用户拥有独立的 BrowserContext
• 按 sessionKey 组织的标签页组
• 自动空闲关闭与按需重新启动

安装与快速开始

独立安装

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

服务器运行于 http://localhost:9377 。Camoufox（约 300MB）将在首次运行时自动下载。

Docker 安装

make up

支持 Fly.io、Railway 以及多架构构建。

OpenClaw 集成

openclaw plugins install @askjo/camofox-browser

使用示例

新建标签页

curl -X POST http://localhost:9377/tabs \
  -H "Content-Type: application/json" \
  -d '{"userId": "agent1", "sessionKey": "task1", "url": "https://example.com"}'

获取无障碍快照 + 截图

curl "http://localhost:9377/tabs/{TAB_ID}/snapshot?userId=agent1&includeScreenshot=true"

通过 ref 点击元素

curl -X POST http://localhost:9377/tabs/{TAB_ID}/click \
  -d '{"userId": "agent1", "ref": "e1"}'

使用宏进行搜索

curl -X POST http://localhost:9377/tabs/{TAB_ID}/navigate \
  -d '{"userId": "agent1", "macro": "@google_search", "query": "best wireless headphones"}'

应用场景

• 需要可靠网络浏览的AI智能体（用于调研、购物、社交媒体等）
• 绕过受Cloudflare保护或Google网站的反机器人防护
• 使用导入的Cookie进行身份验证的浏览
• 在长时间运行的智能体工作流中实现令牌高效的网络交互
• 与 OpenClaw、Claude Desktop（通过 MCP）、LangChain 及自定义智能体集成

资源链接

• GitHub: https://github.com/jo-inc/camofox-browser
• Camoufox: https://camoufox.com
• OpenClaw 集成: https://openclaw.ai
• 文档: https://jo-inc-camofox-browser.mintlify.app

CamoFox Browser 采用 MIT 许可证，持续维护（最新版本发布于 2026 年 4 月），并广泛用于生产环境中的 AI 智能体网络自动化。