CamoFox 瀏覽器

CamoFox Browser 是什麼？

CamoFox Browser 是一款專為 AI 智慧體 打造的無頭瀏覽器自動化伺服器。它由 Camoufox 驅動——一個 Firefox 的分支版本，能在 C++ 引擎層級 進行瀏覽器指紋偽裝，而非依賴脆弱的 JavaScript 修補程式。

這使得 AI 智慧體能夠訪問那些通常會封鎖自動化工具（如 Playwright 或 Puppeteer）的真實網站，包括受 Cloudflare、Google 和其他進階機器人偵測系統保護的網站。

它與 Jo AI 助手背後使用的瀏覽器引擎相同，並能與 OpenClaw 及其他智慧體框架無縫整合。

主要功能

-Detection**：在瀏覽器引擎層級偽裝 navigator 屬性、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；支援延遲啟動和閒置關閉。可在 Raspberry Pi 或廉價 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"

透過參照點擊元素

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 網站保護的反機器人機制
• 使用匯入的 Cookies 進行認證瀏覽
• 在長期運行的代理程式工作流程中，進行權杖效率高的網頁互動
• 與 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 代理程式網頁自動化。