OpenClaw 零令牌

无需 API 令牌即可使用大模型 — 只需通过浏览器登录一次，即可通过统一网关免费调用 ChatGPT、Claude、Gemini、DeepSeek、Qwen（国际版/中文版）、Doubao、Kimi、智谱 GLM、Grok、小米 MiMo、Manus 等众多模型。

许可证：MIT

English | 简体中文

---

目录

• 概述
• 零令牌文档（索引）
• 产品需求（跟踪，中文）
• 上游同步（零令牌）
• Web 模型浏览器模式
• 工作原理
• 快速入门
• 使用方法
• 配置
• 故障排除
• 路线图
• 添加新平台
• 文件结构
• 安全注意事项
• 与上游同步
• 贡献
• 许可证
• 致谢
• 免责声明

---

概述

OpenClaw 零令牌是 OpenClaw 的一个分支，专注于通过驱动官方 Web 界面（浏览器登录）而非付费 API 密钥来 消除 API 令牌费用。

为什么选择零令牌？

传统使用方式	零令牌方式
购买 API 令牌	完全免费
按请求付费	无强制配额
需要信用卡	仅需浏览器登录
API 令牌可能泄露	凭证存储在本地

支持的提供商

提供商	状态	模型（示例）
DeepSeek	✅ 已测试	deepseek-chat, deepseek-reasoner
Qwen 国际版	✅ 已测试	Qwen 3.5 Plus, Qwen 3.5 Turbo
Qwen 中国版	✅ 已测试	Qwen 3.5 Plus, Qwen 3.5 Turbo
Kimi	✅ 已测试	Moonshot v1 8K / 32K / 128K
Claude Web	✅ 已测试	claude-sonnet-4-6, claude-opus-4-6, claude-haiku-4-6
Doubao	✅ 已测试	doubao-seed-2.0, doubao-pro
ChatGPT Web	✅ 已测试	GPT-4, GPT-4 Turbo
Gemini Web	✅ 已测试	Gemini Pro, Gemini Ultra
Grok Web	✅ 已测试	Grok 1, Grok 2
GLM Web (Zhipu)	✅ 已测试	glm-4-Plus, glm-4-Think
GLM Web (国际版)	✅ 已测试	GLM-4 Plus, GLM-4 Think
小米 MiMo	✅ 已测试	MiMo 2.0, MiMo 2.5 Pro
Manus API	✅ 已测试	Manus 1.6, Manus 1.6 Lite (API 密钥，免费配额)

工具调用

Web 模型可以通过提示中注入的工具定义，调用 本地工具（web_search、web_fetch、exec、read、write、message）。该功能基于 arXiv:2407.04997 和 ComfyUI LLM Party（5k+ 星）。

11/13 个 Web 模型支持工具调用（已验证）：

模型	工具调用	对话	备注
DeepSeek	✅	✅	exec: 列出桌面文件
Kimi	✅	✅	所有 6 种工具均已验证
Claude	✅	✅	web_search 正常
ChatGPT	✅	✅	web_search 正常
Qwen CN	✅	✅	web_search 正常
Qwen Web	✅	✅	web_search 正常
Grok	✅	✅	web_search 正常
Gemini	✅	⚠️	web_search 正常，但 DOM 轮询不稳定
小米 MiMo	✅	✅	web_search 正常
GLM	✅	✅	工具调用和对话均正常
GLM Intl	✅	✅	工具调用和对话均正常
Doubao	❌	⚠️	被排除（流解析器限制）
Perplexity	—	✅	搜索引擎，无工具注入

中间件（src/zero-token/tool-calling/）仅在用户消息中的关键词提示需要执行工具操作时才会注入工具提示——正常的对话会保持简短，以降低被封禁的风险。

代理对文件的访问受到配置的 工作目录 限制（参见 agents.defaults.workspace）。

额外功能

AskOnce：一次提问，所有模型回答。
AskOnce 可以将单个查询广播到多个已配置的提供商，并并排显示它们的回答。

---

工作原理

高级架构

┌─────────────────────────────────────────────────────────────────────────────┐
│                              OpenClaw 零token                            │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐  │
│  │   Web UI    │    │  CLI/TUI    │    │   Gateway   │    │  Channels   │  │
│  │  (Lit 3.x)  │    │             │    │  (Port API) │    │ (Telegram…) │  │
│  └──────┬──────┘    └──────┬──────┘    └──────┬──────┘    └──────┬──────┘  │
│         │                  │                  │                  │          │
│         └──────────────────┴──────────────────┴──────────────────┘          │
│                                    │                                         │
│                           ┌────────▼────────┐                               │
│                           │   Agent Core    │                               │
│                           │  (PI-AI Engine) │                               │
│                           └────────┬────────┘                               │
│                                    │                                         │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │  提供者层                                                       │  │
│  │  DeepSeek Web (零token)                                       ✅   │  │
│  │  Qwen Web intl/cn (零token)                                  ✅   │  │
│  │  Kimi (零token)                                              ✅   │  │
│  │  Claude Web (零token)                                        ✅   │  │
│  │  Doubao (零token)                                            ✅   │  │
│  │  ChatGPT Web (零token)                                       ✅   │  │
│  │  Gemini Web (零token)                                        ✅   │  │
│  │  Grok Web (零token)                                          ✅   │  │
│  │  GLM Web (零token)                                           ✅   │  │
│  │  Xiaomi MiMo (零token)                                       ✅   │  │
│  │  Manus API (有token)                                          ✅   │  │
│  └───────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

DeepSeek 认证流程（示例）

1. 启动浏览器
   openclaw 网关  ──▶  Chrome (CDP: 18892, user-data-dir)

2. 用户登录
   浏览器  ──▶  https://chat.deepseek.com  (扫码 / 密码登录)

3. 捕获凭据
   Playwright CDP  ──▶  监听网络请求
                    └─▶ 截取 Authorization 头部 + cookies

4. 存储凭据
   auth.json  ◀──  { cookie, bearer, userAgent }

5. 调用 web API
   DeepSeek WebClient  ──▶  DeepSeek Web API  ──▶  chat.deepseek.com
   (复用已存储的 cookie + bearer token)

---

快速入门

支持平台

• 🍎 macOS / 🐧 Linux: 请按照 START_HERE.md 的步骤操作；完整安装与配置请参阅 INSTALLATION.md。
• 🪟 Windows: 使用 WSL2，然后按照 Linux 步骤操作。安装 WSL2：wsl --install，详情请见：https://docs.microsoft.com/windows/wsl/install

系统要求

• Node.js >= 22.12.0
• pnpm >= 9.0.0
• Chrome 浏览器
• 操作系统：macOS、Linux 或 Windows（通过 WSL2）

辅助脚本（首次及日常使用）

首次：
  1. 构建          pnpm install && pnpm build && pnpm ui:build
  2. 启动 Chrome   ./start-chrome-debug.sh
  3. 登录网站      Qwen intl/cn、Kimi、DeepSeek、…
  4. 上手          ./onboard.sh webauth
  5. 启动服务器    ./server.sh

日常：
  start-chrome-debug.sh → onboard.sh → server.sh
  server.sh [start|stop|restart|status] 用于管理网关服务

脚本概览（核心三脚本）：

脚本	用途	使用时机
start-chrome-debug.sh	以调试模式启动 Chrome	第二步：在端口 9222 打开浏览器，用于登录与上手
onboard.sh	认证/上手向导	第四/五步：选择提供商（如 deepseek-web）并捕获凭据
server.sh	管理网关服务	第五步及日常使用：start / stop / restart / status 在端口 3001

安装

克隆并构建

git clone https://github.com/linuxhsj/openclaw-zero-token.git
cd openclaw-zero-token
pnpm install
pnpm build
pnpm ui:build

配置认证

# 以调试模式启动 Chrome（保持此终端打开）
./start-chrome-debug.sh

# 在打开的浏览器标签页中登录各个 web 模型
# （DeepSeek、Qwen、Kimi、Claude、ChatGPT、Gemini、Grok 等）

# 在一个新的终端中运行认证向导
./onboard.sh webauth

启动网关

./server.sh

在终端打印的 URL 中打开 Web UI。

清理重建（若出现 ERR_MODULE_NOT_FOUND 错误）

rm -rf dist dist-runtime node_modules
pnpm install
pnpm build
pnpm ui:build
./server.sh restart

注意： 始终使用 pnpm build（而非 npm run build）。如果遇到类似 Cannot find module dist/xxx-HASH.js 的哈希不匹配错误，请按上述方法进行清理重建。

第三步：启动网关

./server.sh

这将启动 HTTP 网关和 Web UI。

---

使用说明

Web UI

执行 ./server.sh 后，Web UI 会自动启动。在浏览器中打开即可与任何已配置的模型进行对话。

切换模型

在聊天框内使用 /model 命令：

# 切换到 Claude Web
/model claude-web

# 切换到 Doubao
/model doubao-web

# 切换到 DeepSeek
/model deepseek-web

# 或者指定确切的模型
/模型 claude-web/claude-sonnet-4-6
/模型 doubao-web/doubao-seed-2.0
/模型 deepseek-web/deepseek-chat

Claude Web: 最好使用完整的模型 ID：/model claude-web/claude-sonnet-4-6（与目录默认值一致）。单独使用 /model claude-web 在某些设置中可能无法解析或选择到预期的模型。

列出可用模型

/models

重要提示： 只有通过 ./onboard.sh webauth 配置的提供商才会被写入 openclaw.json，并显示在 /models 中。

输出内容包括：

• 所有可用的提供商（例如 claude-web、doubao-web、deepseek-web）
• 每个提供商下的模型
• 当前激活的模型
• 别名和配置

示例：

模型                                      输入      上下文      本地认证  标签
doubao-web/doubao-seed-2.0                 文本       63k      否    否    默认,已配置,别名:Doubao 浏览器
claude-web/claude-sonnet-4-6         文本+图像 195k     否    否    已配置,别名:Claude Web
deepseek-web/deepseek-chat                 文本       64k      否    否    已配置

HTTP API

curl http://127.0.0.1:3001/v1/chat/completions \
  -H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-web/deepseek-chat",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

CLI / TUI

node openclaw.mjs tui

---

配置

示例 openclaw.json

{
  "auth": {
    "profiles": {
      "deepseek-web:default": {
        "provider": "deepseek-web",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "providers": {
      "deepseek-web": {
        "baseUrl": "https://chat.deepseek.com",
        "api": "deepseek-web",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 64000,
            "maxTokens": 4096
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner",
            "reasoning": true,
            "contextWindow": 64000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "gateway": {
    "port": 3001,
    "auth": {
      "mode": "token",
      "token": "your-gateway-token"
    }
  }
}

---

故障排除

首次运行：使用引导向导（推荐）

./onboard.sh webauth

该向导将创建所有必要的目录和基础文件。

修复问题：doctor 命令

如果您已经运行过该项目，但遇到缺少目录或其他类似错误：

node dist/index.mjs doctor

doctor 命令将执行以下操作：

• ✅ 检查所有必需的目录
• ✅ 创建缺失的目录
• ✅ 修复常见的权限问题
• ✅ 验证配置文件结构
• ✅ 检测多个冲突的状态目录
• ✅ 输出详细的建议

局限性：

• ❌ 不会创建 openclaw.json
• ❌ 不会创建 auth-profiles.json
• ✅ 如果这些文件缺失或损坏，请重新运行 ./onboard.sh webauth

---

路线图

当前重点

• ✅ DeepSeek Web、Qwen 国际版/中文版、Kimi、Claude Web、Doubao、ChatGPT Web、Gemini Web、Grok Web、GLM Web、GLM 国际版、小米 MiMo、Manus API — 全部已测试
• 🔧 提升凭证捕获的鲁棒性
• 📝 改进文档

计划中

• 🔜 自动刷新过期的网页会话

---

添加新平台

要添加新的网络提供商，通常需要：

1. 认证模块 (src/zero-token/providers/{platform}-web-auth.ts)

export async function loginPlatformWeb(params: {
  onProgress: (msg: string) => void;
  openUrl: (url: string) => Promise<boolean>;
}): Promise<{ cookie: string; bearer: string; userAgent: string }> {
  // 自动化浏览器登录并捕获凭证
}

2. API 客户端 (src/zero-token/providers/{platform}-web-client*.ts)

export class PlatformWebClient {
  constructor(options: { cookie: string; bearer?: string }) {}

  async chatCompletions(params: ChatParams): Promise<ReadableStream> {
    // 调用平台的网页 API
  }
}

3. 流处理程序 (src/zero-token/streams/{platform}-web-stream.ts) 并将其注册到 web-stream-factories.ts

export function createPlatformWebStreamFn(credentials: string): StreamFn {
  // 处理提供商特定的流格式
}

---

文件结构

openclaw-zero-token/
├── src/
│   ├── zero-token/
│   │   ├── providers/                    # 网页客户端 + *-web-auth.ts
│   │   └── streams/                      # *-web-stream.ts + web-stream-factories.ts
│   ├── agents/
│   │   └── web-stream-factories.ts       # 重新导出（供运行时稳定导入）
│   ├── commands/
│   │   └── auth-choice.apply.deepseek-web.ts  # 认证流程
│   └── browser/
│       └── chrome.ts                     # Chrome 自动化
├── ui/                                   # 网页 UI（Lit 3.x）
├── .openclaw-zero-state/                 # 本地状态（忽略）
│   ├── openclaw.json                     # 配置
│   └── agents/main/agent/
│       └── auth.json                     # 凭证（敏感）
└── .gitignore                            # 包含 .openclaw-zero-state/

---

安全注意事项

1. 凭证存储：Cookie 和 Bearer 令牌存储在本地的 auth.json 中，绝不能提交到版本库。
2. 会话生命周期：网页会话会过期，您可能需要不时重新登录。
3. 速率限制：网页端点可能会实施速率限制，不适合用于高负载的生产环境。
4. 合规性：该项目仅用于个人学习和实验。请始终遵守各平台的服务条款。

---

与上游 OpenClaw 同步

有关零令牌专用文件清单和合并指南，请参阅 上游同步（零令牌）。

本项目基于 OpenClaw。要同步上游更改：

git remote add upstream https://github.com/openclaw/openclaw.git
git fetch upstream
git merge upstream/main

---

贡献

欢迎提交 PR，尤其是针对以下方面：

• 错误修复
• 文档改进

---

许可证

MIT 许可证

---

致谢

• OpenClaw — 原始项目
• DeepSeek — 优秀的 AI 模型

---

免责声明

本项目仅供学习和研究使用。
在使用它访问任何第三方服务时，您有责任遵守该服务的使用条款。
作者对因滥用本项目而引起的任何问题概不负责。

OpenClaw Zero Token 快速上手指南

OpenClaw Zero Token 是一个开源工具，允许你无需购买 API Token，通过浏览器登录一次后，即可免费调用 ChatGPT、Claude、DeepSeek、Kimi、通义千问等主流大模型。它通过统一网关驱动官方网页版 UI，实现零成本使用。

环境准备

系统要求

• 操作系统：macOS、Linux 或 Windows (需使用 WSL2)
• Node.js: >= 22.12.0
• 包管理器: pnpm >= 9.0.0
• 浏览器: Google Chrome (用于捕获登录凭证)

Windows 用户注意：请先安装 WSL2。

wsl --install

安装完成后，在 WSL2 环境中执行后续所有步骤。

前置依赖检查

确保已安装指定版本的 Node.js 和 pnpm：

node -v  # 应 >= v22.12.0
pnpm -v  # 应 >= v9.0.0

安装步骤

1. 克隆与构建

拉取代码并安装依赖（推荐使用国内镜像源加速）：

# 克隆仓库
git clone https://github.com/linuxhsj/openclaw-zero-token.git
cd openclaw-zero-token

# 设置国内镜像源 (可选，加速安装)
pnpm config set registry https://registry.npmmirror.com

# 安装依赖并构建项目
pnpm install
pnpm build
pnpm ui:build

2. 启动调试浏览器

运行脚本启动处于调试模式的 Chrome 浏览器。请保持该终端窗口开启。

./start-chrome-debug.sh

此时会自动打开一个 Chrome 窗口，监听端口 9222。

3. 手动登录模型

在自动打开的 Chrome 浏览器中，依次访问并登录你需要使用的模型官网：

• DeepSeek: https://chat.deepseek.com
• 通义千问 (国际/国内): https://tongyi.aliyun.com
• Kimi: https://kimi.moonshot.cn
• Claude: https://claude.ai
• ChatGPT: https://chat.openai.com
• 其他支持的模型...

注意：必须完成网页版的登录验证（扫码或密码），确保能正常对话。

4. 捕获凭证 (Onboarding)

打开一个新的终端窗口，运行授权向导以捕获刚才登录的 Cookie 和 Token：

./onboard.sh webauth

按提示选择需要配置的提供商（例如 deepseek-web），脚本将自动提取凭证并保存至本地 auth.json。

5. 启动服务网关

配置完成后，启动主服务：

./server.sh

终端会显示 Web UI 的访问地址（通常为 http://localhost:3001）。

若遇到模块丢失错误 (ERR_MODULE_NOT_FOUND)，请执行清理重建：

rm -rf dist dist-runtime node_modules
pnpm install && pnpm build && pnpm ui:build
./server.sh restart

基本使用

通过 Web UI 对话

在浏览器中打开 server.sh 输出的地址，即可看到聊天界面。

切换模型

在聊天输入框中输入 /model 命令即可切换后端模型：

# 切换到 DeepSeek
/model deepseek-web

# 切换到 Kimi
/model kimi-web

# 切换到通义千问
/model qwen-cn-web

# 指定具体模型版本 (推荐)
/model claude-web/claude-sonnet-4-6
/model doubao-web/doubao-seed-2.0

查看可用模型列表

输入以下命令查看当前已配置且可用的所有模型：

/models

注：只有通过 ./onboard.sh webauth 成功捕获凭证的模型才会出现在列表中。

多模型同时回答 (AskOnce)

该工具支持“一次提问，多方回答”模式。配置多个模型后，可在界面上启用 AskOnce 功能，并行获取不同模型的回复进行对比。

---

日常使用流程： 每天使用时，只需依次运行：

1. ./start-chrome-debug.sh (保持后台运行)
2. ./server.sh (启动服务) (若浏览器未关闭且登录态有效，通常无需重复运行 onboard.sh)