Jelajahi dokumentasi
Mulai
Cobalah Google cari sebelum pendaftaran, lalu hubungkan akun pemilik untuk tetap menggunakan yang sama CLI profil.
Di halaman ini
1. Periksa akses yang ada
Jalankan pemeriksaan gratis ini di lingkungan agenmu. Jika data.accessVerified adalah true dan Google Search diijinkan, gunakan kembali akses tersebut dan lewatkan untuk langkah 3. Tanpa profil tersimpan, lanjutkan langkah 2. Melanjutkan penundaan atau memblokir akses menggunakan bagian pemulihan di bawah ini.
flashdata auth status --json --non-interactivePertahankan profil yang sama
Laporan akses data.accessVerified: true, access: ready dalam data.identity.identity, dan google_search dalam data.identity.permittedSources.
Perintah ini menggunakan profil baku dan bekerja di Bash atau PowerShell. Untuk profil yang sudah ada atau direktori keadaan gubahan, tambahkan yang sama --profile NAMA dan --state-dir ABSOLUTE_PATH untuk setiap perintah, termasuk mereka dalam terminal segar.
FLASHDATA_API_KEY didahulukan daripada kunci yang tersimpan. Biarkan variabel ini tidak disetel saat menguji uji coba dan penyerahan kredensial profil ini. Gunakan pengguna OS yang sama dan pertahankan direktori status privat; direktori ini menyimpan kredensial, bukti pendaftaran, dan riwayat eksekusi.
Inspeksi credentialProtection dalam auth status. Windows menggunakan DPAPI, macOS menggunakan Keychain, dan tanpa kepala Linux dapat menggunakan sebuah owner- hanya berkas kredensial. Toko OS yang tersedia dapat diperlukan dengan --credential-store os.
Pakai kunci pemilik yang ada saja
Seseorang di terminal dapat mengimpor kunci melalui prompt tersembunyi di bawah ini dan melewatkan pendaftaran pengadilan dan mengklaim. Para agen harus mensuplai di stdin dengan --api-key-stdin --non-interactive dari toko rahasia mereka; jangan pernah menaruh kunci dalam argumen atau percakapan.
Jika profil ini memiliki akses yang berbeda, periksa terlebih dahulu menggunakan auth login --replace. Mengimpor kunci lain bukan sebagai jawaban klaim. MCP OAuth juga merupakan sambungan host terpisah.
flashdata auth login
flashdata auth status --json --non-interactive2. Mulai satu pengadilan yang memenuhi syarat
Jalankan discover dulu. Periksa data.onboardingAvailable dan uang saku dalam data.onboarding.trial. Jika onboarding tersedia, jalankan init sekali untuk Google Search. Pemeriksaan server eligibilitas; CLI menyimpan kunci sementara tanpa membuka pendaftaran atau mengirimkan permintaan.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactivePeriksa tanda terima registrasi
Diharapkan ok: true, data.status: trial dan google_search in data.connection.scopes. Baca data.connection.trialExpiresAt dan data.startingAllowanceCredits. Kunci disimpan secara lokal, tidak dicetak. Jika data.currentBalanceAvailable adalah false, jalankan kembali pemeriksaan keseimbangan gratis sebelum kueri.
Jika setup sudah membuat akses, gunakan kembali. Untuk melabeli pendaftaran pertama agen, tambahkan --client codex --audience coding atau --client openclaw --audience personal. Simpan masukan yang tepat pada suatu coba ulang; label tidak memberikan izin.
Pembagian dan batas ujian
Permintaan ekuivalen berbagi saldo awal kredit yang sama; mereka tidak tersisa permintaan atau kuota independen. Pemilik - hanya sumber seperti YouTube Download tidak dapat menghabiskan kredit percobaan.
| Batas | Apa yang harus diperiksa |
|---|---|
| Kredit / kadaluwarsa | Default saat ini: kredit 1 untuk jam 72. Baca penemuan untuk hibah dan seumur hidup; tanda terima memberikan habis dan sumber yang diberikan. |
| Pendaftaran | 3 registrasi per IP per jam 24, dibagikan oleh pengguna IP tersebut. Penutup percobaan global juga dapat menghentikan registrasi baru. |
| konkuenCity in Texas, United States | Pertahankan sekuensial percobaan: satu hal per batch dan satu pekerjaan yang tertunda. Periksa kembali batas sebelum mengirimkan lebih banyak. |
3. Coba satu pencarian
Preview dulu. Perlu data.estimateAvailable, harga yang tersedia google_search dalam data.estimate.prices, dan availableCredits meliputi estimatedCredits. Berhenti jika cek gagal. Pratilik bebas; perintah selanjutnya menyerahkan pencarian.
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactiveflashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactivePeriksa hasil
Diharapkan ok: true dan data.status: done. Baca judul, link dan snippet dari data.results[].organic, dan muatan dari data.usage.credits. Hasil organik kosong valid. Sebelum mengklaim, mengulangi tugas ini dengan trial-search mengembalikan hasilnya. Menjaga profil dan negara, dan mempertahankan setiap hasil percobaan yang Anda butuhkan.
flashdata account balance --json --non-interactive4. Simpan akses dengan akun pemilik
Klaim sebelum percobaan berakhir bila anda ingin melanjutkan atau mengulangi penggunaan. Ketika pemiliknya siap, jalankan ini dalam profil asli. Berbagi hanya data.claimUrl dan data.confirmationCode dengan mereka; data.expiresAt memberikan tenggat waktu.
Taut berlangsung 15 menit, atau sampai sidang berakhir jika lebih cepat. Membuat link tidak menyetujui akses atau kredit pembelian.
flashdata auth claim --json --non-interactiveApprove dalam peramban
- Pemilik membuka tautan dan tanda-tanda masuk, atau membuat akun baru dan memverifikasi email. Sebuah tanda tangan baru melanjutkan klaim setelah verifikasi.
- Periksa akun yang ditunjukkan pada halaman klaim. Untuk pemilik yang berbeda atau baru, gunakan sesi peramban terpisah. Sign-in account adalah account yang akan membayar untuk permintaan kemudian.
- Masukkan kode delapan digit pada halaman itu, tinjau perizinan produk dan berbagi-keseimbangan akses, kemudian setuju. Pemilik menangani pendaftaran, penerimaan hukum, verifikasi email dan persetujuan.
Selesai di terminal asli
Setelah persetujuan, jalankan finish dalam profil asli dalam waktu 24 jam. CLI menyimpan kunci pemiliknya, memastikannya dalam proses baru dan mengakui instalasi. Tak ada kunci yang disalin dari peramban.
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveKonfirmasikan pemilik dan keseimbangan
Dalam auth status, verifikasi yang dimaksud accountId dan diberikan scopes, ditambah bidang di bawah ini. Baca keseimbangan baru secara terpisah; permintaan masa depan menghabiskan kredit bersama pemilik. Kredit sementara yang tak digunakan tidak ditransfer. Sebuah akun baru mengikuti eligibilitas pendaftaran normal; mengklaim tidak menambahkan tambahan hibah pendaftaran.
Mengklaim perubahan akun tagihan. Untuk tugas baru di bawah pemilik, pilih run baru ID. Menggunakan percobaan ID mengembalikan run_account_mismatch tanpa mengirimkan kueri lain; itu tidak mentransfer yang ke pemilik.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Pilih perizinan produk
Katalog izin HTTP membedakan trialEligible dan ownerAllowed. Sebelum pendaftaran pertama, minta hanya sumber yang diperlukan untuk tugas Anda. requestedScopes berisi izin yang diminta; scopes menunjukkan akses kunci saat ini. Produk baru memerlukan pemberian izin secara eksplisit.
Persetujuan mengizinkan penggunaan saldo bersama pemilik, termasuk kredit yang dibeli. Pembatasan sumber tidak menetapkan batas pengeluaran per agen. MCP OAuth adalah koneksi terpisah dan tidak menautkan profil CLI ini ke akun.
Hanya perlu YouTube Download?
Gunakan kunci pemilik dengan izin youtube_download, impor, lalu konfigurasi penyimpanan tujuan. Unduh tidak menggunakan kredit percobaan sementara.
CLI 1.2.1 masih membutuhkan sumber yang memenuhi syarat untuk init. Untuk Download- hanya onboarding sebelum sign-up, gunakan aliran klaim HTTP dalam auth.md. Jangan tambahkan sumber percobaan hanya untuk melewati batasan klien.
Lanjutkan aliran berhenti
| Apa yang berhenti | Aksi berikutnya |
|---|---|
| Register | Untuk 429, tunggu Retry-After. Untuk respon yang hilang, coba lagi init dengan profil yang sama, bukti, dan masukan yang tepat. Pertahankan keadaan yang ada; jangan menukar IP atau memulai percobaan pengganti. |
| Cari | Inspeksi trial-search di bawah ini. Sebuah timeout tidak membuktikan bahwa tidak ada pekerjaan yang diterima; jangan mengubah menjalankan ID untuk memaksa sebuah coba lagi. |
| Taut claim | Bila tautan berakhir tapi percobaan valid, buat sebuah tautan segar dalam profil yang sama ketika pemiliknya siap. Periksa sinyal pemilik sebelum persetujuan. |
| Handoff | Setelah persetujuan, tayangan ulang auth finish dalam profil asli dalam waktu 24 jam. Persetujuan yang tertunda, menunggu yang terganggu atau pengakuan yang hilang tidak memerlukan pendaftaran baru. |
| Keadaan terlama / hilang | Untuk percobaan yang kadaluwarsa atau handoff, atau direktori keadaan privat yang hilang, gunakan koneksi ulang yang disetujui atau impor kunci pemilik. |
flashdata runs show trial-search --json --non-interactive