必须完成Vertex AI服务启用、项目级权限绑定、服务账号密钥生成与OpenClaw侧适配四步闭环；依次开通Vertex AI并绑定结算账号、启用API、为成员添加Vertex AI User和服务使用查看者角色、创建专用服务账号并导出JSON密钥、在openclaw.json中配置google-vertex provider及环境变量。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让企业版账号在Google Cloud中稳定调用Gemini API，必须完成Vertex AI服务启用、项目级权限绑定、服务账号密钥生成与OpenClaw侧适配四步闭环，缺一不可。
开通Vertex AI服务并绑定结算账号
进入Google Cloud Console，确认已登录企业邮箱关联的GCP账号。若尚未创建项目，点击左上角项目下拉菜单→新建项目→输入名称（如enterprise-gemini-prod），系统自动生成Project ID，记下该ID备用。
项目创建后立即进入“结算”页面，点击“绑定结算账号”。【未绑定结算账号将导致所有Vertex AI API调用返回403 SERVICE_DISABLED错误】 企业用户需提供已认证的信用卡或与财务部门对接完成对公付款设置，绑定后状态需显示为“已启用”。
在左侧导航栏点击“API和服务”→“库”，搜索“Vertex AI API”，点击结果项，再点击“启用”。等待状态变为“已启用”后再进行下一步。
为企业成员授予Vertex AI访问权限
此步骤适用于将外部企业邮箱（如zhangsan@company.com）加入项目并赋予权限的场景，不适用于服务账号配置。
访问IAM页面：https://console.cloud.google.com/iam-admin/iam?project=
在“新主账号”栏填入目标企业邮箱，角色搜索框中输入“Vertex AI User”并勾选；【仅分配此角色会导致Vertex AI Studio打不开，必须同步添加Service Usage Viewer角色】 点击“添加另一个角色”，搜索“Service Usage Viewer”并勾选，最后点击“保存”。
创建专用服务账号并导出JSON密钥
这是生产环境唯一推荐的身份认证方式，禁止使用个人账号或API Key。
第一步：进入“IAM和管理”→“服务账号”，点击“创建服务账号”。 第二步：填写名称（如gemini-prod-sa）、ID（自动生成可保留）、描述（如“OpenClaw调用Gemini 3.x模型专用”），点击“继续”。 第三步：在角色页搜索并添加“Vertex AI User”，该权限满足最小调用需求，避免过度授权。 第四步：点击“完成”，返回服务账号列表，找到刚创建的账号，点击右侧“操作”→“管理密钥”→“添加密钥”→“创建新密钥”→选择JSON格式。 第五步：浏览器自动下载一个以项目ID开头的JSON文件（如enterprise-gemini-prod-abc123.json），【该文件即为OpenClaw连接Vertex AI的唯一凭证，不可上传至任何代码仓库或共享群组】。
配置OpenClaw使用google-vertex provider
编辑openclaw.json配置文件，在providers节点下新增google-vertex条目：
"google-vertex": { "project_id": "enterprise-gemini-prod", "location": "us-central1", "model": "gemini-3-flash-preview" }
确保系统环境变量GOOGLE_APPLICATION_CREDENTIALS已指向上一步下载的JSON密钥文件绝对路径，例如Linux下执行：export GOOGLE_APPLICATION_CREDENTIALS="/opt/openclaw/keys/enterprise-gemini-prod-abc123.json”。
重启OpenClaw网关服务，调用接口时provider字段必须显式指定为google-vertex，不可混用google（AI Studio）provider。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
