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 代理程式網頁自動化。

CamoFox 瀏覽器