تصفح الوثائق
عمليات التكامل
أعطِ وكيلَكَ OpenClaw Google Search و YouTube أدواتَ بحثِ وإحاطات متكررة.
في هذه الصفحة
قبل أن تبدأ
- OpenClaw تم تركيبها وعملها واستضافت هذه المجموعة مجموعة MCP استخدامات OAuth بالنسبة إلى Google Search و YouTube Search و Metadata و Transcripts. يمكنك خلق FlashData الحساب أثناء عملية التسجيل
1. يضاف خادم MCP
تشغيل هذا على الآلة و OpenClaw الملف الذي يدير بوابة الخاص بك. إنه يحفظ تشكيلة الخادم، وقطع الأشجار وجهاز الأداة يُطلب أدناه التحقق من أن عميلك يستطيع استخدامه فعلاً استخدم نفس الصورة لكل أمر في هذه الصفحة
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 |
| العثور على أشرطة فيديو ذات صلة من طراز YouTube | youtube_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
- أوقف المهام المجدولة مؤقتًا، ثم ألغِ اتصال OAuth المحدد في FlashData Settings → Connected apps.
- أطلب من العميل أن يتصل get_balance ذات مرة مع الاتّصال المنقذ. يجب أن تفشل في التوثيق أو أن تطلب إعادة التواصل. لا توافق على سجل جديد خلال هذا الشيك
- Remove the local OAuth documents with the command below. ولإعادة الاتصال فيما بعد، كرر الخطوة 2 بموافقة المالك وتحقق من الارتباط الحر.
openclaw mcp logout flashdataالمزيد من الخيارات في مجال التجهيز
أضف مهارات سير العمل إلى اتصالك بشركة MCP، أو اختار الوصول إلى CLI أو خادم محلي من طراز MCP.
أضف مهارة MCP
مهارة الوميضات تُعلّم عميلك كيفية استخدام الأدوات المُتصلة يُعيد استخدام الرابط أعلاه.
باستخدام Node.js 22.20+ وnpm، شغّل هذا داخل مساحة عمل OpenClaw النشطة. تُحفظ المهارة كاملة في skills/flashdata-mcp. ابدأ محادثة جديدة واطلب استخدام flashdata-mcp.
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.
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.
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
# استمر فقط إذا كان accessVerified و estimateAvailable هي true،,
# صلاحية google_search متاحة، وقيمة availableCredits تغطي estimatedCredits.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 للانتعاش.إعادة استخدام مفتاحك الحالي أو التجربة. وإذا تم تحديد الرقم FLASHDATA_API_KEY، فإنه يعطى الأسبقية على المفتاح المنقذ؛ ويتحقق من الحساب الذي أبدته شركة 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
# استمر فقط إذا كان accessVerified و estimateAvailable هي true،,
# صلاحية google_search متاحة، وقيمة availableCredits تغطي estimatedCredits.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 للانتعاش.أعد استخدام تجربة موجودة أو سجّل مرة واحدة. إذا انتهت صلاحيتها أو نفد رصيدها أو أُلغي وصولها، فاستعدها أو اربطها بالحساب. قبل جدولة مهام CLI المتكررة، اربط الحساب وتحقق من recurringAllowed: true في 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
# استمر فقط إذا كان accessVerified و estimateAvailable هي true،,
# صلاحية google_search متاحة، وقيمة availableCredits تغطي estimatedCredits.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-الولوج إلى (ميكي) لا يتطلب لوجّاً
# 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 --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.