若无法通过语音或指令调用gmail收件箱管理、日历事件创建等功能,说明google相关skill未正确配置。需通过clawhub cli一键安装授权、手动配置oauth凭据、自然语言指令触发自动配置三种方式之一完成接入,并重启服务后在控制台验证技能状态为active且测试指令响应正常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已部署 OpenClaw,但无法通过语音或指令调用 Gmail 收件箱管理、日历事件创建等能力,则说明 Google 相关 Skill 尚未正确配置。以下是完成 OpenClaw 与 Gmail、Google 日历服务接入的多种可行方法:
一、使用 ClawHub CLI 一键安装并授权
该方法适用于熟悉终端操作、希望快速启用标准化 Google 集成技能的用户。它将自动拉取经社区验证的 gog 技能(支持 Gmail、Calendar、Drive 三合一),并引导完成 OAuth 流程。
1、确保已全局安装 ClawHub CLI:npm i -g clawhub --registry https://registry.npmmirror.com
2、执行安装命令:clawhub install gog
3、运行授权初始化:gog auth credentials ~/.openclaw/credentials/google_client_secret.json(需提前准备凭证文件)
4、绑定邮箱账户:gog auth add yourname@gmail.com --services gmail,calendar
5、在终端提示的 URL 页面完成 Google 账户登录与权限确认,将跳转后地址栏中 code= 后的字符串完整复制粘贴回终端
二、手动配置 OAuth 凭据并注入 OpenClaw
该方法适用于需要精细控制访问范围、或在受限网络环境下离线部署的场景。您需自行在 Google Cloud Console 创建项目并生成客户端密钥,确保仅授予最小必要权限。
1、访问 Google Cloud Console,新建项目或选择已有项目
2、在 API 库中搜索并启用 Gmail API 与 Google Calendar API
3、进入“OAuth 同意屏幕”,User Type 选择 External,添加作用域:https://www.googleapis.com/auth/gmail.readonly 和 https://www.googleapis.com/auth/calendar.events
4、在“凭据”页面创建 OAuth 客户端 ID,应用类型选 Desktop application,下载 JSON 文件并重命名为 google_client_secret.json
5、将该文件放入 ~/.openclaw/credentials/ 目录(若目录不存在请手动创建)
6、执行命令注入:openclaw approvals allowlist add "$(command -v gog)"
三、通过自然语言指令触发自动配置
该方法专为不熟悉命令行的新手设计,依赖 OpenClaw 内置的指令解析与技能调度能力,全程在 Chat 界面内完成,无需打开终端。
1、在 OpenClaw 对话窗口中发送:“请帮我连接我的 Gmail 和 Google 日历账户”
2、等待系统识别意图并返回确认提示,回复 “是” 或点击弹出按钮
3、系统将自动生成临时 OAuth 授权链接,并以可点击形式展示在消息中
4、点击链接,在 Google 登录页选择对应账号,勾选所需权限项后确认
5、授权成功后页面将显示 “Authorization successful. You may close this window.”,此时 OpenClaw 自动完成凭据存储与服务注册
四、验证服务连通性并启用技能
无论采用以上哪种方式完成配置,均需执行本地验证步骤,确保 OpenClaw 已获得有效访问令牌且技能处于激活状态,避免因过期或权限变更导致后续调用失败。
1、重启 OpenClaw 服务:pm2 restart openclaw(若使用 pm2)或关闭后重新运行启动脚本
2、进入 OpenClaw 控制台界面(通常为 http://localhost:3000),切换至 Skills 管理页
3、查找名称为 gog 或 google-integration 的技能条目,确认其状态显示为 active
4、在 Chat 输入框中发送测试指令:“查看我今天上午10点的日历事件”
5、观察响应内容是否包含真实日历条目;若返回错误提示,请检查终端日志中关于 token_expired 或 insufficient_scope 的关键词











