# OpenClaw

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

مرجع كانوني: https://flashdata.dev/ar/docs/integrations/openclaw
Reviewed: 2026-11-05 by FlashData

<a id="choose"></a>

## قبل أن تبدأ

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

- [استخدام مهارات CLI أو بدء التجربة](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md#cli)
- [Install OpenClaw](https://docs.openclaw.ai/start/getting-started)

<a id="setup"></a>

## 1. يضاف خادم MCP

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

### Bash / PowerShell 7

```bash
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"
  }
}'
```


<a id="oauth"></a>

## 2. وقع

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

### تسجيل الدخول

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


<a id="connection-check"></a>

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

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

#### باستي في وكيلك

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


<a id="first-task"></a>

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

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

### المهمة الأولى

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


<a id="result"></a>

### ما يجب أن تراه

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

- [طلب التفتيش التاريخ](https://flashdata.dev/app/jobs)

<a id="tools"></a>

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

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

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

- [MCP الأدوات والخصائص](https://flashdata.dev/ar/docs/mcp/reference.md)
- [Set up YouTube Download](https://flashdata.dev/ar/docs/guides/youtube-download-guide/reference.md)

<a id="recurring"></a>

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

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


<a id="reuse-check"></a>

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

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

#### التحقق من إعادة الاستخدام

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


<a id="schedule"></a>

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

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

#### هيئة المهام

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

- [دليل المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)
- [CLI الجدول الزمني والإنعاش](https://flashdata.dev/ar/docs/guides/cli-automation/reference.md#recurring)

<a id="credentials"></a>

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

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

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


<a id="revoke"></a>

### 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

```bash
openclaw mcp logout flashdata
```

- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="options"></a>

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

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


<a id="skills"></a>

### أضف مهارة MCP

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

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

#### في مكان العمل الخاص بك OpenClaw

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent openclaw --copy
openclaw skills list --eligible
```

- [CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#install)
- [اقرأ MCP المهارات](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [تحديث المهارات أو إزالتها](https://flashdata.dev/ar/docs/guides/agent-skill-management/reference.md)

<a id="cli"></a>

### استخدام مهارات 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

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata google-search --agent openclaw --copy
openclaw skills list --eligible
```

#### مفتاح API

معذرة مفتاح مع google_search إذن في العجلة المخفية. لاستيراد غير مجهز، أنقله من مديرك السري إلى auth login --api-key-stdin --non-interactive.

##### 1. استيراد المفتاح والتحقق منه

```bash
flashdata auth login
flashdata auth status --json --non-interactive
```

##### 2. الرصيد المتحقق والتكلفة - لا بحث

```bash
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

```bash
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

إعادة استخدام مفتاحك الحالي أو التجربة. وإذا تم تحديد الرقم FLASHDATA_API_KEY، فإنه يعطى الأسبقية على المفتاح المنقذ؛ ويتحقق من الحساب الذي أبدته شركة auth status.

##### 1. إعادة الاستخدام والتحقق من إمكانية الوصول

```bash
flashdata auth status --json --non-interactive
```

##### 2. الرصيد المتحقق والتكلفة - لا بحث

```bash
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

```bash
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.

##### 1. إنشاء إجراءات التجربة والتحقق منها

```bash
flashdata init --name "OpenClaw research" --client openclaw --audience personal --scopes google_search --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. الرصيد المتحقق والتكلفة - لا بحث

```bash
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

```bash
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](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#install)
- [استرداد النتيجة المنقذة](https://flashdata.dev/ar/docs/guides/cli-automation/reference.md#recover)
- [المطالبة قبل تكرار مهام CLI](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md)

<a id="local"></a>

### تشغيل محلي 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

##### 1. وضع المفتاح دون طباعته

```bash
# 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. سجل و مسبار في ملف البوابة

```bash
openclaw mcp set flashdata '{
  "command": "npx",
  "args": [
    "--yes",
    "--package=@flashdata-dev/mcp@0.2.0",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe
```


#### PowerShell 7 (Windows)

##### 1. وضع المفتاح دون طباعته

```powershell
# 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 flashdataSecureKey
```

##### 2. سجل و مسبار في ملف البوابة

```powershell
openclaw mcp set flashdata '{
  "command": "npx.cmd",
  "args": [
    "--yes",
    "--package=@flashdata-dev/mcp@0.2.0",
    "flashdata-mcp"
  ],
  "env": {
    "FLASHDATA_API_KEY": "${FLASHDATA_API_KEY}"
  }
}'
openclaw mcp doctor flashdata --probe
```


- [أجري فحص الإتصال الحر](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md#connection-check)
- [Create an API key](https://flashdata.dev/app/api-keys)
- [وثائق MCP المحلية](https://github.com/flashdatadev/flashdata-mcp)

<a id="help"></a>

## اضطرابات

| المشكلة | جرب هذا |
| --- | --- |
| 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. |

- [دليل الاسترداد](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)
- [OpenClaw MCP](https://docs.openclaw.ai/cli/mcp/transports)

<a id="compatibility"></a>

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

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

- [المهارات الرسمية](https://github.com/flashdatadev/flashdata-skills)
- [حزمة ومصدر MCP](https://github.com/flashdatadev/flashdata-mcp)
