配置

agent-browser --config ./ci-config.json open example.com
AGENT_BROWSER_CONFIG=./ci-config.json agent-browser open example.com

{
  "headed": true,
  "userAgent": "my-agent/1.0",
  "hideScrollbars": false,
  "colorScheme": "dark",
  "maxOutput": 50000,
  "screenshotQuality": 80,
  "screenshotFormat": "png",
  "idleTimeout": "30m"
}

{
  "$schema": "https://agent-browser.dev/schema.json",
  "headed": true
}

{
  "headed": true,
  "profile": "./browser-data"
}

{
  "proxy": "http://proxy.corp.example.com:8080",
  "proxyBypass": "localhost,*.internal.com",
  "caCert": "/etc/ssl/certs/proxy-ca.crt"
}

{
  "proxy": "http://proxy.corp.example.com:8080",
  "proxyBypass": "localhost,*.internal.com",
  "ignoreHttpsErrors": true
}

{
  "args": "--no-sandbox,--disable-gpu",
  "ignoreHttpsErrors": true
}

{
  "provider": "ios",
  "device": "iPhone 16 Pro"
}

{
  "contentBoundaries": true,
  "maxOutput": 50000,
  "allowedDomains": ["your-app.com", "*.your-app.com"],
  "actionPolicy": "./policy.json"
}

agent-browser --headed false open example.com

agent-browser --headed open example.com       # same as --headed true
agent-browser --headed true open example.com  # explicit

{
  "plugins": [
    {
      "name": "vault",
      "command": "agent-browser-plugin-vault",
      "args": [],
      "capabilities": ["credential.read"]
    },
    {
      "name": "cloud-browser",
      "command": "agent-browser-plugin-cloud-browser",
      "capabilities": ["browser.provider"]
    },
    {
      "name": "stealth",
      "command": "agent-browser-plugin-stealth",
      "capabilities": ["launch.mutate"]
    },
    {
      "name": "captcha",
      "command": "agent-browser-plugin-captcha",
      "capabilities": ["command.run", "captcha.solve"]
    }
  ]
}

agent-browser plugin list
agent-browser auth login my-app --credential-provider vault --item "My App"
agent-browser --provider cloud-browser open https://example.com
agent-browser plugin run captcha captcha.solve --payload '{"siteKey":"...","url":"https://example.com"}'

<tr><td><code>AGENT_BROWSER_STREAM_PORT</code></td><td>覆盖 WebSocket 流式传输端口。默认使用操作系统分配的端口。设置此项可绑定到特定端口（例如 <code>9223</code>）。</td><td>由操作系统分配</td></tr>
<tr><td><code>AGENT_BROWSER_DASHBOARD_ALLOWED_ORIGINS</code></td><td>允许通过反向代理访问仪表盘的精确 HTTPS 来源（以逗号分隔）。每个条目都必须有效，否则仪表盘启动失败。未设置此项时，仅接受回环来源。回环访问不需要外部仪表盘令牌。</td><td>（无）</td></tr>
<tr><td><code>AGENT_BROWSER_STREAM_QUALITY</code></td><td>流式传输帧的 JPEG 质量，范围 0 到 100。较低的值可减少带宽：在繁忙页面上，质量 20 消耗的字节数约为默认值的一半。</td><td><code>80</code></td></tr>
<tr><td><code>AGENT_BROWSER_STREAM_MAX_WIDTH</code></td><td>限制编码帧的像素宽度。仅限制帧，不影响页面大小，因此指针坐标不受影响。</td><td>视口</td></tr>
<tr><td><code>AGENT_BROWSER_STREAM_MAX_HEIGHT</code></td><td>限制编码帧的像素高度。</td><td>视口</td></tr>
<tr><td><code>AGENT_BROWSER_IDLE_TIMEOUT_MS</code></td><td>在没有命令或仪表盘输入的情况下经过 N 毫秒后自动关闭守护进程。设置为 <code>0</code> 可禁用。有头浏览器、Safari 和 iOS WebDriver 会话以及用户附加的浏览器不受默认值限制。提供商拥有的云浏览器可被清理，显式设置的值适用于所有浏览器。</td><td><code>3600000</code>（1 小时）</td></tr>
<tr><td><code>AGENT_BROWSER_IOS_DEVICE</code></td><td><code>ios</code> 提供程序的默认 iOS 设备名称。</td><td>（无）</td></tr>
<tr><td><code>AGENT_BROWSER_IOS_UDID</code></td><td><code>ios</code> 提供程序的默认 iOS 设备 UDID。</td><td>（无）</td></tr>
<tr><td><code>AGENT_BROWSER_DEBUG</code></td><td>启用调试输出（设置为 <code>1</code> 启用）。</td><td>（禁用）</td></tr>
<tr><td><code>AGENT_BROWSER_CONTENT_BOUNDARIES</code></td><td>为了 LLM 安全，将页面输出包裹在边界标记中。</td><td>（禁用）</td></tr>
<tr><td><code>AGENT_BROWSER_MAX_OUTPUT</code></td><td>页面输出的最大字符数（超出限制部分将被截断）。</td><td>（无限制）</td></tr>
<tr><td><code>AGENT_BROWSER_ALLOWED_DOMAINS</code></td><td>以逗号分隔的允许域名模式（例如 <code>example.com,*.example.com</code>）。这需要全新的可控制浏览器上下文，且不包含配置文件/会话启动参数、恢复/状态重放或直接页面提供程序插件。</td><td>（不受限制）</td></tr>
<tr><td><code>AGENT_BROWSER_ACTION_POLICY</code></td><td>操作策略 JSON 文件的路径。</td><td>（无）</td></tr>
<tr><td><code>AGENT_BROWSER_CONFIRM_ACTIONS</code></td><td>需要确认的以逗号分隔的操作类别。</td><td>（无）</td></tr>
<tr><td><code>AGENT_BROWSER_CONFIRM_INTERACTIVE</code></td><td>启用交互式确认提示（如果标准输入不是 TTY，则自动拒绝）。</td><td>（禁用）</td></tr>
<tr><td><code>AGENT_BROWSER_ENGINE</code></td><td>要使用的浏览器引擎：<code>chrome</code>（默认）、<code>lightpanda</code>、<code>obscura</code>（实验性）。</td><td><code>chrome</code></td></tr>
<tr><td><code>AGENT_BROWSER_NO_AUTO_DIALOG</code></td><td>禁用 <code>alert</code>/<code>beforeunload</code> 对话框的自动关闭。</td><td>（禁用）</td></tr>
<tr><td><code>AGENT_BROWSER_PLUGINS</code></td><td>JSON 插件注册表覆盖。</td><td>（配置发现）</td></tr>
<tr><td><code>AGENT_BROWSER_SCREENSHOT_DIR</code></td><td>默认截图输出目录。</td><td>（临时目录）</td></tr>
<tr><td><code>AGENT_BROWSER_SCREENSHOT_QUALITY</code></td><td>JPEG 截图质量，范围 0 到 100。</td><td>（格式默认值）</td></tr>
<tr><td><code>AGENT_BROWSER_SCREENSHOT_FORMAT</code></td><td>截图格式：<code>png</code> 或 <code>jpeg</code>。</td><td><code>png</code></td></tr>
<tr><td><code>AGENT_BROWSER_SOCKET_DIR</code></td><td>守护进程套接字文件的高级覆盖设置。</td><td>运行时目录或 <code>~/.agent-browser</code></td></tr>
<tr><td><code>AGENT_BROWSER_SKILLS_DIR</code></td><td>覆盖 <code>agent-browser skills</code> 使用的目录。</td><td>内置技能</td></tr>
<tr><td><code>AGENT_BROWSER_COLOR</code></td><td>当值为真时启用彩色 CLI 输出。</td><td>（禁用）</td></tr>
<tr><td><code>NO_COLOR</code></td><td>存在时禁用彩色输出。</td><td>（未设置）</td></tr>
<tr><td><code>AI_GATEWAY_URL</code></td><td>Vercel AI Gateway 的基础 URL。</td><td><code>https://ai-gateway.vercel.sh</code></td></tr>
<tr><td><code>AI_GATEWAY_API_KEY</code></td><td>用于 Vercel AI Gateway 的 API 密钥。启用 AI 聊天所必需。</td><td>（无）</td></tr>
<tr><td><code>AI_GATEWAY_MODEL</code></td><td>仪表盘聊天的默认 AI 模型。</td><td><code>anthropic/claude-sonnet-4.6</code></td></tr>