AIHawk:Open-source AI browser agent for web automation: a web browsing agent and computer-use agent in plain English. Browser MCP for Claude Code and Gemini CLI.

---

两种使用这款浏览器智能体的方式

1. 通过 MCP，从你的助手中使用

在 Windows 的 PowerShell 中：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uvx invisible-playwright fetch

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx invisible-playwright fetch

然后告诉你的助手它已经存在。

Claude Code:

claude mcp add --scope user stealth -- uvx aihawk

Codex:

codex mcp add stealth -- uvx aihawk

Gemini CLI：

gemini mcp add --scope user stealth uvx aihawk

2. 独立模式：Web 界面

我们提供界面，你只需提供 OpenRouter 密钥。 左侧是聊天界面，右侧是实时浏览器。

Windows 系统，在 PowerShell 中：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uvx invisible-playwright fetch
uvx aihawk ui --openrouter-key sk-or-...

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx invisible-playwright fetch
uvx aihawk ui --openrouter-key sk-or-...

然后打开 http://127.0.0.1:8765，并输入相同的内容。

---

适合向网页浏览智能体提出的任务

任何需要真实网页自动化的任务：需要浏览器而非 API，并需要人的判断来理解页面上呈现的内容。

前往 <paste the URL>。单程，米兰到里斯本，经济舱，一件托运行李， 一名成人。依次检查下个月 12 日到 16 日的每一天，并读取每天的最低票价。 日期字段是日历控件，因此点击日期，而不是输入日期。如果某天没有可预订的航班， 请明确指出。不要猜测数字。

它会像人一样操作页面：移动指针，按下按键。

选项：代理、配置、种子

• --openrouter-key 你的密钥，或 OPENROUTER_API_KEY 变量。
• --model OpenRouter 模型 ID，或 AIHAWK_MODEL。默认值为 z-ai/glm-5.3-flash。
• --proxy 可选。http://user:pass@proxy.example.com:8080 或 socks5://proxy.example.com:1080。必须同时提供主机和端口。时区、区域设置与出站流量都跟随它。
• --binary 你已有的引擎二进制文件。它必须是 seal 锁定的构建版本，否则启动会被拒绝：该选项只会跳过下载，不会跳过版本检查。
• --seed 一个整数。相同种子，每次运行都使用相同的浏览器身份。
• --profile-dir 用于存放配置文件的目录，以便登录状态和 Cookie 在重启后仍然保留。
• --headed 显示浏览器窗口。不过界面本来也会展示页面。
• --host、--port 127.0.0.1 和 8765。修改 host 会暴露一个没有身份验证的接口。

在命令旁添加 .env

与其重复输入密钥和二进制文件路径，不如将它们放入你运行命令所在目录下的 .env 中：

OPENROUTER_API_KEY=sk-or-...
STEALTHFOX_BINARY=/path/to/firefox

它在启动时载入，并且在载入过程中绝不会覆盖已设置的值，因此优先级为 --flag > 环境变量 > .env > 默认值。 只读取当前所在目录——不会向上级目录搜索，因此即使在子文件夹中运行，也不会悄悄读取到不同的密钥。启动提示行只会列出所应用的变量名，而不会打印它们的值。

通过传入 --openrouter-key，密钥会进入你的 shell 历史；在 Linux 上，还会出现在进程列表中。将 OPENROUTER_API_KEY 放在环境变量或 .env 中，可避免这两种情况。

维基：AI 浏览器智能体指南

该智能体的延伸阅读位于 wiki： AI 浏览器智能体格局：browser-use、Operator 风格以及 computer-use 智能体对比、 当智能体被拦截时应检查什么， 以及 OpenAI Operator 后续如何 等。实际示例、运行记录及其输出位于 articles/。

其余家族成员：引擎、核心

选项 1 中的 MCP 服务器已内置于本包中：不带子命令的 aihawk 即服务器，aihawk ui 即界面。对于接受文件配置的客户端，其配置块、设置和工具都列在维基页面 The MCP server 上。

• invisible_playwright 引擎以 Python 库形式提供，用于以代码而非提示词来编写自动化。其 API 即 Playwright API。
• invisible_core 从 Seed 到指纹，再到偏好设置、代理与地理位置。

负责任地使用

它自动化的是由你控制的浏览器。请阅读你所指向的网站条款，尊重其速率限制，并且不要提交任何人类尚未阅读的内容。

许可证

MIT。2026 年 9 月 2 日之前分发的一切内容均基于 AGPL-3.0 发布，并将继续适用该许可证。