若无法通过语音或指令调用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:
2、执行安装命令:
3、运行授权初始化:
(需提前准备凭证文件)
4、绑定邮箱账户:
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
,添加作用域:
和
4、在“凭据”页面创建 OAuth 客户端 ID,应用类型选
Desktop application
,下载 JSON 文件并重命名为
5、将该文件放入
目录(若目录不存在请手动创建)
6、执行命令注入:
OpenClaw
开源的自托管AI智能体助手,曾用名Clawdbot、Moltbot
下载
三、通过自然语言指令触发自动配置
该方法专为不熟悉命令行的新手设计,依赖 OpenClaw 内置的指令解析与技能调度能力,全程在 Chat 界面内完成,无需打开终端。
1、在 OpenClaw 对话窗口中发送:
“请帮我连接我的 Gmail 和 Google 日历账户”
2、等待系统识别意图并返回确认提示,回复
“是”
或点击弹出按钮
3、系统将自动生成临时 OAuth 授权链接,并以可点击形式展示在消息中
4、点击链接,在 Google 登录页选择对应账号,勾选所需权限项后确认
5、授权成功后页面将显示
“Authorization successful. You may close this window.”
,此时 OpenClaw 自动完成凭据存储与服务注册
四、验证服务连通性并启用技能
无论采用以上哪种方式完成配置,均需执行本地验证步骤,确保 OpenClaw 已获得有效访问令牌且技能处于激活状态,避免因过期或权限变更导致后续调用失败。
1、重启 OpenClaw 服务:
(若使用 pm2)或关闭后重新运行启动脚本
2、进入 OpenClaw 控制台界面(通常为
),切换至 Skills 管理页
3、查找名称为
gog
或
google-integration
的技能条目,确认其状态显示为
active
4、在 Chat 输入框中发送测试指令:
“查看我今天上午10点的日历事件”
5、观察响应内容是否包含真实日历条目;若返回错误提示,请检查终端日志中关于
token_expired
或
insufficient_scope
的关键词
npm i -g clawhub --registry https://registry.npmmirror.comclawhub install goggog auth credentials ~/.openclaw/credentials/google_client_secret.jsongog auth add yourname@gmail.com --services gmail,calendarhttps://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/calendar.eventsgoogle_client_secret.json~/.openclaw/credentials/openclaw approvals allowlist add "$(command -v gog)"pm2 restart openclawhttp://localhost:3000