Google Cloud Vertex AI 接入 OpenClaw 记录

---

困了就有枕头， 龙虾养不起，无意间发现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 网关服务并运行的全过程。所有命令均已按顺序列出，部分编辑器操作留空待用户根据实际环境填写。