تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

البدء

تجربة الوكيل وربط الحساب

حاول Google البحث قبل التوقيع، ثم ربط حساب المالك للاستمرار في استخدام نفس CLI لمحة عامة

في هذه الصفحة

1. التحقق من إمكانية الوصول القائمة

شغّل هذا الفحص المجاني في بيئة وكيلك. إذا كانت data.accessVerified بقيمة true وكان Google Search مسموحًا، فأعد استخدام الوصول وانتقل إلى الخطوة 3. إن لم يوجد ملف شخصي محفوظ، فتابع إلى الخطوة 2. استأنف الوصول المعلّق أو المحظور باستخدام قسم الاستعادة أدناه.

تحقق من هذا
flashdata auth status --json --non-interactive

حافظ على نفس الصورة

عندما يعمل الوصول، تظهر data.accessVerified: true وaccess: ready داخل data.identity.identity، وتظهر google_search ضمن data.identity.permittedSources.

وتستخدم هذه الأوامر ملفاً للتخلف عن السداد وتعمل في Bash أو PowerShell. من أجل ملف قائم أو دليل حكومي معتاد، يذيع نفس الدليل --profile و... --state-dir ABSOLUTE_PATH إلى كل قيادة، بما في ذلك تلك التي في محطة طرفية جديدة.

تتقدم قيمة FLASHDATA_API_KEY على المفتاح المحفوظ. اترك هذا المتغير غير مضبوط عند اختبار التجربة وتسليم بيانات الاعتماد لهذا الملف الشخصي. استخدم مستخدم نظام التشغيل نفسه واحتفظ بدليل الحالة الخاص؛ فهو يحتوي على بيانات الاعتماد وإثبات التسجيل وسجل عمليات التشغيل.

Inspect credentialProtection in auth status. Windows الاستخدامات DPAPI, macOS الاستخدامات Keychainو بلا رأس Linux قد يستخدم ملفاً للملك فقط ويمكن أن يُطلب من متجر زكس كيزوك (OS) متاح بـ (--credential-store os).

استخدم مفتاح المالك الحالي بدلاً من ذلك

ويمكن للشخص في محطة طرفية أن يستورد مفتاحاً من خلال العجلة المخبأة أدناه وأن يتخطى تسجيل المحاكمات ويطالب. العملاء يجب أن يزودوه stdin مع --api-key-stdin --non-interactive من متجرهم السري، لا تضع مفتاح في الحجج أو الدردشة.

إذا كان الملف يحتوي بالفعل على إمكانية وصول مختلفة، يستعرضه قبل استخدام auth login --replace. والاستيراد مفتاح آخر ليس تسليم المطالبة. كما أن شركة MCP OAuth هي أيضاً صلة مضيف منفصلة.

مفتاح مخفي: محطة طرفية بشرية
flashdata auth login
flashdata auth status --json --non-interactive

2. بدء التجربة المؤهلة

تشغيل discover أولا. تحقق من الرقم data.onboardingAvailable والبدل في data.onboarding.trial. إذا كان المركب متاحا، تشغيل init مرة واحدة ل Google Search. ويتحقق الخادم من الأهلية؛ وتحتفظ شركة CLI بالمفتاح المؤقت دون فتح باب التسجيل أو تقديم استفسار.

التوافر الحر
flashdata discover --json --non-interactive
بدء النفاذ المؤقت
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

تحقق من إيصال التسجيل

Expect ok: true, data.status: trial and google_search in data.connection.scopes. اقرأ data.connection.trialExpiresAt و data.startingAllowanceCredits. المفتاح يُنقذ محلياً وليس مطبوعاً وإذا كان data.currentBalanceAvailable هو false، فإن إعادة إدارة الرصيد الحر قبل الاستفسار.

إذا تم إنشاءه بالفعل خلق الوصول، إعادة استخدامه. لتسمية أول تسجيل لوكيل، إضافة --client codex --audience coding أو --client openclaw --audience personal. الاحتفاظ بالمدخلات الدقيقة في عملية إعادة النظر؛ ولا تمنح البطاقات تصريحات.

بدل المحاكمات والحدود

ويتقاسم المكافئان الطلبان نفس الرصيد الائتماني المبدئي؛ وهما غير متبقين من الطلبات أو حصص مستقلة. ولا يمكن لمصادر المالكية وحدها، مثل YouTube Download، أن تنفق ائتمانات التجربة.

Limitما الذي سيتحقق منه؟
الأرصدة الدائنة/النهائيةالعجز الحالي: ائتمان 1 لساعات 72. (أ) الاكتشاف الجاهز للمنحة والعمر؛ ويعطي الإيصال النفي والمصادر الممنوحة.
التسجيل3 تسجيلات لكل عنوان IP خلال 24 ساعة، يشترك فيها مستخدمو العنوان نفسه. وقد يوقف الحد العالمي للتجارب التسجيلات الجديدة أيضًا.
التكافلإبقاء أعمال التجربة متتالية: بند واحد لكل دفعة، وواحد في انتظار العمل. تحقق من الحدود قبل تقديم المزيد.

3. حاول البحث

العرض الأول. Require data.estimateAvailable, an available google_search in data.estimate.prices, and availableCredits covering estimatedCredits. توقّفْ إذا a يَفْشلُ. The preview is free; the next command submit one search.

الرصيد المتحقق والتكلفة؛ لا استفسار
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
عملية تفتيش واحدة - ما يصل إلى خمسة نتائج
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

تحقق من النتيجة

Expect ok: true and data.status: done. اقرأوا ألقاب ووصلات ودميات من data.results[].organic، والشحنة من data.usage.credits. النتائج العضوية فارغة صحيحة. وقبل المطالبة، فإن تكرار هذه المهمة بالضبط مع شركة trial-search يعود إلى نتيجة إنقاذها. حافظ على المواصفات و الولاية وحافظ على أي نتائج التجربة التي تحتاجها

التحقق من الرصيد المتبقي مجانا
flashdata account balance --json --non-interactive

4. حافظ على الدخول مع حساب المالك

المطالبة قبل التجربة تنتهي إذا كنت تريد الاستمرار أو الاستخدام المتكرر. عندما يكون المالك جاهزاً، افحص هذا في الملف الأصلي. Share only data.claimUrl and data.confirmationCode with them; data.expiresAt gives the deadline.

وتستغرق هذه الحلقة دقائق من الـ 15، أو حتى تنتهي التجربة إذا كان ذلك أقرب. ولا يوافق إنشاء الرابطة على الحصول على ائتمانات أو شراءها.

إنشاء وصلة مطالبة عندما يكون المالك جاهزاً
flashdata auth claim --json --non-interactive

الموافقة في المصفح

  1. ويفتح المالك الرابط والعلامات في أو ينشئ حسابا جديدا ويتحقق من البريد الإلكتروني. وتستأنف أي إشارة جديدة المطالبة بعد التحقق.
  2. تحقق من الحساب الموضح في صفحة المطالبة بالنسبة لمالك مختلف أو جديد، استخدام دورة مصفوفة منفصلة. والحساب الموقع هو الحساب الذي سيدفع مقابل الطلبات اللاحقة.
  3. أدخلي الرمز الثامن في تلك الصفحة، واستعراض تصاريح المنتجات وإتاحة إمكانية الوصول إلى التوازن المشترك، ثم الموافقة. ويتعامل المالك مع التوقيع، والقبول القانوني، والتحقق من البريد الإلكتروني، والموافقة.

الانتهاء في المحطة الأصلية

وبعد الموافقة، تشغيل finish في الملف الأصلي في غضون ساعات 24. وتحتفظ شركة CLI بمفتاح المالك، وتتحقق من ذلك في عملية جديدة وتعترف بالتركيب. لا يوجد مفتاح مُنسخ من المُتصفح.

إنقاذ المالك والتحقق من وصوله
flashdata auth finish --wait --timeout 10m --json --non-interactive
ثم تحقق من محطة طرفية جديدة نفس مستخدم OS والوصف
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

تأكد من المالك والتوازن

في auth status، تحقق من accountId المقصود والصلاحيات الممنوحة والحقول أدناه. اقرأ الرصيد الحالي منفصلًا؛ فالطلبات المستقبلية تستهلك رصيد المالك المشترك. لا ينتقل الرصيد المؤقت غير المستخدم. يخضع الحساب الجديد لأهلية التسجيل المعتادة؛ ولا يضيف ربط الحساب منحة تسجيل إضافية.

يغيّر ربط الحساب الحسابَ الذي تُحتسب عليه الرسوم. اختر معرّف تنفيذ جديدًا لمهمة جديدة تخص المالك. تعيد إعادة استخدام معرّف تنفيذ التجربة run_account_mismatch دون إرسال استعلام آخر؛ ولا تنقل ذلك التنفيذ إلى المالك.

مقتطفات الاستجابة
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}

تصاريح اختيار المنتجات

يميّز كتالوج صلاحيات HTTP بين trialEligible وownerAllowed. اطلب فقط المصادر اللازمة لمهمتك قبل التسجيل الأول. يحتوي requestedScopes على الصلاحيات المطلوبة، بينما يوضح scopes صلاحيات المفتاح الحالية. تتطلب المنتجات الجديدة منح صلاحية صريحة.

تسمح الموافقة باستخدام الرصيد المشترك للمالك، بما في ذلك الأرصدة المشتراة. تقييد المصادر لا يضع حدًا للإنفاق لكل وكيل. اتصال MCP OAuth منفصل ولا يربط ملف CLI الشخصي هذا بالحساب.

الحاجة فقط YouTube Download?

استخدم مفتاح المالك مع youtube_download إذن، أستورده، ثمّ يُخزّنُ مقصداً. ولا يستخدم التحميل الائتمانات المؤقتة للمحاكمات.

لا يزال CLI 1.2.1 يتطلب مصدرًا مؤهّلًا للتجربة من أجل init. لبدء الوصول إلى Download فقط قبل التسجيل، استخدم مسار الربط عبر HTTP في auth.md. لا تضف مصدر تجربة غير مرتبط لمجرد تجاوز قيد العميل.

إستعادة التدفق المتوقف

توقفالإجراء التالي:
السجلFor 429انتظر Retry-After. وللاستجابة المفقودة، يعاد النظر إلى الـ init بنفس الشكل، والإثبات، والمدخلات الدقيقة. إبقاء الدولة القائمة؛ ولا تبديل IP أو بدء تجربة بديلة.
بحثInspect trial-search below. ولا يثبت انقطاع الوقت أنه لم يُقبل أي عمل؛ ولا يغير تشغيل ID لإجبار عملية إعادة.
الصلة بين المطالباتوإذا انتهت صلاحية الرابط ولكن التجربة صحيحة، فإن إنشاء صلة جديدة في نفس الصورة عندما يكون المالك مستعدا. تحقق من المالك الموقع قبل الموافقة
تسليموبعد الموافقة، أعيد تشغيل auth finish في الملف الأصلي في غضون ساعات 24. وفي انتظار الموافقة، لا يتطلب الانتظار المتوقف أو الإقرار المفقود تسجيلا جديدا.
الدولة المفقودة/المفقودةلاستئناف التجربة أو التسليم، أو وضع دليل حكومي خاص مفقود، أو استخدام إعادة الاتصال التي يوافق عليها المالك أو استيراد مفتاح المالك.
التفتيش على البحث المنقذ لا يوجد استفسار جديد
flashdata runs show trial-search --json --non-interactive