用途:仅在任务明确需要 Camofox/Camoufox、反检测浏览、隐蔽浏览或指纹伪装时使用;普通网页搜索、简单抓取、静态文本提取或常规浏览器自动化不应使用,因为默认方案更省成本。若用户指定其他浏览器目标,应停止并改用该目标。
主要能力:Camofox Browser 是围绕 Camoufox(基于 Firefox 的反检测浏览器)的 Node 服务器与 OpenClaw 插件封装。OpenClaw 插件提供 camofox_create_tab、camofox_snapshot、camofox_click、camofox_type、camofox_navigate、camofox_scroll、camofox_screenshot、camofox_close_tab、camofox_evaluate、camofox_list_tabs、camofox_import_cookies 等工具。REST API 支持 tab 创建、导航(含 @google_search 等宏)、快照、点击、输入、按键、等待、滚动、前进后退刷新、链接图片提取、截图、结构化提取、JS 执行、会话删除等。
使用方式:本地默认启动 npx -y @askjo/camofox-browser,服务默认 http://127.0.0.1:9377。也可克隆仓库后 npm install && npm start,或全局安装。OpenClaw 插件可用 openclaw plugins install @askjo/camofox-browser,并用 openclaw camofox status/start/stop/tabs/configure 管理。原始 REST 调用须带 userId,建议使用 sessionKey;操作前检查 /health,变更状态后重新快照,优先使用最新快照的 ref 而非 CSS 选择器,并在完成后关闭标签页。
配置与限制:支持 CAMOFOX_PORT、CAMOFOX_ACCESS_KEY、CAMOFOX_API_KEY、CAMOFOX_COOKIES_DIR、代理相关环境变量等。首次运行通常会下载数百 MB 的 Camoufox 浏览器二进制,除非设置 CAMOUFOX_EXECUTABLE 或跳过下载。CAMOFOX_URL 在 Hermes 中是浏览器后端开关,不得全局导出,只应作为单进程内联变量用于专用隐蔽运行。安全上不要把无认证的本地服务暴露到回环之外;CAMOFOX_API_KEY 仅用于敏感端点,正常浏览无需。其他未在资料中说明的细节暂未提供。