快速配置
选择适合您环境的设置。
最后验证: 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 规划" 相关的文档。
- 创建一个标题为 "周报" 的新笔记。