手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！ OpenClaw 最近热度很高，但它简直就是个“吃 Token 狂魔”。要是你心疼钱，不想烧昂贵的 Token，纯粹想搭起来玩玩，那 Google 每天送给开发者的免费额度可别浪费了，这篇教程就是专门教你咋薅羊毛的。 这篇文章借鉴了 gemini-cli-openai 项目的思路，简单说就是给 Google 的 Gemini Code Assist 披上一层 OpenAI 的“马甲”，然后喂给 OpenClaw 用，仅供咱们技术圈内部交流哈！ 至于机器人选啥，我强烈建议用 Telegram，功能比较全乎。QQ 机器人现在的限制实在太多了，虽然也能凑合用，但体验不如 TG。 手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
✅ 搞起前的准备
第一步：拿到 Google 的“通行证” (在你自己电脑上弄)
因为 VPS 一般都没装浏览器，所以咱们得先在自己电脑上登录，把凭证搞到手。
npm install -g @gemini-cli/cli
gemini login
这时候浏览器会自动弹出来，你登一下 Google 账号并点个授权。
- Windows 用户看这: C:\\Users\\你的用户名\\.gemini\\oauth_creds.json
- Mac/Linux 用户看这: ~/.gemini/oauth_creds.json 打开这个 JSON 文件，把里面的东西全复制下来。
- *特别提醒*：把这一大坨 JSON 弄成一行（就是把换行符都删了），待会儿要用的。 手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
第二步：设置 Google Cloud 项目
很多教程把这一步漏了，结果弄到最后老报 403 或者 Project ID 错误。咱必须得手动建个项目，顺便把 API 开关打开。
- 点这个链接去 API 启用页面： Gemini for Google Cloud API 。
- 进去之后，对着那个蓝色的 “启用 (ENABLE)” 按钮狠点一下。 手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
第三步：把中间件跑起来 (在 VPS 上弄)
现在连上你的 VPS，咱们部署 gemini-cli-openai，把 Gemini 转换成 OpenAI 那种格式。
git clone https://github.com/GewoonJaap/gemini-cli-openai.git
cd gemini-cli-openai
npm install
vim .dev.vars
往里填这些东西： 展开 代码语言：JavaScript 自动换行 AI代码解释
# 1. 你刚才搞到的登录凭证（第一步里那串 JSON，记得要压成一行）
GCP_SERVICE_ACCOUNT={"token_type":"Bearer","access_token":…}
# 2. 你的项目 ID（第二步里记下来的那个）
GEMINI_PROJECT_ID=你的项目ID
[手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！](https://blog.csdn.net/weixin_49598732/article/details/158127334)
# 3. 自定义连接密码（随便填，但后面得对得上）
OPENAI_API_KEY=sk-123456
nohup npx wrangler dev –ip 127.0.0.1 –port 8787 > wrangler.log 2>&1 &
验证是否启动：运行 tail -f wrangler.log，如果看到 Ready on http://127.0.0.1:8787 那就稳了。 这时候你也可以写个 python 脚本，发个 requests 请求测试一下通不通。
第四步：改一下 OpenClaw 的配置
最后一步，咱们得去改改 OpenClaw 的配置文件，让它去连咱们刚搭好的本地中转站。 配置文件在这：/root/.openclaw/openclaw.json 请把下面这两个核心部分直接覆盖过去（别的插件配置别动）： 手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
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
}
}
},
手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
第五步：验收成果
上面都搞定后，回到腾讯云控制台，把网关重启一下。就能用了。 
手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
常见疑难杂症 (FAQ)
- 报错 Unknown model: anthropic/gemini-xxx
- 咋回事：agents 配置里光写了 gemini-xxx，没加供应商前缀。
- 咋整：改成 "primary": "openai/gemini-2.5-flash" 就行。
- 报错 Stream request failed: 403
- 咋回事：Project ID 对应的项目没开 API，或者你用了 AI Studio 自动生成的那个受限 Project ID。
- 咋整：去 Google Cloud Console 新建个正经项目，然后把 “Gemini for Google Cloud API” 启用。
- 手把手教你一键部署OpenClaw，连接微信、QQ、飞书、钉钉等，1分钟全搞定！
