适合谁
- 需要「录制一次、重复执行」的定时或重复任务（如每日登录、定时抓取）
- 希望降低 Token 消耗、避免每次都由 LLM 逐步推理的 Agent 场景
- 需要多标签页、iframe、文件上传下载、拖拽等丰富浏览器原子操作的项目
- 需要元素指纹与自适应重定位来应对页面改版的自动化流程
Z
54FMRS · D
ZeroToken 是一个 MIT 许可、社区维护的轻量级浏览器自动化 MCP 引擎，以「录制一次、永久自动化」为核心，轨迹录制 + 脚本回放可显著降低重复任务的 Token 消耗。它提供 26 个 browser_* 原子操作，具备多标签页/iframe 管理、SmartSelector/SmartWait/ErrorRecovery 稳定性机制、元素指纹自适应重定位、录制探索模式与 SQLite 持久化，同时支持 stdio 与 Streamable HTTP 双 transport。OpenClaw 用户须使用 HTTP 模式以保持浏览器状态，并需自行安装 Playwright Chromium。它不是官方产品，无商业支持；使用者需自负目标网站条款与本地数据安全责任。
ZeroToken 是一个面向 AI Agent 的轻量化浏览器自动化 MCP 引擎。AI 通过 ReAct 模式分步调用 MCP 原子能力完成浏览器操作，系统完整记录操作轨迹（页面状态、截图、执行结果与模糊点标记），可将轨迹导出为 AI 友好格式或转为可回放的确定性脚本。回放阶段无需 LLM 逐步推理，Token 消耗低、执行速度快。项目采用 Transport → Handler → Service → Domain → Repository/Infrastructure 五层分层架构，基于 Pydantic v2 强类型模型，使用 SQLite 存储脚本、轨迹、会话、指纹、绑定与运行时状态，并通过 Playwright/Chromium 驱动真实浏览器。
工具能力
browser_init
初始化浏览器，遇反爬/云盾可传 stealth=true 启用隐蔽启动与指纹伪装
browser_open
打开指定 URL 页面
browser_click
点击页面元素
browser_input
向输入框填写文本
browser_hover
鼠标悬停在元素上
browser_keyboard
发送键盘按键组合（如 Control+S）
browser_scroll
按方向与距离滚动页面
browser_drag_drop
将源元素拖拽到目标元素
browser_upload
上传本地文件到 file 类型输入框
browser_download
触发并完成文件下载，返回保存路径
browser_evaluate
在页面中执行 JavaScript 表达式
browser_new_tab
新建标签页并返回 tab_id
browser_list_tabs
列出当前所有标签页
browser_switch_tab
切换到指定标签页
browser_close_tab
关闭指定标签页
browser_enter_iframe
进入指定 iframe 上下文
browser_exit_iframe
退出当前 iframe 上下文
trajectory_start
开始记录操作轨迹（task_id、goal）
trajectory_complete
结束轨迹记录，可 export_for_ai=true 导出含模糊点标记的 AI 提示
trajectory_list
查看已保存的轨迹列表
trajectory_delete
删除指定轨迹，避免记录过多
trajectory_to_script
将指定 task_id 的轨迹转换为可回放脚本
trajectory_explore_start
开启录制探索模式，隔离 AI 试错路径，避免污染正式轨迹
trajectory_explore_stop
结束探索模式，keep 可选 none / last / all
script_generate
根据轨迹生成脚本
script_run
确定性回放脚本，可传 vars；失败或需判断时暂停生成 session
script_resume
恢复暂停的脚本会话，resolution 可选 retry / skip / patch / abort
script_health
查看脚本连续失败情况与成功率
script_deprecate
将脚本标记为废弃（如改版失效）
script_restore
恢复被废弃的脚本
script_bind
把外部 job_id 绑定到脚本，支持 default_vars
script_binding_set
将 OpenClaw 的 job_id 与脚本 task_id 绑定
run_script_by_job_id
按绑定 key（job_id）一步执行脚本，无需 LLM 逐步推理
安装接入
- 安装：pip install zerotoken 或 uv add zerotoken；2. 安装浏览器：playwright install chromium（必须）；3. OpenClaw 场景在后台常驻运行 zerotoken-mcp-http（默认监听 http://0.0.0.0:8000/mcp，可用 --port 或 ZEROTOKEN_HTTP_PORT 指定端口）；4. 在 ~/.openclaw/openclaw.json 的 mcpServers 中将 zerotoken 配置为 url: "http://localhost:8000/mcp"，不要用 command；5. 安装 zerotoken-openclaw Skill（clawhub install zerotoken-openclaw 或复制 skills/zerotoken-openclaw）；6. 在 OpenClaw 中启用该 MCP server 并确保 Skill 已加载。Cursor 等 IDE 使用 stdio 模式，配置 command: "zerotoken-mcp"（或 command: "uv", args: ["run", "zerotoken-mcp"]）。
claude_desktop_config.json
{
"mcpServers": {
"zerotoken": {
"url": "http://localhost:8000/mcp"
}
}
}
选型与风险
不适合谁
- 无法运行 Playwright/Chromium 或无法安装浏览器的环境
- 只使用 stdio 却又需要跨调用保持浏览器状态的客户端（README 明确指出 command 模式每次工具调用会新建进程、导致 browser 实例被销毁）
- 需要官方商业支持或 SLA 的生产关键系统
- 不接受本地 SQLite 落盘存储轨迹、截图与会话数据的场景
所需权限
- 本地文件系统读写（SQLite 数据库 zerotoken.db、文件上传与下载路径）
- 网络访问（访问目标网站、Playwright/Chromium 下载）
- 启动并控制本地 Chromium 浏览器进程
- OpenClaw 场景需运行本地 HTTP 服务并监听端口（默认 8000）
风险与副作用
- 脚本会以真实浏览器身份访问目标网站并执行点击、输入、上传下载等操作，误操作可能造成数据变更或误提交
- 轨迹记录会保存页面状态与截图（base64 截图可能包含敏感信息），落盘于 SQLite，存在隐私与凭据泄露风险
- browser_init(stealth=true) 的指纹伪装可能违反目标网站的服务条款
- 依赖目标页面结构：选择器失效仍是主要不稳定因素（README 称占 60%），改版后脚本可能失败
- HTTP 模式默认监听 0.0.0.0，若暴露到非受信网络可能被他人调用
常见排障
- browser 状态丢失、每次操作都像第一次：说明仍在使用 command（stdio）模式，需确认已后台运行 zerotoken-mcp-http，且 openclaw.json 中 zerotoken 配置为 url 而非 command
- 连接失败 / MCP 不可用：确认 zerotoken-mcp-http 已启动且端口正确（默认 8000），URL 与配置一致
- 浏览器无法启动：确认已执行 playwright install chromium
- 响应体积过大：browser 类工具可传 include_screenshot: false 减少体积
- 记录过多：用 trajectory_list 查看已保存轨迹，对不需要的调用 trajectory_delete(task_id)
- 元素定位失败：对关键元素传 auto_save: true 保存指纹，改版后传 adaptive: true 自动重定位
- 脚本连续失败：用 script_health 查看成功率，必要时 script_deprecate 再 script_restore
使用场景
AI Agent 浏览器自动化（OpenClaw、LLM Agent）
RPA 重复性网页操作录制回放
定时抓取网页数据
记录测试步骤并回放的自动化测试
将轨迹导出为 AI 提示供 Skills 或其他模块分析
支持客户端
OpenClaw完整支持
Cursor完整支持