浏览文档
集成
为 OpenClaw 智能体添加 Google 搜索及 YouTube 工具,用于研究与定期简报。
本页内容
开始前
请先安装并运行 OpenClaw。此托管 MCP 配置通过 OAuth 授予 Google 搜索、YouTube 搜索、元数据与转录权限。可在登录时创建 FlashData 账户。
1. 添加 MCP 服务
在运行网关的机器及 OpenClaw 配置档中执行。此命令保存服务配置;下方登录及工具调用会验证智能体能否实际使用。此页所有命令须使用同一配置档。
openclaw mcp set flashdata '{
"url": "https://data.flashdata.dev/mcp",
"transport": "streamable-http",
"auth": "oauth",
"oauth": {
"scope": "mcp:research",
"clientMetadataUrl": "https://api.flashdata.dev/oauth/clients/openclaw.json"
}
}'2. 登录
运行登录命令。在浏览器中登录,或创建并验证账户,然后批准访问。等待终端确认登录完成;查询使用该账户的 Credits。
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe免费检查连接
在控制界面或已连接的聊天渠道开启新对话。发送此提示,两次调用均应成功。仅注册表探测成功不能证明此对话可使用工具。
使用 flashdata MCP 连接。
以 {} 调用 get_balance,以 {"source":"google_search","request_count":1} 调用 get_pricing。
报告可用 Credits 及预估价格,不要执行搜索。3. 运行首个任务
将此提示发送给已连接的智能体。检查免费,单次搜索消耗 Credits。
使用 flashdata MCP 服务,检查我的余额及一次 Google 搜索价格。
余额足够时,调用一次 google_search,query 为 "battery recycling research",num 为 5,mode 为 "realtime"。
提供简短简报,包含来源标题、URL 及摘要。
引用来源并报告实际消耗的 Credits,完成后停止。预期结果
检查 google_search 工具调用是否完成(status: done),来源链接是否来自 results[].organic,回答是否基于这些来源。用量取自 usage.credits,不是结果条数。空结果应如实报告。
可以完成哪些任务
此 OAuth 连接提供研究工具。YouTube 下载通过 API 或 CLI 使用所有者 API Key 及目标存储。
| 任务 | MCP 工具 |
|---|---|
| 为回答或实现查找网页来源 | google_search |
| 查找相关 YouTube 视频 | youtube_search |
| 读取视频标题、频道及元数据 | youtube_metadata |
| 获取视频转录,用于生成摘要 | youtube_transcript |
| 检查可用 Credits 及请求费用 | get_balance · get_pricing |
复用访问执行定时任务
使用已完成首个任务的 OpenClaw 配置与智能体。网关的定时运行须能访问与聊天相同的 MCP 连接和工具权限。
验证已保存访问
在调度环境的新会话中执行此免费检查;两次调用均应成功,无需再次在浏览器登录。
复用已有 flashdata MCP 连接。
以 {} 调用 get_balance,以 {"source":"google_search","request_count":1} 调用 get_pricing。
报告两次调用是否成功,不要搜索或创建新访问。创建定时任务
在宿主调度器中选择时间及时区,例如每天 Asia/Shanghai 时区 09:00。将下方内容作为任务正文,在该环境先执行一次并检查保存的报告,再启用定时运行。
复用已有 flashdata MCP 连接,使用 get_balance 和 get_pricing 检查一次 Google 搜索的余额及价格。
权限与余额足够时,调用一次 google_search,查询 "battery recycling research",num 为 5,mode 为 "realtime"。
保存带日期的报告,包含来源 URL、摘要及实际消耗的 Credits。
访问被撤销或余额不足时停止,遵守 Retry-After。不要创建试用、申请新授权或重复结果不确定的请求。凭据保存与刷新
此配置使用 OpenClaw 操作者的共享 OAuth 连接。获准的聊天参与者与定时任务使用同一 FlashData 账户及余额,不会为每位发送者创建独立账户。
宿主使用轮换刷新令牌刷新一小时有效的 OAuth 访问令牌。90 天授权过期或被撤销后需要重新连接。每个安装实例独立保存令牌,请勿在宿主间共享刷新令牌文件。
撤销或重连
- 暂停定时任务,然后在 FlashData 设置 → Connected apps 撤销对应 OAuth 连接。
- 要求智能体用已保存连接调用一次 get_balance;应返回认证失败或要求重连。检查期间不要批准新的登录。
- 用下方命令移除本地 OAuth 凭据。日后重连时,由所有者批准重复第 2 步,再执行免费连接检查。
openclaw mcp logout flashdata更多配置方式
为 MCP 连接添加工作流技能,或选择 CLI 访问、本地 MCP 服务。
添加 MCP 技能
使用 CLI 技能或开始试用
安装 FlashData CLI v1.2.1,在当前 OpenClaw 工作区运行,并选择一种访问方式。示例使用默认 CLI 配置档,独立于 MCP OAuth;若已有自定义 --profile 和 --state-dir,请在所有命令中保持一致。
通过 Node.js 22.20+ 及 npm 安装下方两个工作流技能,然后开启新 OpenClaw 对话。原生 CLI 的 setup 不支持 OpenClaw 目标。
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligible在隐藏提示中粘贴具有 google_search 权限的密钥。无人值守导入时,从密钥管理器通过管道传给 auth login --api-key-stdin --non-interactive。
flashdata auth login
flashdata auth status --json --non-interactiveflashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive
# 仅在 accessVerified 和 estimateAvailable 均为 true,
# 具有 google_search 权限,且 availableCredits 足以支付 estimatedCredits 时继续。flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# 读取保存的文件:status、results[].organic、usage.credits。
# 终端 JSON 报告输出路径;保留运行 ID 以便恢复。复用已有密钥或试用。若设置了 FLASHDATA_API_KEY,它优先于已保存的密钥;请核对 auth status 显示的账户。
flashdata auth status --json --non-interactiveflashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive
# 仅在 accessVerified 和 estimateAvailable 均为 true,
# 具有 google_search 权限,且 availableCredits 足以支付 estimatedCredits 时继续。flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# 读取保存的文件:status、results[].organic、usage.credits。
# 终端 JSON 报告输出路径;保留运行 ID 以便恢复。复用已有试用或注册一次。若已过期、额度耗尽或被撤销,先恢复或认领。运行定时 CLI 任务前须认领账户,并在 auth status 中确认 recurringAllowed: true。
flashdata init --name "OpenClaw research" --client openclaw --audience personal --scopes google_search --non-interactive
flashdata auth status --json --non-interactiveflashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive
# 仅在 accessVerified 和 estimateAvailable 均为 true,
# 具有 google_search 权限,且 availableCredits 足以支付 estimatedCredits 时继续。flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# 读取保存的文件:status、results[].organic、usage.credits。
# 终端 JSON 报告输出路径;保留运行 ID 以便恢复。通过 API Key 运行本地 MCP
需要 Node.js 22.18+、npm 及具有 google_search 权限的 API Key 来完成首个任务。此方式运行 @flashdata-dev/mcp 0.2.0,不读取 FlashData CLI 保存的密钥或 MCP OAuth 令牌。
在实际运行网关的环境中设置密钥。下方输入提示适用于从终端启动网关的方式;服务或容器须通过其密钥或环境配置注入 FLASHDATA_API_KEY 后重启。其他终端中的环境变量不会更新正在运行的服务。
配置完成后,在新智能体会话中运行上方免费连接检查提示。两项检查通过后,再使用首个任务提示。API Key 访问无需 mcp login。
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEYopenclaw mcp set flashdata '{
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
}
}'
openclaw mcp doctor flashdata --probe# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKeyopenclaw mcp set flashdata '{
"command": "npx.cmd",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
}
}'
openclaw mcp doctor flashdata --probe故障排查
| 问题 | 处理方式 |
|---|---|
| 没有 FlashData 工具 | 运行 openclaw mcp doctor flashdata --probe。检查网关配置及智能体工具策略,再开启新对话。 |
| 技能缺失 | 在当前配置运行 openclaw skills list --eligible 及 openclaw skills check。检查工作区 skills/ 和技能允许列表。 |
| invalid_client / callback | 逐项核对第 1 步,在可访问发起宿主回调的浏览器中完成授权。 |
| 401 | 检查连接或密钥是否已撤销、过期。OAuth 由所有者批准重新登录;CLI 运行 flashdata auth status。充值不能修复认证。 |
| 403 | 检查所请求来源的权限。研究 OAuth 不包含 YouTube 下载,下载须使用 API Key 配置。修复权限后再试。 |
| 402 | 通过 get_balance 或 flashdata account balance 检查余额。在 Billing 增加 Credits 或停止任务;重新登录不会增加额度。 |
| 429 | 遵守 Retry-After 并降低并发。保留当前配置档及注册凭据,不要创建替代试用。 |
| 本地 MCP 无法读取密钥 | 在宿主进程启动环境设置 FLASHDATA_API_KEY 并重启。flashdata auth login 保存的密钥不会自动导出给本地 MCP。 |
| CLI 输出文件已存在 | 读取 ./openclaw-first-search.json。若需再次导出已保存的成功结果,在原配置档执行 flashdata runs show openclaw-first-search-001 --result --output openclaw-first-search-copy.json。仅在有意执行新搜索时使用新的运行 ID。 |
| 定时任务失败 | 在该环境执行免费复用检查,核对系统用户、宿主配置、凭据存储和工具权限。 |
| 超时或结果不确定 | 保留请求或任务 ID,再次提交前检查历史。对返回的续读 ID 使用 get_result。 |
OAuth 验证记录
2026-10-21 在 Windows 上使用 OpenClaw 2026.10.5 验证了 OAuth 登录、回调、凭据保存、免费价格查询、刷新和撤销。该次验证不包含付费查询或定时执行。配置指引于 2026-11-05 对照宿主文档复核。