Agent Browser With Camoufox

一键安装

运行安装脚本：

bash ~/.openclaw/workspace/skills/camoufox-deploy/scripts/install.sh

这个脚本会自动完成：

1. 安装 uv (Python 包管理器)
2. 用 uv 安装 camoufox Python 包
3. 下载 camoufox 浏览器二进制
4. 安装 agent-browser npm 包
5. 修改 agent-browser 源码（自动检测 firefox/camoufox）
6. 重新编译 Rust CLI
7. 替换系统版本

手动步骤（如果需要）

1. 安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装 camoufox

uv pip install camoufox --system

3. 下载 camoufox 浏览器

python3 -c "from camoufox.sync_api import Camoufox; Camoufox()"

或手动下载：

# macOS 路径
~/Library/Caches/camoufox/Camoufox.app/Contents/MacOS/camoufox

4. 安装 agent-browser

npm install -g agent-browser

5. 找到并修改 browser.ts

找到 agent-browser 的源码目录：

# 全局安装位置
npm root -g
cd $(npm root -g)/agent-browser

# 或克隆源码
git clone https://github.com/browser-use/agent-browser.git
cd agent-browser

修改 src/browser.ts 中的 getBrowserType 函数：

private getBrowserType(executablePath: string): 'chromium' | 'firefox' {
  const lowerPath = executablePath.toLowerCase();
  if (lowerPath.includes('firefox') || lowerPath.includes('camoufox')) {
    return 'firefox';
  }
  return 'chromium';
}

6. 重新编译

npm install
npm run build

7. 替换系统版本

# 找到全局安装位置
GLOBAL_PATH=$(npm root -g)/agent-browser

# 备份原版本
cp -r "$GLOBAL_PATH" "${GLOBAL_PATH}.backup"

# 替换为修改版本
cp -r ./ "$GLOBAL_PATH/"

验证安装

# 检查 camoufox
camoufox --version

# 检查 agent-browser
agent-browser --version

# 运行测试
agent-browser --executable-path ~/Library/Caches/camoufox/Camoufox.app/Contents/MacOS/camoufox

故障排除

问题: camoufox 找不到

解决: 确认路径正确

ls ~/Library/Caches/camoufox/Camoufox.app/Contents/MacOS/camoufox

问题: agent-browser 仍使用 chromium

解决: 确认修改生效

cat $(npm root -g)/agent-browser/dist/browser.js | grep -A5 "getBrowserType"

问题: Rust 编译失败

解决: 安装 Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

文件位置

参考

• camoufox 文档
• agent-browser 仓库