困了就有枕头， 龙虾养不起，无意间发现Google Cloud注册送的$快过期了，本以为是简单的apikey密钥配置，结果......
本文档记录了在Windows下wsl中 Ubuntu 系统上安装 Google Cloud SDK、配置身份验证、创建 systemd 用户服务以及将Vertex AI模型在OpenClaw使用的主要操作复盘。
1. 更新软件包索引
sudo apt-get update
说明：更新本地软件包列表，确保后续安装使用最新的软件源信息。
2. 安装必要依赖
sudo apt-get install apt-transport-https ca-certificates gnupg curl
说明：
apt-transport-https：使 APT 支持 HTTPS 源ca-certificates：提供 SSL 证书gnupg：用于 GPG 密钥管理curl：用于下载文件
3. 添加 Google Cloud 的 GPG 密钥
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
说明：下载 Google Cloud 的 GPG 公钥，并将其转换为二进制格式保存到 /usr/share/keyrings/cloud.google.gpg，用于后续验证软件包签名。
4. 添加 Google Cloud SDK 软件源
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
说明：将 Google Cloud SDK 的 APT 仓库添加到系统中，并指定使用上一步保存的 GPG 密钥。
5. 安装 Google Cloud CLI
sudo apt-get update && sudo apt-get install google-cloud-cli
说明：更新软件包列表（包含新添加的 Google Cloud 仓库），然后安装 Google Cloud CLI 及其可选组件。
6. 验证安装
gcloud version
说明：查看已安装的 gcloud 版本，确认安装成功。
7. 配置应用默认凭据（Application Default Credentials）
gcloud auth application-default login
说明：通过浏览器完成 OAuth2 授权，生成应用默认凭据，保存到 ~/.config/gcloud/application_default_credentials.json。此凭据可供 Google 客户端库使用。
8. 设置配额项目
gcloud auth application-default set-quota-project project-xxxxxx
说明：为应用默认凭据关联一个 Google Cloud 项目 ID，用于 API 配额和计费跟踪。
9. 创建用户级 systemd 服务单元
nano /home/rory2/.config/systemd/user/openclaw-gateway.service
说明：编辑用户服务配置文件。请根据实际需求填写服务内容（例如 ExecStart 指定启动命令）。
Environment="GOOGLE_CLOUD_PROJECT=project-xxxxx"
Environment="GOOGLE_CLOUD_LOCATION=us-central1"
Environment="GOOGLE_APPLICATION_CREDENTIALS=/home/rory2/.config/gcloud/application_default_credentials.json"
10. 重新加载 systemd 用户配置
systemctl --user daemon-reload
说明：通知 systemd 重新加载所有用户服务单元，使刚才的修改生效。
11. 重启 openclaw-gateway 服务
systemctl --user restart openclaw-gateway.service
说明：重启服务，使最新配置或环境变量生效。
12. 查看服务日志
journalctl --user -u openclaw-gateway.service -f -n 50
说明：显示服务最近 50 条日志，并持续输出新日志，用于排查问题或确认服务正常运行。
13. 登录 gcloud 并设置活动账户
gcloud auth login
说明：通过浏览器登录 Google 账户，使 gcloud 命令获得访问云资源的权限。
如果之前已登录但遇到权限问题，此步骤是必要的。
14. 查询 Vertex AI 模型（验证权限）
gcloud ai models list --project=project-xxxxxx --region=us-central1
说明：列出指定项目在 us-central1 区域的 AI 模型。输出 Listed 0 items. 表示当前没有模型，但命令执行成功，证明认证和权限配置正确。 这里没有，算了，我们自己去平台上找两个。
15. 编辑 OpenClaw 网关配置文件
vim openclaw.json
说明：使用 vim 编辑 openclaw.json 配置文件。请根据 OpenClaw 网关的文档填写相关配置（如监听端口、后端服务地址、认证信息等）。
"agents": {
"defaults": {
"models": {
"custom-api-siliconflow-cn/Qwen/Qwen3.5-397B-A17B": {
"alias": "siliconflow",
"streaming": true
},
"google/gemini-2.0-flash": {
"streaming": true
},
// 【重点】这里直接配置,相当于就是内置了
"google-vertex/gemini-2.5-flash": {
"streaming": true
}
}
}
}
不放心的话再加点
"env": {
"GOOGLE_CLOUD_PROJECT": "project-xxxxxxxxxx",
"GOOGLE_CLOUD_LOCATION": "us-central1",
"GOOGLE_APPLICATION_CREDENTIALS": "/home/rory2/.config/gcloud/application_default_credentials.json"
}
16. 运行 OpenClaw 网关
openclaw gateway run
说明：启动 OpenClaw 网关，通常它会读取当前目录下的 openclaw.json 配置文件。该命令可在前台运行，也可结合 systemd 服务实现后台运行。
总结
以上步骤完成了从安装 Google Cloud SDK、配置身份验证，到设置 OpenClaw 网关服务并运行的全过程。所有命令均已按顺序列出，部分编辑器操作留空待用户根据实际环境填写。
