Jelajahi dokumentasi
Integrasi
Berikan OpenClaw agen Anda Google Search dan alat YouTube untuk penelitian dan recurring briefing.
Di halaman ini
Sebelum Anda mulai
Buat OpenClaw terpasang dan bekerja. Pengaturan MCP ini menggunakan OAuth untuk Google Search, YouTube Search, Metadata, dan Transkrip. Anda dapat membuat akun FlashData selama sign- in.
1. Tambahkan server MCP
Jalankan ini di mesin dan profil OpenClaw yang menjalankan gateway Anda. Ini menyimpan konfigurasi server; panggilan login dan alat di bawah memverifikasi bahwa agen Anda dapat menggunakannya. Gunakan profil yang sama untuk setiap perintah pada halaman ini.
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. Masuk
Jalankan perintah log masuk. Dalam peramban, masuk atau membuat dan memverifikasi sebuah akun, kemudian menyetujui akses. Tunggu terminal untuk mengkonfirmasi login. Kueri menggunakan kredit rekening itu.
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probePeriksa sambungan secara gratis
Buka percakapan baru di Control UI atau saluran obrolan terhubung Anda. Kirim prompt ini; kedua panggilan harus berhasil. Sebuah penyelidikan registri yang sukses saja tidak membuktikan bahwa percakapan ini dapat menggunakan alat.
Gunakan flashdata koneksi MCP.
Hubungi get_balance dengan {} dan get_pricing dengan {"source":"google_search","request_count":1}.
Laporan kredit yang tersedia dan harga perkiraan. Jangan jalankan pencarian.3. Jalankan tugas pertama Anda
Kirim ini ke agen Anda terhubung. Cek gratis; pencarian tunggal menggunakan kredit.
Gunakan flashdata server MCP. Periksa saldo saya dan harga dari satu Google pencarian.
Jika didanai, panggilan google_search sekali dengan query "battery recycling research", num 5 dan mode "realtime".
Beri aku pengarahan singkat dengan judul sumber, URLs dan kutipan.
Sumber Cite dan laporan kredit aktual digunakan. Berhenti setelah tugas ini.Apa yang harus Anda lihat
Cari alat google_search lengkap yang dipanggil dengan status: done, sumber tautan dari results[].organic dan jawaban berdasarkan sumber tersebut. Penggunaan berasal dari usage.credits; ini bukan jumlah hasil. Hasil kosong harus dilaporkan sebagai kosong.
Apa yang dapat Anda minta
Koneksi OAuth ini mencakup alat-alat penelitian. YouTube Download menggunakan pemilik kunci API dan penyimpanan tujuan melalui API atau CLI.
| Tugas | MCP alat |
|---|---|
| Cari sumber web untuk jawaban atau implementasi | google_search |
| Cari video YouTube yang relevan | youtube_search |
| Baca judul video, kanal, dan metadata | youtube_metadata |
| Ambil transkrip video untuk ringkasan | youtube_transcript |
| Periksa kredit yang tersedia dan permintaan biaya | get_balance · get_pricing |
Gunakan kembali akses untuk tugas yang berulang
Gunakan profil dan agen OpenClaw yang melewati tugas pertama. Gateway yang dijadwalkan berjalan harus memiliki koneksi MCP yang sama dan hak alat sebagai obrolan Anda.
Verifikasi akses tersimpan
Jalankan pemeriksaan gratis ini dalam sesi segar di lingkungan yang dijadwalkan. Kedua panggilan harus berhasil tanpa login peramban baru.
Gunakan kembali data kilas yang ada MCP koneksi.
Hubungi get_balance dengan {} dan get_pricing dengan {"source":"google_search","request_count":1}.
Laporkan apakah keduanya berhasil. Jangan cari atau buat akses baru.Buat tugas berulang
Dalam penjadwalan host Anda, pilih zona waktu dan waktu, misalnya sehari-hari di 09:00 Asia/Shanghai. Gunakan ini sebagai tubuh tugas. Jalankan sekali di sana dan periksa laporan tersimpan sebelum mengaktifkan rekurensi.
Gunakan kembali data kilas yang ada MCP koneksi. Periksa get_balance dan get_pricing untuk satu pencarian Google.
Jika diijinkan dan didanai, jalankan google_search sekali untuk "battery recycling research" dengan num 5 dan mode "realtime".
Simpan laporan tertanggal dengan sumber URLs, kutipan dan kredit aktual yang dipakai.
Berhenti pada akses dicabut atau kredit yang tidak mencukupi; hormati Retry-After. Jangan buat percobaan, minta otorisasi baru atau ulangi permintaan yang hasilnya tak diketahui.Penyimpanan kredensial dan penyegaran
Konfigurasi ini menggunakan sambungan OpenClaw operator berbagi OAuth. Diijinkan peserta obrolan dan jadwal berjalan menggunakan akun FlashData dan saldo. (Dan tidak ada pertanggungjawaban sedikit pun atas orang-orang yang diutus kepada mereka) yakni orang-orang kafir.
Host menyegarkan satu-jam token akses OAuth menggunakan token refresh berputar. Rekonnect ketika 90-day hibah berakhir atau dicabut. Setiap instalasi memiliki toko token nya; jangan berbagi segar-token berkas antara host.
Membatalkan atau menyambung kembali
- Jeda tugas yang dijadwalkan, lalu batalkan nama OAuth koneksi dalam FlashData Settings → Connected apps.
- Minta agen untuk memanggil get_balance sekali dengan sambungan yang tersimpan. Ini harus gagal otentikasi atau meminta untuk menyambung kembali. Jangan menyetujui log masuk baru selama pemeriksaan ini.
- Hapus kredensial OAuth lokal dengan perintah di bawah ini. Untuk berhubungan kembali nanti, langkah berulang 2 dengan persetujuan pemilik dan menjalankan pemeriksaan koneksi bebas.
openclaw mcp logout flashdataOpsi setup lebih lanjut
Tambahkan keterampilan arus kerja ke koneksi MCP Anda, atau pilih akses CLI lokal atau server MCP.
Tambahkan keterampilan MCP
Keahlian flashdatma -mcp mengajarkan agen Anda bagaimana menggunakan alat-alat yang terhubung. Ini reuses koneksi di atas.
Dengan Node.js 22.20+ dan npm, jalankan ini di aktif OpenClaw ruang kerja. Keterampilan lengkap disimpan ke skills/flashdata-mcp. Mulai percakapan baru dan meminta untuk menggunakan flashdatma-mcp.
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligibleGunakan keterampilan CLI atau mulai percobaan
Pasang FlashData CLI v1.2.1 dan jalankan dari area kerja OpenClaw yang aktif. Pilih satu tab akses. Contoh memakai nilai baku CLI profil, terpisah dari MCP OAuth; menjaga keberadaan Anda --profile dan --state-dir jika Anda menggunakan yang kustom.
Instal dua keterampilan arus kerja di bawah ini dengan Node.js 22.20+ dan npm. Memulai percakapan baru OpenClaw sesudahnya. Perintah setup CLI asli tidak menargetkan OpenClaw.
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligibleTempelkan kunci dengan izin google_search pada prompt tersembunyi. Untuk impor tanpa pengawasan, pipe dari manajer rahasia Anda ke 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
# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Baca berkas yang disimpan: status, results[].organic, usage.credits.
# Terminal JSON melaporkan jalur keluaran; jaga ID untuk pemulihan.Gunakan kembali kunci atau uji coba yang ada. Jika FLASHDATA_API_KEY diset, maka ini akan diutamakan dari kunci yang tersimpan; verifikasi akun yang ditampilkan oleh 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
# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Baca berkas yang disimpan: status, results[].organic, usage.credits.
# Terminal JSON melaporkan jalur keluaran; jaga ID untuk pemulihan.Gunakan ulang percobaan yang ada atau register sekali. Jika kadaluarsa, habis atau dicabut, pemulihan atau klaim itu. Sebelum mengulang tugas CLI, klaim akun dan konfirmasi recurringAllowed: true dalam auth status.
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
# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive
# Baca berkas yang disimpan: status, results[].organic, usage.credits.
# Terminal JSON melaporkan jalur keluaran; jaga ID untuk pemulihan.Jalankan lokal MCP dengan kunci API
Membutuhkan Node.js 22.18 +, npm dan kunci API dengan izin google_search untuk tugas pertama. Ini berjalan @flashdata-dev/mcp 0.2.0; ia tidak membaca FlashData CLIkunci disimpan atau MCP OAuth token.
Set kunci di lingkungan yang benar-benar menjalankan gateway. Prompt di bawah adalah untuk sebuah gerbang terminal- diluncurkan; untuk layanan atau wadah, menyuntikkan FLASHDATA_API_KEY melalui konfigurasi secret/environment nya dan restart. Mengekspor kunci pada terminal lain tidak akan memutakhirkan layanan yang sedang berjalan.
Setelah setup, jalankan koneksi- periksa prompt di atas dalam sesi agen baru. Setelah kedua pemeriksaan lulus, gunakan tugas pertama. API-key access tidak memerlukan log masuk mcp.
# 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 --probePermasalahan menarik
| Masalah | Coba ini |
|---|---|
| Tidak ada alat FlashData | Jalankan openclaw mcp dokter flashdata --probe. Periksa profil gerbang dan kebijakan alat agen, lalu buka percakapan baru. |
| Skill hilang | Jalankan daftar keterampilan openclaw --eligible dan openclaw keterampilan cek dalam profil aktif. Periksa keterampilan area kerja / dan allowlist keterampilan. |
| invalid_client / callback | Padukan langkah 1 tepat. Otorisasi lengkap dalam peramban yang dapat mencapai pemanggilan balik host yang dimulai. |
| 401 | Periksa apakah koneksi atau kunci dibatalkan atau kadaluwarsa. Untuk OAuth, ulangi tanda-tanda dengan persetujuan pemilik; untuk CLI, jalankan flashdata auth status. Menambahkan kredit tidak akan memperbaiki otentikasi. |
| 403 | Periksa izin sumber yang diminta. Penelitian OAuth tidak termasuk YouTube Download; gunakan setup kunci API-nya. Perbaiki izin sebelum mencoba lagi. |
| 402 | Periksa get_balance atau saldo rekening flashdata. Tambahkan kredit dalam Billing atau menghentikan tugas; penandatanganan masuk lagi tidak menambah kredit. |
| 429 | Tunggu Retry-After dan kurangi konkuitnya. Pertahankan profil saat ini dan bukti pendaftaran; jangan membuat percobaan pengganti. |
| MCP lokal tidak dapat membaca kunci | Set FLASHDATA_API_KEY dimana proses host dimulai dan restart. Sebuah kunci disimpan oleh flashdata auth login tidak otomatis diekspor ke lokal MCP. |
| CLI berkas keluaran sudah ada | Baca ./openclaw-first-search.json. Untuk mengekspor sukses yang disimpan lagi, gunakan data-kilas runs show openclaw-First-search-001 --result --output openclaw-first-search-copy.json dengan profil asli. Gunakan run baru ID hanya untuk pencarian baru yang dimaksudkan. |
| Tugas terjadwal gagal | Jalankan pemeriksaan penggunaan ulang gratis di dalam lingkungan itu. Cocok dengan pengguna OS, profil host, toko kredensial dan perizinan alat. |
| Waktu habis atau hasil tak dikenal | Simpan permintaan atau pekerjaan ID dan periksa History sebelum menyerahkan kembali. Gunakan get_result untuk mengembalikan kelanjutan IDs. |
OAuth catatan validasi
OAuth login, callback, tersimpan kredensial, panggilan harga gratis, refresh dan pembatalan diverifikasi pada Windows dengan OpenClaw 2026.10.5 nyala 2026-10-21. Run yang tidak memvalidasi kueri dibayar atau dijadwalkan eksekusi. Instruksi pengaturan telah diperiksa terhadap dokumentasi host pada 2026-11-05.