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

عمليات التكامل

OpenClaw

أعطِ وكيلَكَ OpenClaw Google Search و YouTube أدواتَ بحثِ وإحاطات متكررة.

في هذه الصفحة

قبل أن تبدأ

- OpenClaw تم تركيبها وعملها واستضافت هذه المجموعة مجموعة MCP استخدامات OAuth بالنسبة إلى Google Search و YouTube Search و Metadata و Transcripts. يمكنك خلق FlashData الحساب أثناء عملية التسجيل

1. يضاف خادم MCP

تشغيل هذا على الآلة و OpenClaw الملف الذي يدير بوابة الخاص بك. إنه يحفظ تشكيلة الخادم، وقطع الأشجار وجهاز الأداة يُطلب أدناه التحقق من أن عميلك يستطيع استخدامه فعلاً استخدم نفس الصورة لكل أمر في هذه الصفحة

Bash / PowerShell 7
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. وقع

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

تسجيل الدخول
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe

تحققي من الاتصال بالمجان

افتحي محادثة جديدة في وحدة التحكم أو قناة الدردشة المرتبطة بك أرسل هذا فوراً؛ وكلا النداءين يجب أن ينجحا ولا يُثبت نجاح عملية كشف السجلات وحدها أن هذه المحادثة يمكن أن تستخدم الأدوات.

باستي في وكيلك
استخدم اتصال flashdata MCP.
استدعِ get_balance باستخدام {} وget_pricing باستخدام {"source":"google_search","request_count":1}.
أبلغ عن الرصيد المتاح والسعر المقدّر. لا تنفّذ بحثًا.

3. أدير مهمتك الأولى

أرسل هذا إلى عميلك المُتصل الشيكات مجانية، ويستخدم البحث الوحيد الائتمانات.

المهمة الأولى
إستعملْ الميضداتَ MCP خادم. تحقق من رصيدي وثمن واحد Google البحث.
إذا مُوّلت، اتصل google_search مرة واحدة مع الاستفسار "battery recycling research", num 5 وأسلوب العمل "realtime".
أعطِني a إحاطة قصيرة مَع ألقابِ المصدرِ، URLs ومقتطفاتِ.
مصادر موقعية وإبلاغ عن الأرصدة الدائنة الفعلية المستخدمة. توقّفْ بعد هذه المهمةِ.

ما يجب أن تراه

ابحثوا عن مجموعة من الأدوات من طراز google_search مع status: done، ووصلات المصدر من results[].organic، وإجابة تستند إلى تلك المصادر. ويأتي الاستخدام من usage.credits؛ وهو ليس عدد النتائج. وينبغي الإبلاغ عن نتائج فارغة.

ما يمكنك أن تسأل عنه

ويغطي هذا الاتصال بشركة OAuth أدوات البحث. وتستخدم شركة YouTube Download مخزناً رئيسياً ومقصداً من طراز API من خلال شركة API أو CLI.

المهامMCP tool
البحث عن مصادر على شبكة الإنترنت للإجابة أو التنفيذgoogle_search
العثور على أشرطة فيديو ذات صلة من طراز YouTubeyoutube_search
اقرأ عناوين الفيديو والقنوات والبيانات الفوقيةyoutube_metadata
إسترجع نسخة فيديو لموجزyoutube_transcript
التحقق من الائتمانات المتاحة وتكاليف الطلبget_balance · get_pricing

إعادة استخدام سبل الوصول إلى المهام المتكررة

استخدام OpenClaw الملف الشخصي و العميل الذي مرّ بالمهمة الأولى يجب أن يكون للبوابات نفس MCP الاتّصال و التصاريح كأدبتك

التحقق من توفير إمكانية الوصول

أجري هذا الفحص المجاني في دورة جديدة في البيئة المقررة كلا الإتصالين يجب أن ينجحا بدون لوج منظف جديد

التحقق من إعادة الاستخدام
أعد استخدام اتصال flashdata MCP الموجود.
استدعِ get_balance باستخدام {} وget_pricing باستخدام {"source":"google_search","request_count":1}.
أبلغ عما إذا نجح كلاهما. لا تبحث ولا تنشئ وصولًا جديدًا.

إنشاء المهمة المتكررة

في الجدول الزمني لمضيفك، اختيار منطقة زمنية وزمن، على سبيل المثال يوميا في 09:00 Asia/Shanghai. استخدم هذا كهيئة عمل أديرها مرة هناك وتحقق من التقرير المنقذ قبل أن يُمكن من تكرارها

هيئة المهام
أعد استخدام اتصال flashdata MCP الموجود. افحص get_balance وget_pricing لبحث Google واحد.
إذا كانت الصلاحية والرصيد متاحين، شغّل google_search مرة واحدة لـ "battery recycling research" مع num بقيمة 5 وmode بقيمة "realtime".
احفظ تقريرًا مؤرخًا بروابط المصادر والمقتطفات والرصيد المستخدم فعليًا.
توقف عند إلغاء الوصول أو عدم كفاية الرصيد؛ والتزم بـ Retry-After. لا تنشئ تجربة ولا تطلب تفويضًا جديدًا ولا تكرر طلبًا مجهول النتيجة.

تخزين المواد الخليعة وتجديدها

تستخدم هذه التشكيلة OpenClaw المشغل المشترك OAuth الإتصال. وسمح للمشتركين في الدردشة والمزمع استخدام حساب FlashData ورصيده. وهو لا يوفر حسابا مستقلا لكل مرسل.

يجدّد المضيف رموز وصول OAuth ذات الساعة الواحدة باستخدام رموز تجديد متعاقبة. أعد الاتصال عند انتهاء التفويض بعد 90 يومًا أو إلغائه. لكل تثبيت مخزن رموزه الخاص؛ ولا تشارك ملفات رموز التجديد بين المضيفين.

Revoke or reconnect

  1. أوقف المهام المجدولة مؤقتًا، ثم ألغِ اتصال OAuth المحدد في FlashData Settings → Connected apps.
  2. أطلب من العميل أن يتصل get_balance ذات مرة مع الاتّصال المنقذ. يجب أن تفشل في التوثيق أو أن تطلب إعادة التواصل. لا توافق على سجل جديد خلال هذا الشيك
  3. Remove the local OAuth documents with the command below. ولإعادة الاتصال فيما بعد، كرر الخطوة 2 بموافقة المالك وتحقق من الارتباط الحر.
Remove Save OAuth documents
openclaw mcp logout flashdata

المزيد من الخيارات في مجال التجهيز

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

أضف مهارة MCP

مهارة الوميضات تُعلّم عميلك كيفية استخدام الأدوات المُتصلة يُعيد استخدام الرابط أعلاه.

باستخدام Node.js 22.20+ وnpm، شغّل هذا داخل مساحة عمل OpenClaw النشطة. تُحفظ المهارة كاملة في skills/flashdata-mcp. ابدأ محادثة جديدة واطلب استخدام flashdata-mcp.

في مكان العمل الخاص بك OpenClaw
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligible

استخدام مهارات CLI أو بدء التجربة

Install FlashData CLI v1.2.1 وهربوا حيز العمل النشط في OpenClaw. اختر ورقة دخول واحدة أمثلة على استخدام التخلف عن السداد CLI ملامح منفصلة MCP OAuth? --profile و --state-dir إذا كنت تستخدم العرف.

ثبّت مهارتي سير العمل أدناه باستخدام Node.js 22.20+ وnpm. ابدأ محادثة OpenClaw جديدة بعد ذلك. لا يستهدف أمر setup في CLI الأصلي تطبيق OpenClaw.

Install CLI work flow skills
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.

1. استيراد المفتاح والتحقق منه
flashdata auth login
flashdata auth status --json --non-interactive
2. الرصيد المتحقق والتكلفة - لا بحث
flashdata account balance --json --non-interactive
flashdata search "battery recycling research" --num 5 --dry-run --json --non-interactive

# استمر فقط إذا كان accessVerified و estimateAvailable هي true،,
# صلاحية google_search متاحة، وقيمة availableCredits تغطي estimatedCredits.
3. شغّل مرة واحدة → ./openclaw-first-search.json
flashdata search "battery recycling research" --num 5 --run-id openclaw-first-search-001 --output openclaw-first-search.json --json --non-interactive

# اقرأ الملف المنقذ: الحالة، results[].organic، usage.credits.
# وتُبلغ محطة JSON عن مسار الناتج؛ وتُبقي على الرقم ID للانتعاش.

تشغيل محلي MCP مع مفتاح API

يتطلب Node.js 22.18+ وnpm ومفتاح API بصلاحية google_search للمهمة الأولى. يشغّل هذا @flashdata-dev/mcp 0.2.0؛ ولا يقرأ مفتاح FlashData CLI المحفوظ أو رموز MCP OAuth.

وضع المفتاح في البيئة التي تدير البوابة بالفعل أما العجلة الواردة أدناه فهي لبوابة مطلية؛ ولخدمة أو حاوية، حقن FLASHDATA_API_KEY من خلال تشكيلة secret/environment وأعيد تشغيلها. تصدير مفتاح في محطة طرفية أخرى لن يستكمل خدمة التشغيل.

بعد الإعداد، أجري فحص الاتصال المجاني في جلسة عمل جديدة. بمجرد أن يمر كل من الشيكات، استخدمي العجلة الأولى. API-الولوج إلى (ميكي) لا يتطلب لوجّاً

1. وضع المفتاح دون طباعته
# 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_KEY
2. سجل و مسبار في ملف البوابة
openclaw 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

اضطرابات

المشكلةجرب هذا
No FlashData toolsاجري فحصاً للطبيب (ماكب) --probe. تحقق من ملامح البوابة و سياسة العميلة ثم افتح محادثة جديدة
"المفقودون"تشغيل قائمة المهارات المفتوحة للقانون --eligible والفحص على المهارات المفتوحة في ملف النشاط. تحقق من مهارات العمل/وقائمة المهارات.
invalid_client / callbackبالمقارنة مع الخطوة 1 بالضبط. إذن كامل في مصفف يمكن أن يصل إلى ردة فعل المضيف
401تحققي من إن كان الوصل أو المفتاح قد ألغي أو انتهى بالنسبة للزجاجة OAuth، إعادة الإشارة بموافقة المالك؛ بالنسبة للزجاجة CLI، تشغيل وميضدات auth status. الإضافات الائتمانية لن تصليح التوثيق
403تحقق من إذن المصدر المطلوب. البحوث OAuth لا تشمل YouTube Download; Use its API-حسناً اصلح الإذن قبل إعادة التجريب
402تحقق get_balance أو رصيد حساب البيانات. تضاف أرصدة دائنة في Billing أو توقف المهمة؛ والتوقيع مرة أخرى لا يضيف ائتمانات.
429انتظر حسب Retry-After وقلّل التزامن. احتفظ بالملف الشخصي الحالي وإثبات التسجيل؛ لا تنشئ تجارب بديلة.
MCP المحلي لا يستطيع قراءة المفتاحالمجموعة FLASHDATA_API_KEY حيث تبدأ العملية المضيفة وتعيد تشغيلها مفتاح انقذته "الملفات" auth login لا يُصدَّر تلقائياً إلى محلية MCP.
يوجد بالفعل ملف نواتج CLIاقرأ ./openclaw-first-search.json. لتصدير النجاح المنقذ مرة أخرى، استخدام البيانات الخفية runs show openclaw-البحث الأول001 --result --output openclaw-first-search-copy.json مع الملف الأصلي. استخدمي جهازاً جديداً من طراز ID فقط من أجل بحث جديد مقصود
فشل المهمة المقررةأجري فحص إعادة الاستخدام المجاني داخل تلك البيئة تطابق OS مستعمل، ملف مضيف، مخزن للإبداع، وأذن للأداة.
الوقت أو النتيجة غير المعروفةأو الوظيفة ID وتحقق History قبل إعادة تقديم الطلب Use get_result for returned continuation IDs.

ملاحظــات المصادقة من طراز OAuth

تم التحقق من تسجيل دخول OAuth والاستدعاء العائد وبيانات الاعتماد المحفوظة واستدعاء أسعار مجاني والتجديد والإلغاء على Windows باستخدام OpenClaw 2026.10.5 بتاريخ 2026-10-21. لم يتحقق ذلك الاختبار من الاستعلامات المدفوعة أو التنفيذ المجدول. روجعت تعليمات الإعداد وفق وثائق المضيف بتاريخ 2026-11-05.