Google Drive

搜索和读取文档/表格作为您的个人知识库。

分类: 效率
难度: 中等

快速配置

选择适合您环境的设置。

最后验证: 2026-04-27
验证环境: 归档参考服务 @modelcontextprotocol/server-gdrive,使用 OAuth 凭据
安装命令: npx -y @modelcontextprotocol/server-gdrive auth

本地配置

JSON
本地配置 json
{
  "google-drive": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-gdrive"]
  }
}

验证提示词

在我的 Google Drive 中搜索标题包含“meeting notes”的文件,并总结前 3 个匹配项。

成功时应看到

完成 OAuth 后,应看到 Drive 文件匹配结果、文件名或文档片段。

常见陷阱与修复

  • ⚠️ 注意: OAuth 流程复杂性;权限范围;企业策略。
  • 🔑 始终将 API 密钥存储在环境变量中,切勿硬编码在 JSON 中。
  • 🛡️ 如果可用,从只读权限开始,以安全地验证连接。

安全检查

  • 先验证读取/搜索工作流,再考虑任何写入能力。
  • 团队策略允许时,使用专门的 Google 自动化账号,而不是个人主账号。

常见错误

错误 原因 修复方法
Credentials not found 启动服务前没有生成 OAuth 凭据。 先运行 auth 命令,完成浏览器授权,再重启 OpenClaw。
Access blocked Google Workspace 或 OAuth 应用策略阻止了所需权限。 让管理员批准 OAuth 应用,或先用个人测试账号验证。
File not found 账号已认证,但没有目标文件或共享云端硬盘权限。 确认登录的 Google 账号,并把文件共享给该账号。

示例提示词

连接后,尝试这些提示词以测试功能:

  • 列出最新文档并进行总结。
  • 查找与 "Q1 规划" 相关的文档。
  • 创建一个标题为 "周报" 的新笔记。