OpenClaw Zero Token

免 API Token 使用大模型 - 通过浏览器登录方式免费使用 ChatGPT、Claude、Gemini、DeepSeek、千问国际版、千问国内版、豆包、Kimi、智谱清言、Grok、小米 MiMo、Manus 等 AI 模型。

项目简介

OpenClaw Zero Token 是 OpenClaw 的分支版本，核心目标是免除 API Token 费用，实现对各大 AI 平台的免费访问。

为什么选择 Zero Token？

支持的平台

工具调用支持

Web 模型通过提示词注入实现工具调用（web_search、web_fetch、exec、read、write、message）。基于论文和 ComfyUI LLM Party（5k+ stars）。

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

中间件仅在用户消息包含工具相关关键词时才注入提示词——普通聊天保持短消息，降低封号风险。

Agent 的文件访问范围受配置中的工作区目录限制（见配置项 agents.defaults.workspace）。

补充功能

一次提问，获取所有 AI 模型的答案 — AskOnce 支持同时向多个已配置的 AI 模型发起查询，一次输入即可获得各模型回复。

AskOnce 一次提问多模型回答

实现原理

系统架构

┌─────────────────────────────────────────────────────────────────────────────┐
│                              OpenClaw Zero Token                             │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐  │
│  │   Web UI    │    │  CLI/TUI    │    │   Gateway   │    │  Channels   │  │
│  │  (Lit 3.x)  │    │             │    │  (Port API) │    │ (Telegram…) │  │
│  └──────┬──────┘    └──────┬──────┘    └──────┬──────┘    └──────┬──────┘  │
│         │                  │                  │                  │          │
│         └──────────────────┴──────────────────┴──────────────────┘          │
│                                    │                                         │
│                           ┌────────▼────────┐                               │
│                           │   Agent Core    │                               │
│                           │  (PI-AI Engine) │                               │
│                           └────────┬────────┘                               │
│                                    │                                         │
│  ┌───────────────────────────────────────────────────────────────────────┐  │
│  │  Provider Layer                                                       │  │
│  │  DeepSeek Web (Zero Token)                                       ✅   │  │
│  │  Qwen Web 国际版/国内版 (Zero Token)                              ✅   │  │
│  │  Kimi (Zero Token)                                                 ✅   │  │
│  │  Claude Web (Zero Token)                                           ✅   │  │
│  │  Doubao (Zero Token)                                              ✅   │  │
│  │  ChatGPT Web (Zero Token)                                         ✅   │  │
│  │  Gemini Web (Zero Token)                                           ✅   │  │
│  │  Grok Web (Zero Token)                                            ✅   │  │
│  │  GLM Web 智谱清言/国际版 (Zero Token)                              ✅   │  │
│  │  Xiaomi MiMo (Zero Token)                                         ✅   │  │
│  │  Manus API (Token)                                                ✅   │  │
│  └───────────────────────────────────────────────────────────────────────┘  │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

流程图

┌────────────────────────────────────────────────────────────────────────────┐
│                        DeepSeek Web 认证流程                                │
├────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  1. 启动浏览器                                                              │
│     ┌─────────────┐                                                        │
│     │ openclaw    │ ──启动──▶ Chrome (CDP Port: 18892)                     │
│     │ gateway     │           带用户数据目录                                │
│     └─────────────┘                                                        │
│                                                                             │
│  2. 用户登录                                                                │
│     ┌─────────────┐                                                        │
│     │ 用户在浏览器 │ ──访问──▶ https://chat.deepseek.com                    │
│     │ 中手动登录  │           扫码/账号密码登录                             │
│     └─────────────┘                                                        │
│                                                                             │
│  3. 捕获凭证                                                                │
│     ┌─────────────┐                                                        │
│     │ Playwright  │ ──监听──▶ 网络请求                                     │
│     │ CDP 连接    │           拦截 Authorization Header                    │
│     └─────────────┘           获取 Cookie                                   │
│                                                                             │
│  4. 存储凭证                                                                │
│     ┌─────────────┐                                                        │
│     │ auth.json   │ ◀──保存── { cookie, bearer, userAgent }               │
│     └─────────────┘                                                        │
│                                                                             │
│  5. API 调用                                                                │
│     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐               │
│     │ DeepSeek    │ ──▶ │ DeepSeek    │ ──▶ │ chat.deep-  │               │
│     │ WebClient   │     │ Web API     │     │ seek.com    │               │
│     └─────────────┘     └─────────────┘     └─────────────┘               │
│         使用存储的 Cookie + Bearer Token                                    │
│                                                                             │
└────────────────────────────────────────────────────────────────────────────┘

配置步骤

请按照下面的命令步骤依次执行：

1. 编译：下载项目后执行 npm install && npm run build && pnpm ui:build
2. 打开浏览器调试：运行 ./start-chrome-debug.sh
3. 登录各大网站：在 Chrome 中登录各模型网页版
4. 配置 onboard：运行 ./onboard.sh webauth
5. 启动 server：运行 ./server.sh start

注意事项

• 会话有效期：会话可能定期失效，需重新登录
• 浏览器依赖：需要保持 Chrome 调试模式运行
• 合规使用：仅供个人学习研究，商用请使用官方API

环境要求

• Node.js >= 22.12.0
• pnpm >= 9.0.0
• Chrome 浏览器
• 操作系统: macOS, Linux, 或 Windows (WSL2)

脚本说明

本项目提供了多个辅助脚本，适用于不同场景：

┌─────────────────────────────────────────────────────────────────────┐
│                           脚本关系图                                 │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  首次使用流程：                                                      │
│  ┌──────────────────────────────────────────────────────────────┐  │
│  │ 1. 编译                npm install && npm run build && pnpm ui:build │  │
│  │ 2. 打开浏览器调试       ./start-chrome-debug.sh               │  │
│  │ 3. 登录各大网站         千问国际版/国内版、Kimi 等
│  │ 4. 配置 onboard        ./onboard.sh webauth                  │  │
│  │ 5. 启动 server         ./server.sh start                     │  │
│  └──────────────────────────────────────────────────────────────┘  │
│                                                                      │
│  日常使用：                                                          │
│  ┌──────────────────────────────────────────────────────────────┐  │
│  │ start-chrome-debug.sh → onboard.sh → server.sh start         │  │
│  │ server.sh [start|stop|restart|status]  管理 Gateway          │  │
│  └──────────────────────────────────────────────────────────────┘  │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

脚本对比：（核心 3 个脚本）

使用方式

Web UI

执行 ./server.sh 后会自动启动 Web UI，在聊天界面直接使用 AI 模型。
后续也可以手动访问 http://127.0.0.1:3001/chat?session=62b791625fa441be036acd3c206b7e14e2bb13c803355823

切换模型

在聊天界面中使用 /model 命令可以切换不同的 AI 模型：

# 切换到 Claude Web
/model claude-web

# 切换到豆包
/model doubao-web

# 切换到 DeepSeek
/model deepseek-web

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

Claude Web： 请使用完整模型 ID：/model claude-web/claude-sonnet-4-6（与注册表里的默认模型一致）。仅 /model claude-web 在部分场景下可能无法正确解析或选中目标模型。

查看可用模型

使用 /models 命令可以查看所有已配置的模型：

/models

关键规则： 只有在 ./onboard.sh webauth 中完成配置的平台，才会写入 openclaw.json 并显示在 /models 列表中。

这将显示：

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

示例输出：

Model                                      Input      Ctx      Local Auth  Tags
doubao-web/doubao-seed-2.0                 text       63k      no    no    default,configured,alias:Doubao Browser
claude-web/claude-sonnet-4-6         text+image 195k     no    no    configured,alias:Claude Web
deepseek-web/deepseek-chat                 text       64k      no    no    configured

API 调用

# 使用 Gateway Token 调用
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": "你好！"}]
  }'

配置说明

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

配置向导会自动创建所有必需的文件和目录！

修复问题：使用诊断命令

如果项目已经运行过，但遇到目录或文件缺失问题，运行诊断命令：

node dist/index.js doctor

诊断命令会自动：

• ✅ 检查所有必需的目录
• ✅ 自动创建缺失的目录
• ✅ 修复文件权限问题
• ✅ 检查配置文件完整性
• ✅ 检测多个状态目录冲突
• ✅ 提供详细的修复建议

⚠️ 重要限制：

• ❌ doctor 命令不会创建配置文件（openclaw.json）
• ❌ doctor 命令不会创建认证文件（auth-profiles.json）
• ✅ 如果配置文件缺失或损坏，需要重新运行 ./onboard.sh webauth

何时使用：

• 目录被意外删除
• 遇到”权限被拒绝”错误
• 验证环境是否正常
• 会话历史丢失
• 不适合首次运行（应该用 onboard.sh）

文件结构

openclaw-zero-token/
├── src/
│   ├── zero-token/
│   │   ├── providers/                # Web 客户端与 *-web-auth.ts
│   │   └── streams/                  # *-web-stream.ts 与 web-stream-factories.ts
│   ├── agents/
│   │   └── web-stream-factories.ts   # re-export（runner 稳定 import）
│   ├── commands/
│   │   └── auth-choice.apply.deepseek-web.ts  # 认证流程
│   └── browser/
│       └── chrome.ts                 # Chrome 自动化
├── ui/                               # Web UI (Lit 3.x)
├── .openclaw-zero-state/             # 本地状态 (不提交)
│   ├── openclaw.json                 # 配置
│   └── agents/main/agent/
│       └── auth.json                 # 凭证 (敏感)
└── .gitignore                        # 包含 .openclaw-zero-state/

安全注意事项

1. 凭证存储: Cookie 和 Bearer Token 存储在本地 auth.json，绝不提交到 Git
2. 会话有效期: Web 会话可能过期，需要定期重新登录
3. 使用限制: Web API 可能有速率限制，不适合高频调用
4. 合规使用: 仅用于个人学习研究，请遵守平台服务条款

当然也支持其他云厂商支持cluade或者openai格式的大模型调用

# 添加火山引擎
openclaw config set models.providers.volces '{
    "baseUrl": "https://ark.cn-beijing.volces.com/api/coding/v3",
    "apiKey": "你的code plan key",
    "api": "openai-completions",
    "models": [
      {
        "id": "minimax-m2.5",
        "name": "minimax-m2.5",
        "input": [
          "text",
          "image"
        ]
      }
    ]
  }'
# 将默认模型设置为火山引擎的minimax-m2.5
openclaw config set agents.defaults.model.primary "volces/minimax-m2.5"

openclaw接入 qq

https://q.qq.com/qqbot/openclaw/index.html 手机qq扫码
1.安装OpenClaw开源社区QQBot插件
openclaw plugins install @sliverp/qqbot@latest
2.配置绑定当前QQ机器人
openclaw channels add –channel qqbot –token “机器人号:密钥”
3.重启本地OpenClaw服务
openclaw gateway restart

openclaw-接入个人微信

参考 https://blog.csdn.net/zcl369369/article/details/159352628
重新扫码接入新微信

openclaw channels login --channel openclaw-weixin

免责声明

本项目仅供学习和研究使用。使用本项目访问任何第三方服务时，请确保遵守该服务的使用条款。开发者不对因使用本项目而产生的任何问题负责。