From ee88e1bc7375deadf50cc7fa26394b7bbd661c63 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Thu, 30 Apr 2026 09:36:17 +0000 Subject: [PATCH] chore(i18n): refresh ar translations --- docs/ar/channels/qqbot.md | 155 ++++++++++++++++++----------------- docs/ar/cli/cron.md | 122 +++++++++++++-------------- docs/ar/plugins/community.md | 71 ++++++++-------- 3 files changed, 179 insertions(+), 169 deletions(-) diff --git a/docs/ar/channels/qqbot.md b/docs/ar/channels/qqbot.md index 81a9ac042..9d281618b 100644 --- a/docs/ar/channels/qqbot.md +++ b/docs/ar/channels/qqbot.md @@ -1,40 +1,40 @@ --- read_when: - تريد ربط OpenClaw بـ QQ - - تحتاج إلى إعداد بيانات اعتماد QQ Bot + - يلزم إعداد بيانات اعتماد QQ Bot - تريد دعم الدردشة الجماعية أو الخاصة في QQ Bot summary: إعداد بوت QQ وتكوينه واستخدامه title: بوت QQ x-i18n: - generated_at: "2026-04-30T07:43:35Z" + generated_at: "2026-04-30T09:34:49Z" model: gpt-5.5 provider: openai - source_hash: aefece6b05bb16d5c4f588bf7af4fd710b5f98aab0dbed8221490c46bf3f379c + source_hash: 964a92021acc534b7ec2749670fedd0e8caa47d5edf67ced80f0a8fb3eda7600 source_path: channels/qqbot.md workflow: 16 --- -يتصل QQ Bot بـ OpenClaw عبر واجهة QQ Bot API الرسمية (Gateway WebSocket). يدعم +يربط QQ Bot بـ OpenClaw عبر واجهة QQ Bot API الرسمية (Gateway عبر WebSocket). يدعم Plugin محادثات C2C الخاصة، ورسائل @ في المجموعات، ورسائل قنوات النقابات مع وسائط غنية (صور، صوت، فيديو، ملفات). -الحالة: Plugin مضمن. الرسائل المباشرة، ومحادثات المجموعات، وقنوات النقابات، -والوسائط مدعومة. التفاعلات وسلاسل المحادثات غير مدعومة. +الحالة: Plugin مضمّن. الرسائل المباشرة، ومحادثات المجموعات، وقنوات النقابات، +والوسائط مدعومة. التفاعلات والسلاسل غير مدعومة. -## Plugin مضمن +## Plugin مضمّن -تتضمن إصدارات OpenClaw الحالية QQ Bot، لذلك لا تحتاج الإصدارات المعبأة المعتادة +تضمّن إصدارات OpenClaw الحالية QQ Bot، لذلك لا تحتاج البُنى المعبأة العادية إلى خطوة `openclaw plugins install` منفصلة. ## الإعداد -1. انتقل إلى [QQ Open Platform](https://q.qq.com/) وامسح رمز QR باستخدام +1. انتقل إلى [منصة QQ المفتوحة](https://q.qq.com/) وامسح رمز QR باستخدام QQ على هاتفك للتسجيل / تسجيل الدخول. 2. انقر على **Create Bot** لإنشاء بوت QQ جديد. 3. ابحث عن **AppID** و **AppSecret** في صفحة إعدادات البوت وانسخهما. -> لا يتم تخزين AppSecret كنص صريح — إذا غادرت الصفحة دون حفظه، -> فسيتعين عليك إعادة إنشاء واحد جديد. +> لا يُخزّن AppSecret بنص صريح — إذا غادرت الصفحة من دون حفظه، +> فسيتعين عليك إنشاء واحد جديد. 4. أضف القناة: @@ -53,7 +53,7 @@ openclaw configure --section channels ## التكوين -تكوين بالحد الأدنى: +أبسط تكوين: ```json5 { @@ -72,7 +72,7 @@ openclaw configure --section channels - `QQBOT_APP_ID` - `QQBOT_CLIENT_SECRET` -AppSecret مدعوم بملف: +AppSecret المدعوم بملف: ```json5 { @@ -89,13 +89,13 @@ AppSecret مدعوم بملف: ملاحظات: - ينطبق الرجوع الاحتياطي إلى متغيرات البيئة على حساب QQ Bot الافتراضي فقط. -- يوفر `openclaw channels add --channel qqbot --token-file ...` - AppSecret فقط؛ يجب أن يكون AppID مضبوطا مسبقا في التكوين أو في `QQBOT_APP_ID`. -- يقبل `clientSecret` أيضا إدخال SecretRef، وليس سلسلة نصية صريحة فقط. +- يوفّر `openclaw channels add --channel qqbot --token-file ...` + AppSecret فقط؛ يجب أن يكون AppID مضبوطًا مسبقًا في التكوين أو في `QQBOT_APP_ID`. +- يقبل `clientSecret` أيضًا إدخال SecretRef، وليس سلسلة نصية صريحة فقط. ### إعداد متعدد الحسابات -شغل عدة بوتات QQ ضمن نسخة OpenClaw واحدة: +شغّل عدة بوتات QQ ضمن مثيل OpenClaw واحد: ```json5 { @@ -116,10 +116,10 @@ AppSecret مدعوم بملف: } ``` -يطلق كل حساب اتصال WebSocket خاصا به ويحافظ على ذاكرة تخزين مؤقت مستقلة -للرمز المميز (معزولة حسب `appId`). +يطلق كل حساب اتصال WebSocket خاصًا به ويحافظ على ذاكرة تخزين مؤقت مستقلة +للرموز (معزولة حسب `appId`). -أضف بوتا ثانيا عبر CLI: +أضف بوتًا ثانيًا عبر CLI: ```bash openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2" @@ -127,8 +127,8 @@ openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-o ### محادثات المجموعات -يستخدم دعم QQ Bot لمحادثات المجموعات OpenIDs الخاصة بمجموعات QQ، وليس أسماء العرض. أضف البوت -إلى مجموعة، ثم اذكره أو اضبط المجموعة للتشغيل دون ذكر. +يستخدم دعم محادثات المجموعات في QQ Bot معرفات OpenID لمجموعات QQ، وليس أسماء العرض. أضف البوت +إلى مجموعة، ثم اذكره أو اضبط المجموعة للعمل من دون ذكر. ```json5 { @@ -155,29 +155,30 @@ openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-o } ``` -يضبط `groups["*"]` الافتراضات لكل مجموعة، ويتجاوز إدخال -`groups.GROUP_OPENID` محدد تلك الافتراضات لمجموعة واحدة. تشمل إعدادات المجموعة: +تضبط `groups["*"]` الإعدادات الافتراضية لكل مجموعة، ويتجاوز إدخال +`groups.GROUP_OPENID` محدد تلك الإعدادات الافتراضية لمجموعة واحدة. تشمل إعدادات +المجموعات: - `requireMention`: يتطلب @mention قبل أن يرد البوت. الافتراضي: `true`. -- `ignoreOtherMentions`: يتجاهل الرسائل التي تذكر شخصا آخر ولكن لا تذكر البوت. -- `historyLimit`: يحتفظ برسائل المجموعة الحديثة التي لا تحتوي على ذكر كسياق للدور المذكور التالي. اضبطه على `0` للتعطيل. -- `toolPolicy`: `full` أو `restricted` أو `none` للأدوات ضمن نطاق المجموعة. -- `name`: تسمية ودية مستخدمة في السجلات وسياق المجموعة. -- `prompt`: مطالبة سلوك لكل مجموعة تضاف إلى سياق الوكيل. +- `ignoreOtherMentions`: تجاهل الرسائل التي تذكر شخصًا آخر ولكن لا تذكر البوت. +- `historyLimit`: الاحتفاظ برسائل المجموعة الحديثة التي لا تتضمن ذكرًا كسياق للدور التالي الذي يتضمن ذكرًا. اضبطه على `0` للتعطيل. +- `toolPolicy`: `full` أو `restricted` أو `none` للأدوات على نطاق المجموعة. +- `name`: تسمية ودية تُستخدم في السجلات وسياق المجموعة. +- `prompt`: مطالبة سلوك لكل مجموعة تُلحق بسياق الوكيل. -أوضاع التفعيل هي `mention` و `always`. يتم تعيين `requireMention: true` إلى -`mention`؛ ويتم تعيين `requireMention: false` إلى `always`. عند وجود تجاوز تفعيل -على مستوى الجلسة، فإنه يتغلب على التكوين. +أوضاع التفعيل هي `mention` و `always`. يتطابق `requireMention: true` مع +`mention`؛ ويتطابق `requireMention: false` مع `always`. إذا كان هناك تجاوز +للتفعيل على مستوى الجلسة، فله الأولوية على التكوين. -يكون الطابور الوارد لكل نظير. تحصل نظراء المجموعات على حد طابور أكبر، وتبقي -رسائل البشر قبل الرسائل المكتوبة بواسطة البوت عند الامتلاء، وتدمج دفعات رسائل -المجموعة العادية في دور واحد منسوب. تظل أوامر الشرطة المائلة تعمل واحدا تلو الآخر. +قائمة الانتظار الواردة تكون لكل نظير. تحصل نظراء المجموعات على حد أكبر لقائمة الانتظار، وتبقي +رسائل البشر قبل الأحاديث المكتوبة بواسطة البوت عند الامتلاء، وتدمج دفعات رسائل +المجموعة العادية في دور واحد منسوب. تظل أوامر Slash تعمل واحدًا تلو الآخر. ### الصوت (STT / TTS) -يدعم STT و TTS تكوينا من مستويين مع رجوع احتياطي حسب الأولوية: +يدعم STT و TTS تكوينًا من مستويين مع رجوع احتياطي حسب الأولوية: -| الإعداد | خاص بـ Plugin | الرجوع الاحتياطي للإطار | +| الإعداد | خاص بـ Plugin | الرجوع الاحتياطي لإطار العمل | | ------- | -------------------------------------------------------- | ----------------------------- | | STT | `channels.qqbot.stt` | `tools.media.audio.models[0]` | | TTS | `channels.qqbot.tts`, `channels.qqbot.accounts..tts` | `messages.tts` | @@ -210,15 +211,14 @@ openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-o ``` اضبط `enabled: false` على أي منهما للتعطيل. -تستخدم تجاوزات TTS على مستوى الحساب البنية نفسها مثل `messages.tts` وتندمج -بعمق فوق تكوين TTS للقناة/العمومي. +تستخدم تجاوزات TTS على مستوى الحساب الشكل نفسه مثل `messages.tts` وتُدمج بعمق +فوق تكوين TTS للقناة/العام. -تتعرض مرفقات صوت QQ الواردة للوكلاء كبيانات وصفية لوسائط الصوت مع -إبقاء ملفات الصوت الخام خارج `MediaPaths` العامة. تقوم ردود النص العادي -`[[audio_as_voice]]` بتوليف TTS وإرسال رسالة صوت QQ أصلية عندما يكون TTS -مكونا. +تُعرض مرفقات صوت QQ الواردة للوكلاء كبيانات وصفية لوسائط صوتية مع +إبقاء ملفات الصوت الخام خارج `MediaPaths` العامة. تؤدي الردود النصية الصريحة +`[[audio_as_voice]]` إلى توليف TTS وإرسال رسالة صوتية QQ أصلية عند تكوين TTS. -يمكن أيضا ضبط سلوك رفع/تحويل ترميز الصوت الصادر باستخدام +يمكن أيضًا ضبط سلوك رفع/تحويل ترميز الصوت الصادر باستخدام `channels.qqbot.audioFormatPolicy`: - `sttDirectFormats` @@ -230,61 +230,64 @@ openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-o | التنسيق | الوصف | | -------------------------- | ------------------ | | `qqbot:c2c:OPENID` | محادثة خاصة (C2C) | -| `qqbot:group:GROUP_OPENID` | محادثة مجموعة | -| `qqbot:channel:CHANNEL_ID` | قناة نقابة | +| `qqbot:group:GROUP_OPENID` | محادثة مجموعة | +| `qqbot:channel:CHANNEL_ID` | قناة نقابة | -> لكل بوت مجموعته الخاصة من OpenIDs المستخدمين. لا يمكن استخدام OpenID مستلم بواسطة Bot A **لإرسال** -> الرسائل عبر Bot B. +> لكل بوت مجموعته الخاصة من OpenIDs الخاصة بالمستخدمين. لا يمكن استخدام OpenID يستلمه Bot A **لإرسال** +> رسائل عبر Bot B. -## أوامر الشرطة المائلة +## أوامر Slash -أوامر مدمجة يتم اعتراضها قبل طابور الذكاء الاصطناعي: +الأوامر المدمجة التي تُعترض قبل قائمة انتظار الذكاء الاصطناعي: | الأمر | الوصف | | -------------- | ------------------------------------------------------------------------------------------------------ | -| `/bot-ping` | اختبار زمن الاستجابة | -| `/bot-version` | إظهار إصدار إطار عمل OpenClaw | +| `/bot-ping` | اختبار زمن الاستجابة | +| `/bot-version` | عرض إصدار إطار عمل OpenClaw | | `/bot-help` | سرد جميع الأوامر | -| `/bot-upgrade` | إظهار رابط دليل ترقية QQBot | -| `/bot-logs` | تصدير سجلات Gateway الحديثة كملف | -| `/bot-approve` | الموافقة على إجراء QQ Bot معلق (على سبيل المثال، تأكيد رفع C2C أو مجموعة) من خلال التدفق الأصلي. | +| `/bot-me` | عرض معرف مستخدم QQ الخاص بالمرسل (openid) لإعداد `allowFrom`/`groupAllowFrom` | +| `/bot-upgrade` | عرض رابط دليل ترقية QQBot | +| `/bot-logs` | تصدير سجلات Gateway الحديثة كملف | +| `/bot-approve` | الموافقة على إجراء QQ Bot معلق (مثل تأكيد رفع C2C أو مجموعة) من خلال التدفق الأصلي. | -ألحق `?` بأي أمر للحصول على مساعدة الاستخدام (على سبيل المثال `/bot-upgrade ?`). +أضف `?` إلى أي أمر للحصول على مساعدة الاستخدام (على سبيل المثال `/bot-upgrade ?`). + +أوامر المسؤول (`/bot-me`, `/bot-upgrade`, `/bot-logs`, `/bot-clear-storage`, `/bot-streaming`, `/bot-approve`) مخصصة للرسائل المباشرة فقط وتتطلب وجود openid الخاص بالمرسل في قائمة `allowFrom` صريحة وغير شاملة. يسمح `allowFrom: ["*"]` الشامل بالمحادثة لكنه لا يمنح وصول أوامر المسؤول. تُطابق رسائل المجموعة `groupAllowFrom` أولًا ثم ترجع إلى `allowFrom`. يؤدي تشغيل أمر مسؤول في مجموعة إلى إرجاع تلميح بدلًا من إسقاطه بصمت. ## بنية المحرك -يأتي QQ Bot كمحرك قائم بذاته داخل Plugin: +يأتي QQ Bot كمحرك مستقل داخل Plugin: -- يمتلك كل حساب حزمة موارد معزولة (اتصال WebSocket، عميل API، ذاكرة تخزين مؤقت للرموز المميزة، جذر تخزين الوسائط) مرتبطة بـ `appId`. لا تشارك الحسابات أبدا حالة الوارد/الصادر. -- يوسم المسجل متعدد الحسابات أسطر السجل بالحساب المالك بحيث تبقى التشخيصات قابلة للفصل عند تشغيل عدة بوتات ضمن Gateway واحد. -- تشترك مسارات الوارد والصادر وجسر Gateway في جذر حمولة وسائط واحد تحت `~/.openclaw/media`، بحيث تهبط عمليات الرفع والتنزيل وذاكرات التخزين المؤقت لتحويل الترميز تحت دليل محمي واحد بدلا من شجرة لكل نظام فرعي. -- يمر تسليم الوسائط الغنية عبر مسار `sendMedia` واحد لأهداف C2C والمجموعات. تستخدم الملفات المحلية والمخازن المؤقتة التي تتجاوز عتبة الملف الكبير نقاط نهاية الرفع المجزأ الخاصة بـ QQ، بينما تستخدم الحمولات الأصغر API الوسائط أحادية العملية. -- يمكن نسخ بيانات الاعتماد احتياطيا واستعادتها كجزء من لقطات بيانات اعتماد OpenClaw القياسية؛ يعيد المحرك ربط حزمة موارد كل حساب عند الاستعادة دون الحاجة إلى زوج رمز QR جديد. +- يمتلك كل حساب حزمة موارد معزولة (اتصال WebSocket، عميل API، ذاكرة تخزين مؤقت للرموز، جذر تخزين الوسائط) مرتبطة بـ `appId`. لا تشارك الحسابات الحالة الواردة/الصادرة مطلقًا. +- يعلّم المسجل متعدد الحسابات أسطر السجل بالحساب المالك حتى تبقى التشخيصات قابلة للفصل عند تشغيل عدة بوتات ضمن Gateway واحد. +- تتشارك مسارات الوارد والصادر وجسر Gateway جذر حمولة وسائط واحدًا تحت `~/.openclaw/media`، لذلك تصل عمليات الرفع والتنزيل وذاكرات التخزين المؤقت لتحويل الترميز إلى دليل واحد محمي بدلًا من شجرة لكل نظام فرعي. +- يمر تسليم الوسائط الغنية عبر مسار `sendMedia` واحد لأهداف C2C والمجموعات. تستخدم الملفات المحلية والمخازن المؤقتة التي تتجاوز عتبة الملفات الكبيرة نقاط نهاية الرفع المجزأ في QQ، بينما تستخدم الحمولات الأصغر واجهة API للوسائط ذات اللقطة الواحدة. +- يمكن نسخ بيانات الاعتماد احتياطيًا واستعادتها كجزء من لقطات بيانات اعتماد OpenClaw القياسية؛ يعيد المحرك إرفاق حزمة موارد كل حساب عند الاستعادة من دون الحاجة إلى زوج رمز QR جديد. -## الإلحاق عبر رمز QR +## الإعداد عبر رمز QR -كبديل للصق `AppID:AppSecret` يدويا، يدعم المحرك تدفق إلحاق عبر رمز QR لربط QQ Bot بـ OpenClaw: +كبديل للصق `AppID:AppSecret` يدويًا، يدعم المحرك تدفق إعداد عبر رمز QR لربط QQ Bot بـ OpenClaw: -1. شغل مسار إعداد QQ Bot (على سبيل المثال `openclaw channels add --channel qqbot`) واختر تدفق رمز QR عند المطالبة. -2. امسح رمز QR الذي تم إنشاؤه باستخدام تطبيق الهاتف المرتبط بـ QQ Bot المستهدف. -3. وافق على الاقتران على الهاتف. يحتفظ OpenClaw ببيانات الاعتماد المرجعة في `credentials/` ضمن نطاق الحساب الصحيح. +1. شغّل مسار إعداد QQ Bot (على سبيل المثال `openclaw channels add --channel qqbot`) واختر تدفق رمز QR عند المطالبة. +2. امسح رمز QR المُنشأ باستخدام تطبيق الهاتف المرتبط بـ QQ Bot المستهدف. +3. وافق على الاقتران على الهاتف. يحفظ OpenClaw بيانات الاعتماد المُعادة في `credentials/` ضمن نطاق الحساب الصحيح. -تظهر مطالبات الموافقة التي يولدها البوت نفسه (على سبيل المثال، تدفقات "السماح بهذا الإجراء؟" المعروضة بواسطة QQ Bot API) كمطالبات OpenClaw أصلية يمكنك قبولها باستخدام `/bot-approve` بدلا من الرد عبر عميل QQ الخام. +تظهر مطالبات الموافقة التي ينشئها البوت نفسه (على سبيل المثال، تدفقات "السماح بهذا الإجراء؟" التي تعرضها QQ Bot API) كمطالبات OpenClaw أصلية يمكنك قبولها باستخدام `/bot-approve` بدلًا من الرد عبر عميل QQ الخام. ## استكشاف الأخطاء وإصلاحها -- **يرد البوت "ذهب إلى المريخ":** بيانات الاعتماد غير مكونة أو Gateway غير مشغل. +- **يرد البوت "ذهب إلى المريخ":** بيانات الاعتماد غير مكوّنة أو Gateway غير مشغّل. - **لا توجد رسائل واردة:** تحقق من صحة `appId` و `clientSecret`، وأن - البوت مفعل على QQ Open Platform. -- **ردود ذاتية متكررة:** يسجل OpenClaw فهارس مراجع QQ الصادرة كرسائل - مكتوبة بواسطة البوت ويتجاهل الأحداث الواردة التي يطابق فيها `msgIdx` الحالي - حساب البوت نفسه. يمنع هذا حلقات صدى المنصة مع السماح للمستخدمين + البوت مفعّل على منصة QQ المفتوحة. +- **ردود ذاتية متكررة:** يسجل OpenClaw فهارس مراجع QQ الصادرة على أنها + مكتوبة بواسطة البوت ويتجاهل الأحداث الواردة التي يطابق `msgIdx` الحالي فيها + حساب البوت نفسه. يمنع هذا حلقات صدى المنصة مع السماح للمستخدمين في الوقت نفسه باقتباس رسائل البوت السابقة أو الرد عليها. -- **الإعداد باستخدام `--token-file` لا يزال يظهر غير مكون:** يضبط `--token-file` +- **الإعداد باستخدام `--token-file` لا يزال يظهر غير مكوّن:** يضبط `--token-file` AppSecret فقط. ما زلت بحاجة إلى `appId` في التكوين أو `QQBOT_APP_ID`. - **الرسائل الاستباقية لا تصل:** قد يعترض QQ الرسائل التي يبدأها البوت إذا - لم يتفاعل المستخدم مؤخرا. -- **الصوت غير منسوخ نصيا:** تأكد من أن STT مكون وأن المزود قابل للوصول. + لم يتفاعل المستخدم مؤخرًا. +- **الصوت لا يُنسخ نصيًا:** تأكد من تكوين STT وأن الموفر قابل للوصول. ## ذات صلة diff --git a/docs/ar/cli/cron.md b/docs/ar/cli/cron.md index b0165fc6a..b6eb0d130 100644 --- a/docs/ar/cli/cron.md +++ b/docs/ar/cli/cron.md @@ -1,21 +1,21 @@ --- read_when: - تريد مهامًا مجدولة وعمليات إيقاظ - - أنت تعمل على استكشاف أخطاء تنفيذ Cron والسجلات وإصلاحها + - أنت تقوم بتصحيح أخطاء تنفيذ Cron والسجلات summary: مرجع CLI لـ `openclaw cron` (جدولة مهام الخلفية وتشغيلها) title: Cron x-i18n: - generated_at: "2026-04-30T07:47:24Z" + generated_at: "2026-04-30T09:34:46Z" model: gpt-5.5 provider: openai - source_hash: 658498b09e0f0997d0f05dcdbdbd8822284d747df932f1c51e86f97b94cd81a7 + source_hash: 03d79e0e2c71f673c900b84eb2beeab705662c1d016e1d0567323c8da73060bb source_path: cli/cron.md workflow: 16 --- # `openclaw cron` -إدارة مهام cron لجدولة Gateway. +إدارة مهام Cron لمُجدول Gateway. شغّل `openclaw cron --help` للاطلاع على كامل واجهة الأوامر. راجع [مهام Cron](/ar/automation/cron-jobs) للدليل المفاهيمي. @@ -26,142 +26,142 @@ x-i18n: يقبل `--session` القيم `main` أو `isolated` أو `current` أو `session:`. - - - يربط `main` بجلسة الوكيل الرئيسية. - - ينشئ `isolated` نصًا جديدًا ومعرّف جلسة جديدًا لكل تشغيل. - - يربط `current` بالجلسة النشطة وقت الإنشاء. - - يثبّت `session:` على مفتاح جلسة دائم صريح. + + - تربط `main` بجلسة الوكيل الرئيسية. + - تنشئ `isolated` نصًا حواريًا جديدًا ومعرّف جلسة جديدًا لكل تشغيل. + - تربط `current` بالجلسة النشطة وقت الإنشاء. + - تثبّت `session:` على مفتاح جلسة مستمرة صريح. - تعيد التشغيلات المعزولة ضبط سياق المحادثة المحيط. تتم إعادة ضبط توجيه القنوات والمجموعات، وسياسة الإرسال/وضع الانتظار، والتصعيد، والمنشأ، وربط وقت تشغيل ACP للتشغيل الجديد. يمكن أن تنتقل التفضيلات الآمنة والنموذج الذي اختاره المستخدم صراحة أو تجاوزات المصادقة عبر التشغيلات. + تعيد التشغيلات المعزولة ضبط سياق المحادثة المحيط. يُعاد ضبط توجيه القنوات والمجموعات، وسياسة الإرسال/الانتظار في الطابور، والرفع، والأصل، وربط وقت تشغيل ACP للتشغيل الجديد. يمكن أن تنتقل التفضيلات الآمنة والتجاوزات الصريحة للنموذج أو المصادقة التي اختارها المستخدم عبر التشغيلات. ## التسليم -يعرض `openclaw cron list` و`openclaw cron show ` معاينة لمسار التسليم المحلول. بالنسبة إلى `channel: "last"`، تعرض المعاينة ما إذا كان المسار قد حُلّ من الجلسة الرئيسية أو الحالية، أو أنه سيفشل مغلقًا. +يعرض `openclaw cron list` و`openclaw cron show ` معاينة لمسار التسليم المحلول. بالنسبة إلى `channel: "last"`، تعرض المعاينة ما إذا كان المسار قد حُل من الجلسة الرئيسية أو الحالية، أو سيفشل مغلقًا. -تستخدم مهام `cron add` المعزولة تسليم `--announce` افتراضيًا. استخدم `--no-deliver` لإبقاء المخرجات داخلية. يظل `--deliver` اسمًا مستعارًا مهجورًا لـ `--announce`. +تكون مهام `cron add` المعزولة افتراضيًا على تسليم `--announce`. استخدم `--no-deliver` لإبقاء المخرجات داخلية. يبقى `--deliver` كاسم بديل مهمل لـ `--announce`. ### ملكية التسليم -تسليم محادثة cron المعزولة مشترك بين الوكيل والمشغّل: +يتشارك الوكيل والمشغّل تسليم دردشة Cron المعزولة: -- يمكن للوكيل الإرسال مباشرة باستخدام أداة `message` عندما يكون مسار محادثة متاحًا. +- يمكن للوكيل الإرسال مباشرة باستخدام أداة `message` عندما يكون مسار دردشة متاحًا. - يسلّم `announce` الرد النهائي احتياطيًا فقط عندما لا يرسل الوكيل مباشرة إلى الهدف المحلول. -- ينشر `webhook` الحمولة المكتملة إلى عنوان URL. +- ينشر `webhook` الحمولة المنتهية إلى URL. - يعطّل `none` التسليم الاحتياطي من المشغّل. -`--announce` هو تسليم احتياطي من المشغّل للرد النهائي. يعطّل `--no-deliver` ذلك التسليم الاحتياطي لكنه لا يزيل أداة `message` الخاصة بالوكيل عندما يكون مسار محادثة متاحًا. +`--announce` هو التسليم الاحتياطي من المشغّل للرد النهائي. يعطّل `--no-deliver` ذلك التسليم الاحتياطي، لكنه لا يزيل أداة `message` الخاصة بالوكيل عندما يكون مسار دردشة متاحًا. -تحافظ التذكيرات المنشأة من محادثة نشطة على هدف تسليم المحادثة المباشر لاستخدامه في تسليم الإعلان الاحتياطي. قد تكون مفاتيح الجلسات الداخلية بأحرف صغيرة؛ لا تستخدمها كمصدر حقيقة لمعرّفات المزوّدين الحساسة لحالة الأحرف مثل معرّفات غرف Matrix. +تحافظ التذكيرات المُنشأة من دردشة نشطة على هدف تسليم الدردشة الحي لتسليم الإعلان الاحتياطي. قد تكون مفاتيح الجلسات الداخلية بأحرف صغيرة؛ لا تستخدمها كمصدر حقيقة لمعرّفات مزوّدين حساسة لحالة الأحرف مثل معرّفات غرف Matrix. ### تسليم الفشل تُحل إشعارات الفشل بهذا الترتيب: -1. `delivery.failureDestination` على المهمة. +1. `delivery.failureDestination` في المهمة. 2. `cron.failureDestination` العام. -3. هدف الإعلان الأساسي للمهمة (عندما لا تكون هناك وجهة فشل صريحة مضبوطة). +3. هدف الإعلان الأساسي للمهمة (عند عدم تعيين وجهة فشل صريحة). -يمكن لمهام الجلسة الرئيسية استخدام `delivery.failureDestination` فقط عندما يكون وضع التسليم الأساسي هو `webhook`. تقبله المهام المعزولة في كل الأوضاع. +لا يجوز لمهام الجلسة الرئيسية استخدام `delivery.failureDestination` إلا عندما يكون وضع التسليم الأساسي هو `webhook`. تقبله المهام المعزولة في جميع الأوضاع. -ملاحظة: تتعامل تشغيلات cron المعزولة مع حالات فشل الوكيل على مستوى التشغيل كأخطاء مهمة حتى عندما -لا تُنتج حمولة رد، لذلك لا تزال حالات فشل النموذج/المزوّد تزيد عدادات الأخطاء -وتشغّل إشعارات الفشل. +ملاحظة: تتعامل تشغيلات Cron المعزولة مع حالات فشل الوكيل على مستوى التشغيل كأخطاء مهمة حتى عندما +لا تُنتَج حمولة رد، لذلك تظل حالات فشل النموذج/المزوّد تزيد عدادات الأخطاء +وتطلق إشعارات الفشل. ## الجدولة -### مهام مرة واحدة +### المهام لمرة واحدة -يجدول `--at ` تشغيلًا لمرة واحدة. تُعامل أوقات التاريخ بلا إزاحة على أنها UTC ما لم تمرر أيضًا `--tz `، والذي يفسر وقت الساعة المحلي في المنطقة الزمنية المحددة. +يجدول `--at ` تشغيلًا لمرة واحدة. تُعامل التواريخ والأوقات بلا إزاحة على أنها UTC ما لم تمرر أيضًا `--tz `، والذي يفسر وقت الساعة المحلية في المنطقة الزمنية المعطاة. -تُحذف مهام المرة الواحدة بعد النجاح افتراضيًا. استخدم `--keep-after-run` للاحتفاظ بها. +تُحذف المهام لمرة واحدة بعد النجاح افتراضيًا. استخدم `--keep-after-run` للاحتفاظ بها. ### المهام المتكررة -تستخدم المهام المتكررة تراجع إعادة محاولة أسيًا بعد الأخطاء المتتالية: 30s، 1m، 5m، 15m، 60m. يعود الجدول إلى الوضع الطبيعي بعد التشغيل الناجح التالي. +تستخدم المهام المتكررة تراجع إعادة محاولة أُسّي بعد الأخطاء المتتالية: 30s، 1m، 5m، 15m، 60m. يعود الجدول إلى الوضع الطبيعي بعد التشغيل الناجح التالي. -تُتبع التشغيلات المتخطاة بشكل منفصل عن أخطاء التنفيذ. لا تؤثر في تراجع إعادة المحاولة، لكن يمكن لـ `openclaw cron edit --failure-alert-include-skipped` اختيار إدراج التشغيلات المتخطاة المتكررة في تنبيهات الفشل. +تُتبع التشغيلات المتخطاة بشكل منفصل عن أخطاء التنفيذ. لا تؤثر في تراجع إعادة المحاولة، لكن يمكن لـ `openclaw cron edit --failure-alert-include-skipped` تضمين تنبيهات الفشل في إشعارات متكررة عن التشغيلات المتخطاة. -بالنسبة إلى المهام المعزولة التي تستهدف مزوّد نموذج محليًا مهيأ، يشغّل cron فحصًا تمهيديًا خفيفًا للمزوّد قبل بدء دورة الوكيل. تُفحص مزوّدات `api: "ollama"` ذات Loopback والشبكة الخاصة و`.local` عند `/api/tags`؛ وتُفحص المزوّدات المحلية المتوافقة مع OpenAI مثل vLLM وSGLang وLM Studio عند `/models`. إذا تعذر الوصول إلى نقطة النهاية، يُسجل التشغيل كـ `skipped` وتُعاد المحاولة في جدول لاحق؛ تُخزن نقاط النهاية الميتة المطابقة مؤقتًا لمدة 5 دقائق لتجنب طرق الكثير من المهام للخادم المحلي نفسه. +بالنسبة إلى المهام المعزولة التي تستهدف مزوّد نماذج محليًا مهيأ، يجري Cron فحصًا تمهيديًا خفيفًا للمزوّد قبل بدء دور الوكيل. تُفحص مزوّدات Loopback والشبكات الخاصة و`.local` ذات `api: "ollama"` عند `/api/tags`؛ وتُفحص مزوّدات OpenAI-compatible المحلية مثل vLLM وSGLang وLM Studio عند `/models`. إذا تعذر الوصول إلى نقطة النهاية، يُسجل التشغيل على أنه `skipped` ويُعاد المحاولة في جدول لاحق؛ وتُخزن نقاط النهاية المعطلة المطابقة مؤقتًا لمدة 5 دقائق لتجنب أن تضغط مهام كثيرة على الخادم المحلي نفسه. -ملاحظة: تعيش تعريفات مهام cron في `jobs.json`، بينما تعيش حالة وقت التشغيل المعلقة في `jobs-state.json`. إذا عُدّل `jobs.json` خارجيًا، يعيد Gateway تحميل الجداول المتغيرة ويمسح الخانات المعلقة القديمة؛ لا تمسح عمليات إعادة الكتابة الخاصة بالتنسيق فقط الخانة المعلقة. +ملاحظة: تعيش تعريفات مهام Cron في `jobs.json`، بينما تعيش حالة وقت التشغيل المعلقة في `jobs-state.json`. إذا حُرر `jobs.json` خارجيًا، يعيد Gateway تحميل الجداول المتغيرة ويمسح الخانات المعلقة القديمة؛ ولا تمسح إعادات الكتابة التي تغيّر التنسيق فقط الخانة المعلقة. ### التشغيلات اليدوية -يعيد `openclaw cron run` النتيجة بمجرد وضع التشغيل اليدوي في قائمة الانتظار. تتضمن الاستجابات الناجحة `{ ok: true, enqueued: true, runId }`. استخدم `openclaw cron runs --id ` لمتابعة النتيجة النهائية. +يعيد `openclaw cron run` النتيجة بمجرد وضع التشغيل اليدوي في الطابور. تتضمن الاستجابات الناجحة `{ ok: true, enqueued: true, runId }`. استخدم `openclaw cron runs --id ` لمتابعة النتيجة النهائية. -ينفذ `openclaw cron run ` تشغيلًا قسريًا افتراضيًا. استخدم `--due` للاحتفاظ بالسلوك الأقدم: "شغّل فقط إذا كان مستحقًا". +يفرض `openclaw cron run ` التشغيل افتراضيًا. استخدم `--due` للاحتفاظ بسلوك "التشغيل فقط إذا كان مستحقًا" الأقدم. ## النماذج -يحدد `cron add|edit --model ` نموذجًا مسموحًا به للمهمة. +يحدد `cron add|edit --model ` نموذجًا مسموحًا للمهمة. -إذا لم يكن النموذج مسموحًا به أو تعذر حله، يفشل cron التشغيل بخطأ تحقق صريح بدلًا من الرجوع إلى اختيار نموذج وكيل المهمة أو النموذج الافتراضي. +إذا لم يكن النموذج مسموحًا أو تعذر حله، يفشل Cron التشغيل بخطأ تحقق صريح بدلًا من الرجوع إلى وكيل المهمة أو اختيار النموذج الافتراضي. -`--model` في Cron هو **أساسي المهمة**، وليس تجاوز `/model` لجلسة محادثة. يعني ذلك: +`--model` في Cron هو **أساسي للمهمة**، وليس تجاوز `/model` لجلسة دردشة. وهذا يعني: -- لا تزال احتياطيات النماذج المهيأة تُطبق عندما يفشل نموذج المهمة المحدد. -- تستبدل `fallbacks` في حمولة كل مهمة قائمة الاحتياطيات المهيأة عند وجودها. -- تجعل قائمة الاحتياطيات الفارغة لكل مهمة (`fallbacks: []` في حمولة/واجهة API المهمة) تشغيل cron صارمًا. -- عندما تحتوي مهمة على `--model` لكن لا تكون هناك قائمة احتياطيات مهيأة، يمرر OpenClaw تجاوز احتياطي فارغًا صريحًا حتى لا يُلحق نموذج الوكيل الأساسي كهدف إعادة محاولة مخفي. +- تظل احتياطات النماذج المهيأة مطبقة عندما يفشل نموذج المهمة المحدد. +- تستبدل حمولة كل مهمة `fallbacks` قائمة الاحتياطات المهيأة عند وجودها. +- تجعل قائمة احتياطات فارغة لكل مهمة (`fallbacks: []` في حمولة/API المهمة) تشغيل Cron صارمًا. +- عندما تحتوي مهمة على `--model` لكن لا توجد قائمة احتياطات مهيأة، يمرر OpenClaw تجاوز احتياطات فارغًا صريحًا كي لا يُضاف النموذج الأساسي للوكيل كهدف إعادة محاولة مخفي. -### أسبقية نموذج cron المعزول +### أسبقية نموذج Cron المعزول -يحل cron المعزول النموذج النشط بهذا الترتيب: +يحل Cron المعزول النموذج النشط بهذا الترتيب: -1. تجاوز خطاف Gmail. +1. تجاوز Gmail-hook. 2. `--model` لكل مهمة. -3. تجاوز نموذج جلسة cron المخزن (عندما يختار المستخدم واحدًا). +3. تجاوز نموذج جلسة Cron المخزن (عندما يختار المستخدم واحدًا). 4. اختيار نموذج الوكيل أو النموذج الافتراضي. ### الوضع السريع -يتبع الوضع السريع في cron المعزول اختيار النموذج المباشر المحلول. يطبق إعداد النموذج `params.fastMode` افتراضيًا، لكن يظل تجاوز `fastMode` المخزن في الجلسة مقدّمًا على الإعداد. +يتبع الوضع السريع في Cron المعزول اختيار النموذج الحي المحلول. تُطبق تهيئة النموذج `params.fastMode` افتراضيًا، لكن تجاوز الجلسة المخزن `fastMode` يظل له الأسبقية على التهيئة. -### إعادة محاولات تبديل النموذج المباشر +### إعادة المحاولة عند تبديل النموذج الحي -إذا طرح تشغيل معزول `LiveSessionModelSwitchError`، يحفظ cron المزوّد والنموذج اللذين تم التبديل إليهما (وتجاوز ملف المصادقة الذي تم التبديل إليه عند وجوده) للتشغيل النشط قبل إعادة المحاولة. حلقة إعادة المحاولة الخارجية محدودة بإعادتَي محاولة للتبديل بعد المحاولة الأولية، ثم تتوقف بدل الدوران إلى الأبد. +إذا ألقى تشغيل معزول `LiveSessionModelSwitchError`، يحفظ Cron المزوّد والنموذج اللذين تم التبديل إليهما (وتجاوز ملف المصادقة الذي تم التبديل إليه عند وجوده) للتشغيل النشط قبل إعادة المحاولة. حلقة إعادة المحاولة الخارجية محددة بمحاولتي تبديل بعد المحاولة الأولية، ثم تُجهض بدلًا من الدوران إلى الأبد. ## مخرجات التشغيل والرفض -### كبت الإقرارات القديمة +### كبت إقرارات الاستلام القديمة -تكبت دورات cron المعزولة الردود القديمة التي لا تحتوي إلا على إقرار. إذا كانت النتيجة الأولى مجرد تحديث حالة مؤقت ولا توجد عملية وكيل فرعي لاحقة مسؤولة عن الإجابة النهائية، يعيد cron المطالبة مرة واحدة للحصول على النتيجة الحقيقية قبل التسليم. +تكبت أدوار Cron المعزولة الردود القديمة التي لا تحتوي إلا على إقرار. إذا كانت النتيجة الأولى مجرد تحديث حالة مؤقت ولا يوجد تشغيل وكيل فرعي تابع مسؤول عن الإجابة النهائية، يعيد Cron المطالبة مرة واحدة للحصول على النتيجة الحقيقية قبل التسليم. ### كبت الرمز الصامت -إذا أعاد تشغيل cron معزول الرمز الصامت فقط (`NO_REPLY` أو `no_reply`)، يكبت cron كلًا من التسليم الصادر المباشر ومسار الملخص الاحتياطي الموضوع في قائمة الانتظار، لذلك لا يُنشر أي شيء مرة أخرى إلى المحادثة. +إذا أعاد تشغيل Cron معزول الرمز الصامت فقط (`NO_REPLY` أو `no_reply`)، يكبت Cron كلًا من التسليم الصادر المباشر ومسار الملخص الاحتياطي الموضوع في الطابور، فلا يُنشر أي شيء مرة أخرى إلى الدردشة. ### الرفض المنظم -تفضّل تشغيلات cron المعزولة بيانات تعريف رفض التنفيذ المنظمة من التشغيل المضمن، ثم تعود إلى علامات الرفض المعروفة في المخرجات النهائية، مثل `SYSTEM_RUN_DENIED` و`INVALID_REQUEST` وعبارات رفض ربط الموافقة. +تفضل تشغيلات Cron المعزولة بيانات وصفية منظمة لرفض التنفيذ من التشغيل المضمّن، ثم ترجع إلى علامات الرفض المعروفة في المخرجات النهائية، مثل `SYSTEM_RUN_DENIED` و`INVALID_REQUEST` وعبارات الرفض المرتبطة بالموافقة. -يعرض `cron list` وسجل التشغيلات سبب الرفض بدلًا من الإبلاغ عن الأمر المحظور كـ `ok`. +يعرض `cron list` وسجل التشغيل سبب الرفض بدلًا من الإبلاغ عن أمر محظور على أنه `ok`. ## الاحتفاظ -يُتحكم في الاحتفاظ والتقليم في الإعداد: +يُتحكم في الاحتفاظ والتنظيف في التهيئة: -- يقلّم `cron.sessionRetention` (الافتراضي `24h`) جلسات التشغيل المعزولة المكتملة. -- يقلّم `cron.runLog.maxBytes` و`cron.runLog.keepLines` الملف `~/.openclaw/cron/runs/.jsonl`. +- يزيل `cron.sessionRetention` (الافتراضي `24h`) جلسات التشغيل المعزولة المكتملة. +- يزيل `cron.runLog.maxBytes` و`cron.runLog.keepLines` من `~/.openclaw/cron/runs/.jsonl`. ## ترحيل المهام الأقدم -إذا كانت لديك مهام cron من قبل تنسيق التسليم والتخزين الحالي، شغّل `openclaw doctor --fix`. يطبّع Doctor حقول cron القديمة (`jobId` و`schedule.cron` وحقول التسليم على المستوى الأعلى بما في ذلك `threadId` القديم وأسماء `provider` المستعارة للتسليم في الحمولة) ويرحّل مهام احتياطي Webhook البسيطة ذات `notify: true` إلى تسليم Webhook صريح عندما يكون `cron.webhook` مهيأً. +إذا كانت لديك مهام Cron من قبل تنسيق التسليم والتخزين الحالي، فشغّل `openclaw doctor --fix`. تقوم أداة `doctor` بتطبيع حقول Cron القديمة (`jobId` و`schedule.cron` وحقول التسليم ذات المستوى الأعلى بما في ذلك `threadId` القديم، وأسماء التسليم البديلة `provider` في الحمولة) وترحّل مهام Webhook الاحتياطية البسيطة ذات `notify: true` إلى تسليم Webhook صريح عندما يكون `cron.webhook` مهيأ. ## تعديلات شائعة @@ -196,7 +196,7 @@ openclaw cron edit --announce --channel slack --to "channel:C1234567890 openclaw cron edit --announce --channel telegram --to "-1001234567890" --thread-id 42 ``` -أنشئ مهمة معزولة مع سياق تمهيد خفيف: +أنشئ مهمة معزولة بسياق تمهيد خفيف: ```bash openclaw cron add \ @@ -208,9 +208,9 @@ openclaw cron add \ --no-deliver ``` -ينطبق `--light-context` على مهام دورات الوكيل المعزولة فقط. بالنسبة إلى تشغيلات cron، يبقي الوضع الخفيف سياق التمهيد فارغًا بدلًا من حقن مجموعة تمهيد مساحة العمل الكاملة. +ينطبق `--light-context` على مهام أدوار الوكيل المعزولة فقط. بالنسبة إلى تشغيلات Cron، يُبقي الوضع الخفيف سياق التمهيد فارغًا بدلًا من حقن مجموعة تمهيد مساحة العمل الكاملة. -## أوامر إدارة شائعة +## أوامر الإدارة الشائعة التشغيل اليدوي والفحص: @@ -222,7 +222,7 @@ openclaw cron run --due openclaw cron runs --id --limit 50 ``` -تتضمن إدخالات `cron runs` تشخيصات التسليم مع هدف cron المقصود، والهدف المحلول، وإرسالات أداة الرسائل، واستخدام الاحتياطي، وحالة التسليم. +تتضمن إدخالات `cron runs` تشخيصات التسليم مع هدف Cron المقصود، والهدف المحلول، وإرسالات أداة الرسائل، واستخدام الاحتياط، وحالة التسليم. إعادة استهداف الوكيل والجلسة: @@ -233,6 +233,8 @@ openclaw cron edit --session current openclaw cron edit --session "session:daily-brief" ``` +يحذر `openclaw cron add` عند حذف `--agent` في مهام أدوار الوكيل ويرجع إلى الوكيل الافتراضي (`main`). مرر `--agent ` وقت الإنشاء لتثبيت وكيل محدد. + تعديلات التسليم: ```bash @@ -242,7 +244,7 @@ openclaw cron edit --no-best-effort-deliver openclaw cron edit --no-deliver ``` -## ذو صلة +## ذات صلة - [مرجع CLI](/ar/cli) - [المهام المجدولة](/ar/automation/cron-jobs) diff --git a/docs/ar/plugins/community.md b/docs/ar/plugins/community.md index dd2fcf99e..08973508f 100644 --- a/docs/ar/plugins/community.md +++ b/docs/ar/plugins/community.md @@ -1,33 +1,33 @@ --- read_when: - - تريد العثور على Plugins من جهات خارجية لـ OpenClaw + - تريد العثور على Plugins تابعة لجهات خارجية لـ OpenClaw - تريد نشر Plugin الخاص بك أو إدراجه -summary: 'Plugins OpenClaw التي يتولى المجتمع صيانتها: تصفّحها وثبّتها وقدّم Plugin الخاص بك' +summary: 'plugins الخاصة بـ OpenClaw التي يصونها المجتمع: تصفّحها وثبّتها وقدّم Plugin الخاص بك' title: Plugins المجتمع x-i18n: - generated_at: "2026-04-30T08:13:11Z" + generated_at: "2026-04-30T09:34:53Z" model: gpt-5.5 provider: openai - source_hash: a54130fefc55042d53270e5f7f4b49a4aad715570743013fbfe06b0e2fa067d0 + source_hash: 9685aaf141b739a2a745a6184201ac86689e4284bec6eb068ffbd0d53fb4ecf1 source_path: plugins/community.md workflow: 16 --- -Plugins المجتمع هي حزم تابعة لجهات خارجية توسّع OpenClaw بقنوات أو أدوات أو مزوّدين أو قدرات أخرى جديدة. يبنيها المجتمع ويتولّى صيانتها، وتُنشر عادةً على [ClawHub](/ar/tools/clawhub)، ويمكن تثبيتها بأمر واحد. يبقى npm خيارًا احتياطيًا مدعومًا للحزم التي لم تنتقل إلى ClawHub بعد. +Plugins المجتمع هي حزم تابعة لجهات خارجية توسّع OpenClaw بقنوات أو أدوات أو مزوّدين أو قدرات أخرى جديدة. يبنيها المجتمع ويصونها، وتُنشر عادةً على [ClawHub](/ar/tools/clawhub)، ويمكن تثبيتها بأمر واحد. يظل npm خيارًا احتياطيًا مدعومًا للحزم التي لم تنتقل إلى ClawHub بعد. -ClawHub هو سطح الاكتشاف المعتمد لـ Plugins المجتمع. لا تفتح طلبات PR خاصة بالتوثيق فقط لإضافة Plugin الخاص بك هنا بهدف قابلية الاكتشاف؛ انشره على ClawHub بدلًا من ذلك. +ClawHub هو واجهة الاكتشاف الأساسية لـ Plugins المجتمع. لا تفتح طلبات PR للوثائق فقط لإضافة Plugin الخاص بك هنا بغرض قابلية الاكتشاف؛ انشره على ClawHub بدلًا من ذلك. ```bash openclaw plugins install ``` -يتحقق OpenClaw من ClawHub أولًا ثم يعود إلى npm تلقائيًا. +يتحقق OpenClaw من ClawHub أولًا ويعود إلى npm تلقائيًا عند الحاجة. ## Plugins المدرجة ### Apify -اكشط البيانات من أي موقع ويب باستخدام أكثر من 20,000 كاشط جاهز. دع وكيلك يستخرج البيانات من Instagram وFacebook وTikTok وYouTube وGoogle Maps وGoogle Search ومواقع التجارة الإلكترونية والمزيد، بمجرد الطلب. +اكشط البيانات من أي موقع ويب باستخدام أكثر من 20,000 كاشط جاهز. دع وكيلك يستخرج البيانات من Instagram وFacebook وTikTok وYouTube وGoogle Maps وGoogle Search ومواقع التجارة الإلكترونية وغيرها — بمجرد الطلب. - **npm:** `@apify/apify-openclaw-plugin` - **المستودع:** [github.com/apify/apify-openclaw-plugin](https://github.com/apify/apify-openclaw-plugin) @@ -38,7 +38,7 @@ openclaw plugins install @apify/apify-openclaw-plugin ### Codex App Server Bridge -جسر OpenClaw مستقل لمحادثات Codex App Server. اربط محادثة بسلسلة Codex، وتحدث إليها بنص عادي، وتحكم بها باستخدام أوامر أصلية للمحادثة للاستئناف، والتخطيط، والمراجعة، واختيار النموذج، وCompaction، والمزيد. +جسر OpenClaw مستقل لمحادثات Codex App Server. اربط دردشة بسلسلة Codex، وتحدث إليها بنص عادي، وتحكم بها عبر أوامر أصلية للدردشة للاستئناف، والتخطيط، والمراجعة، واختيار النموذج، وCompaction، والمزيد. - **npm:** `openclaw-codex-app-server` - **المستودع:** [github.com/pwrdrvr/openclaw-codex-app-server](https://github.com/pwrdrvr/openclaw-codex-app-server) @@ -49,7 +49,7 @@ openclaw plugins install openclaw-codex-app-server ### DingTalk -تكامل روبوت للمؤسسات باستخدام وضع Stream. يدعم الرسائل النصية والصور ورسائل الملفات عبر أي عميل DingTalk. +تكامل روبوت مؤسسي باستخدام وضع Stream. يدعم رسائل النصوص والصور والملفات عبر أي عميل DingTalk. - **npm:** `@largezhou/ddingtalk` - **المستودع:** [github.com/largezhou/openclaw-dingtalk](https://github.com/largezhou/openclaw-dingtalk) @@ -60,7 +60,7 @@ openclaw plugins install @largezhou/ddingtalk ### Lossless Claw (LCM) -Plugin إدارة السياق بلا فقد لـ OpenClaw. تلخيص محادثات قائم على DAG مع Compaction تزايدي، يحافظ على أمانة السياق كاملةً مع تقليل استخدام الرموز. +Plugin إدارة السياق بلا فقدان لـ OpenClaw. تلخيص محادثات قائم على DAG مع Compaction تزايدي — يحافظ على أمانة السياق كاملةً مع تقليل استخدام الرموز. - **npm:** `@martian-engineering/lossless-claw` - **المستودع:** [github.com/Martian-Engineering/lossless-claw](https://github.com/Martian-Engineering/lossless-claw) @@ -71,7 +71,7 @@ openclaw plugins install @martian-engineering/lossless-claw ### Opik -Plugin رسمي يصدّر تتبعات الوكلاء إلى Opik. راقب سلوك الوكيل، والتكلفة، والرموز، والأخطاء، والمزيد. +Plugin رسمي يصدّر تتبعات الوكيل إلى Opik. راقب سلوك الوكيل، والتكلفة، والرموز، والأخطاء، والمزيد. - **npm:** `@opik/opik-openclaw` - **المستودع:** [github.com/comet-ml/opik-openclaw](https://github.com/comet-ml/opik-openclaw) @@ -82,7 +82,7 @@ openclaw plugins install @opik/opik-openclaw ### Prometheus Avatar -امنح وكيل OpenClaw الخاص بك صورة رمزية Live2D مع مزامنة شفاه في الوقت الحقيقي، وتعبيرات عاطفية، وتحويل النص إلى كلام. يتضمن أدوات للمبدعين لتوليد أصول الذكاء الاصطناعي والنشر بنقرة واحدة إلى Prometheus Marketplace. حاليًا في مرحلة ألفا. +امنح وكيل OpenClaw الخاص بك صورة رمزية Live2D مع مزامنة شفاه آنية، وتعبيرات عاطفية، وتحويل النص إلى كلام. يتضمن أدوات منشئين لتوليد أصول الذكاء الاصطناعي والنشر بنقرة واحدة إلى Prometheus Marketplace. حاليًا في مرحلة ألفا. - **npm:** `@prometheusavatar/openclaw-plugin` - **المستودع:** [github.com/myths-labs/prometheus-avatar](https://github.com/myths-labs/prometheus-avatar) @@ -93,9 +93,9 @@ openclaw plugins install @prometheusavatar/openclaw-plugin ### QQbot -صِل OpenClaw بـ QQ عبر QQ Bot API. يدعم المحادثات الخاصة، وإشارات المجموعات، ورسائل القنوات، والوسائط الغنية بما في ذلك الصوت، والصور، ومقاطع الفيديو، والملفات. +صل OpenClaw بـ QQ عبر QQ Bot API. يدعم الدردشات الخاصة، وإشارات المجموعات، ورسائل القنوات، والوسائط الغنية بما في ذلك الصوت والصور والفيديوهات والملفات. -تتضمن إصدارات OpenClaw الحالية QQ Bot. استخدم الإعداد المضمّن في [QQ Bot](/ar/channels/qqbot) للتثبيتات العادية؛ ثبّت هذا Plugin الخارجي فقط عندما تريد عمدًا الحزمة المستقلة التي تصونها Tencent. +تتضمن إصدارات OpenClaw الحالية QQ Bot. استخدم الإعداد المضمّن في [QQ Bot](/ar/channels/qqbot) للتثبيت العادي؛ ثبّت هذا Plugin الخارجي فقط عندما تريد عمدًا الحزمة المستقلة التي تصونها Tencent. - **npm:** `@tencent-connect/openclaw-qqbot` - **المستودع:** [github.com/tencent-connect/openclaw-qqbot](https://github.com/tencent-connect/openclaw-qqbot) @@ -106,7 +106,7 @@ openclaw plugins install @tencent-connect/openclaw-qqbot ### wecom -Plugin قناة WeCom لـ OpenClaw من فريق Tencent WeCom. يعمل عبر اتصالات WeCom Bot WebSocket المستمرة، ويدعم الرسائل المباشرة ومحادثات المجموعات، والردود المتدفقة، والمراسلة الاستباقية، ومعالجة الصور/الملفات، وتنسيق Markdown، والتحكم المضمّن في الوصول، وSkills المستندات/الاجتماعات/المراسلة. +Plugin قناة WeCom لـ OpenClaw من فريق Tencent WeCom. يعمل بواسطة اتصالات WeCom Bot WebSocket المستمرة، ويدعم الرسائل المباشرة ودردشات المجموعات، والردود المتدفقة، والمراسلة الاستباقية، ومعالجة الصور/الملفات، وتنسيق Markdown، والتحكم المدمج في الوصول، وSkills المستندات/الاجتماعات/المراسلة. - **npm:** `@wecom/wecom-openclaw-plugin` - **المستودع:** [github.com/WecomTeam/wecom-openclaw-plugin](https://github.com/WecomTeam/wecom-openclaw-plugin) @@ -117,53 +117,58 @@ openclaw plugins install @wecom/wecom-openclaw-plugin ### Yuanbao -Plugin قناة Yuanbao لـ OpenClaw من فريق Tencent Yuanbao. يعمل عبر اتصالات WebSocket المستمرة، ويدعم الرسائل المباشرة ومحادثات المجموعات، والردود المتدفقة، والمراسلة الاستباقية، ومعالجة الصور/الملفات/الصوت/الفيديو، وتنسيق Markdown، والتحكم المضمّن في الوصول، وقوائم أوامر الشرطة المائلة. +Plugin قناة Yuanbao لـ OpenClaw من فريق Tencent Yuanbao. يعمل بواسطة اتصالات WebSocket المستمرة، ويدعم الرسائل المباشرة ودردشات المجموعات، والردود المتدفقة، والمراسلة الاستباقية، ومعالجة الصور/الملفات/الصوت/الفيديو، وتنسيق Markdown، والتحكم المدمج في الوصول، وقوائم أوامر الشرطة المائلة. - **npm:** `openclaw-plugin-yuanbao` -- **المستودع:** [github.com/yb-claw/openclaw-plugin-yuanbao](https://github.com/yb-claw/openclaw-plugin-yuanbao) +- **المستودع:** [github.com/YuanbaoTeam/yuanbao-openclaw-plugin](https://github.com/YuanbaoTeam/yuanbao-openclaw-plugin) ```bash openclaw plugins install openclaw-plugin-yuanbao ``` -## أرسل Plugin الخاص بك +## إرسال Plugin الخاص بك -نرحب بـ Plugins المجتمع التي تكون مفيدة وموثقة وآمنة التشغيل. +نرحب بـ Plugins المجتمع التي تكون مفيدة وموثقة وآمنة للتشغيل. - + يجب أن يكون Plugin الخاص بك قابلًا للتثبيت عبر `openclaw plugins install \`. - انشر على [ClawHub](/ar/tools/clawhub) ما لم تكن تحتاج تحديدًا إلى توزيع npm فقط. + انشر إلى [ClawHub](/ar/tools/clawhub) ما لم تكن تحتاج تحديدًا إلى + توزيع عبر npm فقط. راجع [بناء Plugins](/ar/plugins/building-plugins) للاطلاع على الدليل الكامل. - - يجب أن تكون الشيفرة المصدرية في مستودع عام يتضمن وثائق إعداد ومتتبع مشكلات. + + يجب أن تكون الشيفرة المصدرية في مستودع عام يحتوي على وثائق إعداد ومتتبع + مشكلات. - - لا تحتاج إلى طلب PR للتوثيق فقط لجعل Plugin الخاص بك قابلًا للاكتشاف. انشره على ClawHub بدلًا من ذلك. + + لا تحتاج إلى طلب PR للوثائق لمجرد جعل Plugin الخاص بك قابلًا للاكتشاف. انشره + على ClawHub بدلًا من ذلك. - افتح طلب PR للتوثيق فقط عندما تحتاج وثائق مصدر OpenClaw إلى تغيير محتوى فعلي، مثل تصحيح إرشادات التثبيت أو إضافة توثيق عابر للمستودعات ينتمي إلى مجموعة الوثائق الرئيسية. + افتح طلب PR للوثائق فقط عندما تحتاج وثائق مصدر OpenClaw إلى تغيير محتوى + فعلي، مثل تصحيح إرشادات التثبيت أو إضافة وثائق عابرة للمستودعات + تنتمي إلى مجموعة الوثائق الرئيسية. ## معيار الجودة -| المتطلب | السبب | +| المتطلب | السبب | | --------------------------- | --------------------------------------------- | | منشور على ClawHub أو npm | يحتاج المستخدمون إلى عمل `openclaw plugins install` | | مستودع GitHub عام | مراجعة المصدر، وتتبع المشكلات، والشفافية | -| وثائق الإعداد والاستخدام | يحتاج المستخدمون إلى معرفة كيفية تكوينه | -| صيانة نشطة | تحديثات حديثة أو تعامل مستجيب مع المشكلات | +| وثائق الإعداد والاستخدام | يحتاج المستخدمون إلى معرفة كيفية تهيئته | +| صيانة نشطة | تحديثات حديثة أو تعامل متجاوب مع المشكلات | -قد تُرفض الأغلفة منخفضة الجهد أو الحزم ذات الملكية غير الواضحة أو غير المصانة. +قد تُرفض الأغلفة منخفضة الجهد، أو الملكية غير الواضحة، أو الحزم غير المصانة. ## ذو صلة -- [تثبيت Plugins وتكوينها](/ar/tools/plugin) — كيفية تثبيت أي Plugin -- [بناء Plugins](/ar/plugins/building-plugins) — أنشئ Plugin الخاص بك +- [تثبيت Plugins وتهيئتها](/ar/tools/plugin) — كيفية تثبيت أي Plugin +- [بناء Plugins](/ar/plugins/building-plugins) — أنشئ ما يخصك - [بيان Plugin](/ar/plugins/manifest) — مخطط البيان