第一步：在 Google Cloud 创建项目并启用 API

进入 Google Cloud Console，创建一个新项目，然后在「API 和服务」→「启用 API」中，把以下几个服务打开：

  • Google Calendar API — 日历读写
  • Google Tasks API — 待办管理
  • Google Fitness API — 睡眠、心率、步数、体重
  • Gmail API — 收发邮件

接着进「凭据」→「创建凭据」→「OAuth 客户端 ID」，应用类型选「桌面应用」。创建完成后下载 JSON 凭证文件——这个文件后面要用，保存好。

第二步：放置凭证文件

把下载的凭证文件重命名，放到 OpenClaw 的配置目录下：

~/.config/openclaw/google-credentials.json

就这一步，配置就结束了。这个设计挺干净的，没有多余的配置项。

第三步：首次授权

运行任意 Google 相关脚本（比如日历或任务），系统会自动打开浏览器跳转到 Google 登录页面。登录并授权后，Token 会自动保存到：

~/.config/openclaw/google-token.json

之后就不用再重复授权了。

权限范围与 Token 管理

系统默认申请的权限包括：日历读写、任务读写、健康数据读取、邮件读取和发送。如果后续需要扩展权限，跑一下对应脚本的 auth 命令重新授权即可。

Token 有效期大概 1 小时，系统会自动刷新，正常使用完全不用管。如果遇到授权失效的情况，删掉 google-token.json 重新走一遍授权流程就能恢复——这一步偶尔会碰到，知道怎么处理就不慌。

接通之后能做什么

打通 Google 全家桶后，你的 AI 助理团队就有了真正可操作的数据源：

  • 日历 — 查看日程、创建会议、智能提醒
  • 任务 — 管理待办事项、自动跟踪进度
  • 健康 — 读取睡眠、心率、步数、体重数据
  • 邮件 — 收发邮件、智能分类

对一人公司来说，这套组合的价值在于：Agent 不再只是一个聊天窗口，而是真正能感知你的日程、追踪你的任务、帮你处理邮件的助手。10 分钟的配置投入，换来的是 AI 助理从「能聊」到「能干活」的跨越。