Semak dokumentasi
Mula di sini
Coba pencarian Google sebelum signup, kemudian sambungkan akun pemilik untuk tetap menggunakan profil CLI yang sama.
Pada halaman ini
1. Periksa akses yang ada
Kau menjalankan cek gratis ini di lingkungan agenmu. data.accessVerified adalah true dan Google Search diizinkan, gunakan kembali akses tersebut dan lewati langkah 3. Dengan tanpa profil yang disimpan, terus melangkah 2. Melanjutkan akses tertunda atau diblokir menggunakan bagian pemulihan di bawah.
flashdata auth status --json --non-interactiveWaluke profile yang sama
Berkolaboring access melaporkan data.accessVerified: true, access: ready di data.identity.identity, dan google_search di data.identity.permittedSources.
Perintah-perintah ini menggunakan profil default dan bekerja dalam Bash atau PowerShell. Untuk profil atau direktori keadaan langganan yang sudah ada, tambahkan --profile yang sama NAMA dan --state-dir ABSOLUTE_PATH ke setiap perintah, termasuk yang ada di terminal segar.
FLASHDATA_API_KEY mengatasi kunci yang disimpan. Biarkan pemboleh ubah ini tidak ditetapkan apabila menguji percubaan dan penyerahan bukti kelayakan profil ini. Gunakan pengguna OS yang sama dan kekalkan direktori keadaan peribadi; direktori ini menyimpan bukti kelayakan, bukti pendaftaran dan sejarah pelaksanaan.
Periksa credentialProtection di auth status. Windows menggunakan DPAPI, macOS menggunakan Keychain, dan Linux tanpa kepala mungkin menggunakan berkas kredensial yang hanya dimiliki. Toko OS yang tersedia dapat diperlukan dengan --credential-store os.
Sebaliknya menggunakan kunci pemilik yang ada
Orang di terminal dapat mengimpor kunci melalui prompt tersembunyi di bawah dan melewatkan pendaftaran pengadilan dan mengklaim. Agen-agen zegoza harus memasoknya di stdin dengan --api-key-stdin --non-interactive dari toko rahasia mereka; tidak pernah menempatkan kunci dalam argumen atau obrolan.
Jika profil sudah memegang akses yang berbeda, tinjaulah sebelum menggunakan auth login --replace. Mengimpor kunci lain bukanlah tuntutan. MCP OAuth juga merupakan sambungan host yang terpisah.
flashdata auth login
flashdata auth status --json --non-interactive2. Mulailah satu pengadilan yang memenuhi syarat
Jalur discover pertama. Periksa data.onboardingAvailable dan uang saku di data.onboarding.trial. Jika onboarding tersedia, jalankan init sekali untuk Google Search. Server keabsahan pemeriksaan kelayakan; CLI menyimpan kunci sementara tanpa penandatanganan pembukaan atau mengajukan pertanyaan.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactivePeriksa penerimaan pendaftaran
Expect ok: true, data.status: trial dan google_search dalam data.connection.scopes. ¡data.connection.trialExpiresAt dan data.startingAllowanceCredits. Kunci disimpan secara lokal, tidak dicetak. data.currentBalanceAvailable adalah false, jalankan ulang pemeriksaan saldo bebas sebelum query.
Jika setup sudah dibuat akses, gunakan kembali. Ke label pendaftaran pertama agen, tambahkan --client codex --audience coding OR atau ORANG --client openclaw --audience personal. Simpan kembali masukan yang tepat pada retry; label tidak memberikan izin.
Kesusilaan dan batas - batas percobaan
Request equivalensi permintaan berbagi saldo kredit awal yang sama; mereka tidak tersisa permintaan atau kuota independen. Sumber-hanya pemilik seperti YouTube Download tidak dapat menghabiskan kredit percobaan.
| Batasi | Apa yang harus diperiksa |
|---|---|
| Penghargaan / Kedaluwarsa | Nilai bawaan saat ini: Nilai kredit 1 untuk jam 72. Temuan Bacaan untuk hibah dan seumur hidup; penerimaan tersebut memberikan sumber-sumber yang kadaluarsa dan diberikan. |
| Pendaftaran | 3 pendaftaran per IP per 24 Jam kerja, dibagikan oleh pengguna IP itu. Cadangan global mungkin juga menghentikan pendaftaran baru. |
| Konkurrensi | Tetap uji coba pekerjaan berurutan: satu item per kelompok dan satu pekerjaan tertunda. Periksa batas yang dikembalikan sebelum menyerahkan lebih banyak. |
3. Cuba satu pencarian
Pratonton pertama. Persyaratan data.estimateAvailableQ, harga google_search yang tersedia dalam data.estimate.prices, dan availableCredits yang meliputi estimatedCredits. Berhenti jika cek gagal. Preview bebas; perintah berikutnya mengirimkan satu 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-interactiveSemak hasil
ok: true dan data.status: done. Type, link dan snippet dari data.results[].organic, dan muatan dari data.usage.credits. Hasil organik yang kosong adalah valid. Sebelum mengklaim, mengulangi tugas yang tepat ini dengan trial-search mengembalikan hasil yang disimpannya. Tetap menjaga profil dan negara, dan mempertahankan setiap hasil persidangan yang Anda butuhkan.
flashdata account balance --json --non-interactive4. Simpan akses ke akun pemilik
Tuntutan sebelum persidangan berakhir jika Anda ingin terus atau berulang digunakan. Ketika pemilik sudah siap, jalankan ini dalam profil asli. Kongsi hanya data.claimUrl dan data.confirmationCode dengan mereka; data.expiresAt memberikan batas waktu.
link terakhir 15 menit, atau sampai pengadilan berakhir jika lebih cepat. Mewujudkan link tidak menyetujui akses atau kredit pembelian.
flashdata auth claim --json --non-interactiveAquirove in the browser
- Pemiliknya membuka link dan tanda masuk, atau menciptakan akun baru dan memverifikasi email. Sebuah pendaftaran baru melanjutkan klaim setelah verifikasi.
- Cek rekening yang ditunjukkan di halaman klaim. Untuk pemilik yang berbeda atau baru, gunakan sesi peramban yang terpisah. Akun yang ditanda-tangani adalah akun yang akan membayar untuk permintaan nanti.
- Masukkan kode delapan digit pada halaman tersebut, meninjau kembali izin produk dan akses share-balance, kemudian disetujui. Pemiliknya menangani pendaftaran, penerimaan hukum, pengesahan email dan persetujuan.
Finish di terminal asli
Setelah persetujuan, jalankan finish di profil asli dalam 24 jam. CLI menyimpan kunci pemilik, memverifikasinya dalam proses segar dan mengakui pemasangan. 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
Di auth status, verifikasi accountId yang dimaksudkan dan lingkup yang diberikan, ditambah bidang di bawah. FOGT membaca saldo segar secara terpisah; permintaan masa depan menghabiskan kredit bersama pemilik. Kredit sementara yang tidak digunakan tidak dipindahkan. Akun baru yang sesuai dengan kewajiban pendaftaran normal; mengklaim tidak menambahkan hibah tambahan.
Klaim klaim mengubah rekening yang ditagih. Untuk tugas baru di bawah pemilik, pilih ID baru. Mengecoh kembali sebuah uji coba menjalankan ID mengembalikan run_account_mismatch tanpa mengajukan pertanyaan lain; itu tidak mentransfer yang berjalan ke pemilik.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Pilih izin produk
Katalog kebenaran HTTP membezakan trialEligible daripada ownerAllowed. Sebelum pendaftaran pertama, minta hanya sumber yang diperlukan untuk tugas anda. requestedScopes mengandungi kebenaran yang diminta; scopes menunjukkan akses semasa kunci. Produk baharu memerlukan pemberian kebenaran yang jelas.
Kelulusan membenarkan penggunaan baki bersama pemilik, termasuk kredit yang dibeli. Sekatan sumber tidak menetapkan had perbelanjaan bagi setiap ejen. MCP OAuth ialah sambungan berasingan dan tidak memautkan profil CLI ini kepada akaun.
Hanya perlu YouTube Download?
Xifac menggunakan kunci pemilik dengan izin youtube_download, mengimpornya, kemudian mengkonfigurasi penyimpanan tujuan. Download tidak menggunakan kredit pengadilan sementara.
CLI 1.2.1 masih membutuhkan sumber yang dapat diisi-ujian untuk init. Untuk Download-only onboarding sebelum signup, gunakan aliran klaim HTTP dalam auth.md. Jangan menambahkan sumber percobaan yang tidak berhubungan hanya untuk memotong pembatasan klien itu.
Melanjutkan aliran berhenti
| Apa yang berhenti | Tindakan berikutnya |
|---|---|
| Daftar | Untuk 429, tunggu Retry-After. Untuk respon yang hilang, coba lagi init dengan profil, bukti yang sama dan masukan yang tepat. ¡Jaga keadaan yang sudah ada; jangan beralih IP atau memulai sidang pengganti. |
| Cari | Periksa trial-search dibawah. Sebuah tenggat waktu tidak membuktikan bahwa tidak ada pekerjaan yang diterima; jangan ubah lari ID untuk memaksa mencoba lagi. |
| Klaim link | Jika link tersebut kadaluarsa tetapi persidangannya valid, buat link segar di profil yang sama ketika pemilik sudah siap. Periksa pemilik yang ditandatangani sebelum persetujuan. |
| AYAH | Setelah disetujui, jalankan ulang auth finish dalam profil asli dalam 24 jam. Penundaan persetujuan, penantian yang terganggu atau pengakuan yang hilang tidak memerlukan pendaftaran baru. |
| Luput / keadaan hilang | Untuk pengadilan atau penyerahan yang telah luput, atau direktori negara swasta yang hilang, gunakan rekoneksi yang disetujui oleh pemilik atau impor kunci pemilik. |
flashdata runs show trial-search --json --non-interactive