【教程】零成本白嫖 ClawdBot ：Gemini CLI + 本地中转方案
修改于 2026-02-06 15:25:29
1.7K0
举报
概述
OpenClaw最近很火，但是却是一个十足的token吞金兽，如果你不想消耗昂贵的 token，只想部署玩玩，利用 Google 每天提供给开发者的免费请求额度，这篇教程就是为你准备的。
文章被收录于专栏：python与大数据
前言
OpenClaw最近很火，但是却是一个十足的token吞金兽，如果你不想消耗昂贵的 token，只想部署玩玩，利用 Google 每天提供给开发者的免费请求额度，这篇教程就是为你准备的。
本文参考 gemini-cli-openai 项目，把 Google 的 Gemini Code Assist 伪装成 OpenAI 接口，喂给 OpenClaw 使用，仅供技术交流！
- 腾讯云部署OpenClaw的教程已经很详细了，这里不再赘述，可以直接参考：
- 机器人的选择建议是Telegram，功能多一些，qq bot限制比较多，不过也可以使用。
✅ 准备工作
- 一台 VPS（Linux 系统，用于运行 OpenClaw 和中间件）。
- 一台本地电脑（Windows/Mac，用于获取 Google 登录凭证）。
- Google 账号
第一步：获取 Google“通关文牒” (本地操作)
由于 VPS 通常没有浏览器，我们需要先在本地电脑上登录并获取凭证。
- 安装工具：
确保本地有 Node.js，然后运行（这里是在本机运行，不是vps！）：
代码语言：JavaScript
自动换行
AI代码解释
npm install -g @gemini-cli/cli
- 登录：
代码语言：JavaScript
自动换行
AI代码解释
gemini login
这会弹出一个浏览器窗口，登录你的 Google 账号并授权。
- 提取凭证：
登录成功后，找到凭证文件：
- Windows:
C:\Users\你的用户名\.gemini\oauth_creds.json - Mac/Linux:
~/.gemini/oauth_creds.json
打开这个 JSON 文件，复制里面的全部内容。
- 注意：把这一长串 JSON 压缩成一行（去掉换行符），稍后要用。
第二步：配置 Google Cloud 项目
很多教程没提这一步，导致最后报 403 或 Project ID 错误。我们必须手动创建一个项目并开启 API。
- 访问 Google Cloud Console。
- 新建项目：点击左上角项目选择器 -> “新建项目”，随便起个名。
- 获取 Project ID：创建后，记下你的 项目 ID（Project ID），注意是ID，不是项目名称。
- 开启 API：
- 点击链接进入 API 启用页面： Gemini for Google Cloud API 。
- 点击进入，并点击蓝色的 “启用 (ENABLE)” 按钮。
第三步：部署中间件 (VPS 操作)
登录你的 VPS，部署 gemini-cli-openai 将 Gemini 转换为 OpenAI 格式。
- 克隆并安装：
代码语言：JavaScript
自动换行
AI代码解释
git clone https://github.com/GewoonJaap/gemini-cli-openai.git cd gemini-cli-openai npm install
- 创建配置文件
.dev.vars：
这是最关键的一步，必须严格按照格式填写。
代码语言：JavaScript
自动换行
AI代码解释
vim .dev.vars
写入以下内容：
展开
代码语言：JavaScript
自动换行
AI代码解释
# 1. 你的登录凭证（第一步里获取的那串 JSON，保持单行）
GCP_SERVICE_ACCOUNT={"token_type":"Bearer","access_token":...}
# 2. 你的项目 ID（第二步里获取的 ID）
GEMINI_PROJECT_ID=你的项目ID
# 3. 自定义连接密码（随便填，后续要对齐）
OPENAI_API_KEY=sk-123456
- 启动服务（如果服务器重启，这里需要重新运行！）：
使用 nohup 让它在后台运行：
代码语言：JavaScript
自动换行
AI代码解释
nohup npx wrangler dev --ip 127.0.0.1 --port 8787 > wrangler.log2>&1 &
验证是否启动：运行 tail -f wrangler.log，看到 Ready on http://127.0.0.1:8787 即为成功。
此时也可以起一个python脚本，通过requests发送请求验证是否已经走通。
第四步：修改 OpenClaw 配置
最后，我们需要修改 OpenClaw 的配置文件，让它连接我们的本地中转站。
文件路径：/root/.openclaw/openclaw.json
请覆盖修改以下两个核心部分（其他插件配置保持不变）：
1. 修改 models 部分
把原来的 Google 配置删掉，换成 OpenAI 模式：
展开
代码语言：JavaScript
自动换行
AI代码解释
"models": {
"mode": "merge",
"providers": {
"openai": {
"baseUrl": "http://127.0.0.1:8787/v1", // 指向本地中间件"apiKey": "sk-123456", // 对应 .dev.vars 里的密码"api": "openai-completions", // OpenClaw 必须用这个值"models": [
{
"id": "gemini-2.5-flash",
"name": "Gemini 2.5 Flash",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1000000,
"maxTokens": 8192
}
]
}
}
},
2. 修改 agents 部分
这是最容易报错的地方。必须加上 openai/ 前缀，否则 OpenClaw 会误以为是 Anthropic 模型而报错。此外，maxConcurrent建议调小一些，gemini对于并发会有比较严格限制，高并发会导致模型返回失败。
展开
代码语言：JavaScript
自动换行
AI代码解释
"agents": {
"defaults": {
"model": {
"primary": "openai/gemini-2.5-flash"// 前缀必须是openai
},
"models": {
"openai/gemini-2.5-flash": {}
},
// ... 其他配置保持默认 ..."maxConcurrent": 1, // 建议改成1"subagents": {
"maxConcurrent": 2// 建议改成2
}
}
},
第五步：验证
完成上述步骤后，回到腾讯云控制台，重启网关。即可使用
常见问题排查 (FAQ)
- 报错
Unknown model: anthropic/gemini-xxx- 原因：
agents配置里只写了gemini-xxx，没加供应商前缀。 - 解决：改成
"primary": "openai/gemini-2.5-flash"。
- 原因：
- 报错
Stream request failed: 403- 原因：Project ID 对应的项目没有开启 API，或者你用的是 AI Studio 自动生成的受限项目 ID。
- 解决：去 Google Cloud Console 新建项目并启用 “Gemini for Google Cloud API”。
参考：
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。