OpenClaw Zero Token 是著名开源项目 OpenClaw 的衍生分支版本，其核心目标是免除高昂的 API Token 费用，实现对各大主流 AI 平台的完全免费访问。通过 Playwright 浏览器自动化技术接管用户本地 Chrome 浏览器的调试端口，该工具可以自动捕获并持久化用户在 ChatGPT、Claude、DeepSeek、Kimi、通义千问等网页端手动登录后的鉴权凭证（Cookie 和 Bearer Token）。获取凭证后，系统会在本地搭建一个 Gateway 网关，将这些原本只能在网页上使用的免费对话通道封装成标准的接口，让 OpenClaw 智能体可以零成本、无限量（受限于官方网页端限流）地调用大模型算力。同时，它完美继承了 OpenClaw 强大的本地工具调用（Tool Calling）机制和极具特色的 AskOnce 多模型并发提问功能，是一款真正让开发者免费拥有全自动化本地 AI 助理的硬核网关工具。
功能列表
- 免 API Token 聚合调用：彻底打破官方开发者接口的计费限制，原生支持免费驱动 DeepSeek、ChatGPT、Claude、Gemini、通义千问、Kimi、豆包、Grok、智谱清言、Manus 等十余款国内外顶级大模型。
- 本地工具调用（Tool Calling）支持：在完全免费的 Web 端调用模式下，通过系统级 XML 指令注入和流式解析技术，让 AI 能够自主执行
exec（运行命令）、read_file（读文件）、list_dir（遍历目录）、browser（网页自动化）、apply_patch（修改代码）等系统操作。 - AskOnce 多模型并发提问：提供一问多答的独创功能。只需输入一次提示词，系统即可同时向多个已配置的 AI 模型（如同时向 DeepSeek 和 Claude）发起查询，同屏并排获取并对比各个模型的回复结果。
- 本地凭证安全接管：通过 Chrome CDP（Chrome DevTools Protocol）无感拦截并提取 Authorization Header，Cookie 等认证凭证仅保存在本地文件中，绝不上传，确保账号数据的绝对安全。
- 开箱即用的 Web UI 与 CLI/TUI：项目自带多端交互界面，用户既可以通过终端命令行直接下发指令，也可以访问本地 Web 界面进行直观的对话与工作流管理。
- 安全沙盒与目录限制：支持在配置文件中严格设定智能体的工作区目录（Workspace），确保 AI 工具调用仅在授权的文件夹范围内生效，防止恶意代码或大模型幻觉破坏核心系统文件。
使用帮助
OpenClaw Zero Token 旨在通过浏览器本地登录的方式，为您提供完全免费的 API Token 替代方案。为了保障服务顺利运行，请按照以下详细步骤完成项目的前置环境搭建与核心配置。
一、 前置环境准备
运行该项目需要您的计算机具备基础的开发环境：确保已安装 Node.js（推荐版本 22.12.0 及以上）、包管理器 pnpm（9.0.0 及以上版本）以及 Git。同时，必须在本地电脑安装最新版的 Google Chrome 浏览器，该项目将依赖 Chrome 进行鉴权捕获。如果您使用的是 Windows 系统，官方强烈推荐在 WSL2（Windows Subsystem for Linux）环境下运行。
二、 项目编译与依赖安装
打开系统终端，选择合适的目录并克隆项目源码：
git clone https://github.com/linuxhsj/openclaw-zero-token.git
进入项目根目录：
cd openclaw-zero-token
安装所有必需的依赖包：
pnpm install
进行项目静态文件与 UI 界面的编译：
pnpm build
pnpm ui:build
三、 捕获凭证与网关配置（核心步骤）
这是免去 API Token 费用的关键环节，系统需要通过浏览器调试模式提取您的网页端登录状态。
首先，启动 Chrome 浏览器的调试模式。在终端中运行提供的辅助脚本：
./start-chrome-debug.sh
注意：该脚本执行后会自动打开一个 Chrome 浏览器窗口（占用 9222 端口），请保持此终端窗口和浏览器始终开启，切勿关闭。
在弹出的浏览器中，手动访问您想要使用的 AI 平台官网（例如访问 https://chat.deepseek.com/）并完成常规的扫码或账号密码登录。
登录完成后，新开一个终端窗口（保持刚刚的调试终端仍在运行），执行认证配置向导：
./onboard.sh webauth
根据屏幕上的交互提示，选择对应的平台（如 DeepSeek Browser Login），并选择 Automated Login（自动捕获）模式。系统会自动通过 Playwright 监听网络请求并截获鉴权凭证保存到本地配置文件中。如果需要添加多个模型，只需重复执行此命令即可。
四、 启动智能体服务并开始使用
完成凭证捕获后，您可以启动本地网关与 Web UI 服务：
./server.sh start
服务启动后，您可以通过访问本地地址（默认通常为 http://127.0.0.1:3001）进入 Web UI 聊天界面直接与模型交互。
如果您希望在终端中通过命令行控制智能体，可以运行：
node openclaw.mjs tui
在对话框中，您可以使用 “/model claude-web” 或 “/model deepseek-web” 随时切换已授权的模型。结合内置的本地工具调用（Tool Calling），您可以直接向 AI 下达如“分析当前目录下所有的报错日志，并用 apply_patch 工具修复代码”的指令，体验完全免费的自动化编程。如需对比结果，使用 “/askonce” 即可一键获取多模型的并发回答。
应用场景
- 零成本代码库自动维护与重构
在日常开发中，程序员需要 AI 分析数十个代码文件。官方 API 的大上下文读取往往消耗海量资金，而 Zero Token 工具将网页端大模型的免费长文本能力封装为接口。只需下发一条重构指令，OpenClaw 即可无限次自主调用read_file查阅本地文件，并用apply_patch直接修改本地代码，实现零 Token 费用的代码闭环。 - AskOnce 提效与模型横向评测
提示词工程师与科研人员在调优 Prompt 时，不再需要挨个购买各大厂商的 API 额度或频繁切换浏览器标签页。通过配置本地登录环境，利用 AskOnce 功能下发指令，系统会在后台瞬间同步操控已登录的 ChatGPT、Claude、DeepSeek 网页端，并将结果统一返回到本地控制台，直观、高效且免费地展现各家模型的真实水平。 - 安全环境下的全天候自动化助理
运维人员可以通过该工具构建一个免计费的本地自动化脚本调度中心。在严格限制工作区目录（Workspace）的前提下，让智能体 24 小时待命，自主调用exec工具执行定时服务器巡检脚本，或通过browser工具自动化登录内部系统抓取报表并本地生成报告，彻底释放人力且无需担心 API 账单超标。
QA
- 为什么说这个工具能实现“无限免费 API Token”调用？
项目底层并不调用各大模型按 Token 计费的官方开发者接口。它通过启动带有调试端口的 Chrome 浏览器，利用脚本截获您在网页版正常登录后的 Cookie 和 Bearer Token。随后，网关会利用这些凭证直接请求官方 Web 端的隐藏接口。由于网页端对普通用户大多是免费的，因此您驱动本地智能体也就变成了零成本。 - 当前版本具体支持哪些大语言模型平台？
目前已通过全面测试并原生支持的平台包括：DeepSeek Web、通义千问（含国际版与国内版）、Kimi、Claude Web、豆包、ChatGPT Web、Gemini Web、Grok Web、智谱清言（含国际版）以及 Manus API 等。后续社区也会通过增加认证模块和流处理器持续扩展新平台。 - 本地工具（Tool Calling）在网页版免 API 模式下是如何实现的？
由于大部分平台的网页端接口原生并不支持标准的 tools 字段回调，本项目创新性地采用了“系统提示词注入 XML 工具说明 + 流式解析<tool_call>标签”的技术。模型在回答时会按照特定的 XML 格式输出操作意图，系统捕获该标签后在本地执行相应的终端命令或文件读写，最后将结果传回给模型继续生成，从而在网页端完美模拟了原生 API 的函数调用能力。 - 会话过期了怎么办？系统安全吗？
由于利用的是网页端的 Cookie 会话，存在一定的有效期，如果长时间不用可能会过期，届时只需重新执行./onboard.sh webauth刷新凭证即可（开发路线图中已计划加入过期会话自动刷新功能）。安全性方面，获取到的凭证仅保存在本地.openclaw-zero-state目录下的敏感文件中（如auth.json），绝对不会上传到云端或 Git 仓库。
