الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
البدء السريع وإعداد التشغيل الأول

استخدم وكيل ذكاء اصطناعي محليًا يمكنه رؤية جهازك. هذا أكثر فعالية بكثير من السؤال في Discord، لأن معظم حالات “أنا عالق” تكون مشكلات إعدادات محلية أو بيئة محلية لا يستطيع المساعدون عن بُعد فحصها.تستطيع هذه الأدوات قراءة المستودع، وتشغيل الأوامر، وفحص السجلات، والمساعدة في إصلاح الإعدادات على مستوى جهازك (PATH، والخدمات، والأذونات، وملفات المصادقة). امنحها نسخة كاملة من المصدر عبر تثبيت قابل للتعديل (git):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
يثبّت هذا OpenClaw من نسخة git، لذلك يمكن للوكيل قراءة الكود + الوثائق والاستدلال حول الإصدار الدقيق الذي تشغّله. يمكنك دائمًا الرجوع إلى الإصدار المستقر لاحقًا بإعادة تشغيل المثبّت من دون --install-method git.نصيحة: اطلب من الوكيل تخطيط الإصلاح والإشراف عليه (خطوة بخطوة)، ثم تنفيذ الأوامر الضرورية فقط. هذا يبقي التغييرات صغيرة وأسهل في المراجعة.إذا اكتشفت خللًا حقيقيًا أو إصلاحًا، فيرجى فتح issue على GitHub أو إرسال PR: https://github.com/openclaw/openclaw/issues https://github.com/openclaw/openclaw/pullsابدأ بهذه الأوامر (شارك المخرجات عند طلب المساعدة):
openclaw status
openclaw models status
openclaw doctor
ما الذي تفعله:
  • openclaw status: لقطة سريعة لصحة gateway/agent + الإعدادات الأساسية.
  • openclaw models status: يتحقق من مصادقة المزوّد + توفر النماذج.
  • openclaw doctor: يتحقق من مشكلات الإعدادات/الحالة الشائعة ويصلحها.
فحوصات CLI أخرى مفيدة: openclaw status --all، وopenclaw logs --follow، وopenclaw gateway status، وopenclaw health --verbose.حلقة تصحيح سريعة: أول 60 ثانية إذا كان هناك شيء معطل. وثائق التثبيت: التثبيت، أعلام المثبّت، التحديث.
أسباب تخطي Heartbeat الشائعة:
  • quiet-hours: خارج نافذة ساعات النشاط المكوّنة
  • empty-heartbeat-file: يوجد HEARTBEAT.md لكنه يحتوي فقط على هيكل فارغ/بعناوين فقط
  • no-tasks-due: وضع مهام HEARTBEAT.md نشط، لكن لم يحِن بعد أي من فواصل المهام
  • alerts-disabled: كل عناصر إظهار Heartbeat معطلة (showOk، وshowAlerts، وuseIndicator كلها متوقفة)
في وضع المهام، لا تُقدَّم الطوابع الزمنية المستحقة إلا بعد اكتمال تشغيل Heartbeat حقيقي. لا تُعلّم عمليات التشغيل المتخطاة المهام على أنها مكتملة.الوثائق: Heartbeat، الأتمتة والمهام.
يوصي المستودع بالتشغيل من المصدر واستخدام الإعداد الأولي:
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
يمكن للمعالج أيضًا بناء أصول الواجهة تلقائيًا. بعد الإعداد الأولي، تشغّل عادةً Gateway على المنفذ 18789.من المصدر (للمساهمين/المطورين):
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
openclaw onboard
إذا لم يكن لديك تثبيت عام بعد، فشغّله عبر pnpm openclaw onboard.
يفتح المعالج متصفحك بعنوان URL نظيف للوحة المعلومات (من دون رمز مضمّن) مباشرة بعد الإعداد الأولي ويطبع الرابط أيضًا في الملخص. أبقِ ذلك التبويب مفتوحًا؛ إذا لم يُفتح، فانسخ/الصق عنوان URL المطبوع على الجهاز نفسه.
Localhost (الجهاز نفسه):
  • افتح http://127.0.0.1:18789/.
  • إذا طلب مصادقة السر المشترك، فالصق الرمز أو كلمة المرور المكوّنة في إعدادات Control UI.
  • مصدر الرمز: gateway.auth.token (أو OPENCLAW_GATEWAY_TOKEN).
  • مصدر كلمة المرور: gateway.auth.password (أو OPENCLAW_GATEWAY_PASSWORD).
  • إذا لم يكن هناك سر مشترك مكوّن بعد، فأنشئ رمزًا باستخدام openclaw doctor --generate-gateway-token.
ليس على localhost:
  • Tailscale Serve (موصى به): أبقِ الربط على loopback، وشغّل openclaw gateway --tailscale serve، وافتح https://<magicdns>/. إذا كان gateway.auth.allowTailscale يساوي true، فإن ترويسات الهوية تفي بمصادقة Control UI/WebSocket (من دون لصق سر مشترك، مع افتراض موثوقية مضيف Gateway)؛ لا تزال واجهات HTTP APIs تتطلب مصادقة السر المشترك ما لم تستخدم عمدًا private-ingress none أو مصادقة HTTP عبر trusted-proxy. تُسلسل محاولات مصادقة Serve المتزامنة السيئة من العميل نفسه قبل أن يسجلها محدد المصادقة الفاشلة، لذلك قد تُظهر إعادة المحاولة السيئة الثانية بالفعل retry later.
  • ربط Tailnet: شغّل openclaw gateway --bind tailnet --token "<token>" (أو كوّن مصادقة كلمة المرور)، وافتح http://<tailscale-ip>:18789/، ثم الصق السر المشترك المطابق في إعدادات لوحة المعلومات.
  • وكيل عكسي واعٍ بالهوية: أبقِ Gateway خلف وكيل موثوق، وكوّن gateway.auth.mode: "trusted-proxy"، ثم افتح عنوان URL الخاص بالوكيل. تتطلب وكلاء loopback على المضيف نفسه ضبطًا صريحًا لـ gateway.auth.trustedProxy.allowLoopback = true.
  • نفق SSH: ssh -N -L 18789:127.0.0.1:18789 user@host ثم افتح http://127.0.0.1:18789/. تظل مصادقة السر المشترك مطبقة عبر النفق؛ الصق الرمز أو كلمة المرور المكوّنة إذا طُلب منك ذلك.
راجع لوحة المعلومات وأسطح الويب لمعرفة أوضاع الربط وتفاصيل المصادقة.
تتحكم في طبقات مختلفة:
  • approvals.exec: يمرر مطالبات الموافقة إلى وجهات الدردشة
  • channels.<channel>.execApprovals: يجعل تلك القناة تعمل كعميل موافقة أصلي لموافقات exec
تظل سياسة exec الخاصة بالمضيف بوابة الموافقة الحقيقية. يتحكم إعداد الدردشة فقط في مكان ظهور مطالبات الموافقة وكيف يمكن للأشخاص الرد عليها.في معظم الإعدادات، لا تحتاج إلى كليهما:
  • إذا كانت الدردشة تدعم بالفعل الأوامر والردود، فإن /approve في الدردشة نفسها يعمل عبر المسار المشترك.
  • إذا كان بإمكان قناة أصلية مدعومة استنتاج الموافقين بأمان، فإن OpenClaw يفعّل الآن تلقائيًا الموافقات الأصلية التي تبدأ بالرسائل المباشرة عندما يكون channels.<channel>.execApprovals.enabled غير مضبوط أو "auto".
  • عندما تتوفر بطاقات/أزرار الموافقة الأصلية، تكون تلك الواجهة الأصلية هي المسار الأساسي؛ ويجب على الوكيل تضمين أمر /approve يدوي فقط إذا كانت نتيجة الأداة تقول إن موافقات الدردشة غير متاحة أو إن الموافقة اليدوية هي المسار الوحيد.
  • استخدم approvals.exec فقط عندما يجب أيضًا تمرير المطالبات إلى دردشات أخرى أو غرف عمليات صريحة.
  • استخدم channels.<channel>.execApprovals.target: "channel" أو "both" فقط عندما تريد صراحةً نشر مطالبات الموافقة مرة أخرى في الغرفة/الموضوع الأصلي.
  • موافقات Plugin منفصلة أيضًا: تستخدم /approve في الدردشة نفسها افتراضيًا، وتمرير approvals.plugin اختياريًا، وتحتفظ بعض القنوات الأصلية فقط بمعالجة plugin-approval-native فوق ذلك.
الخلاصة: التمرير مخصص للتوجيه، وإعداد العميل الأصلي مخصص لتجربة مستخدم أغنى خاصة بالقناة. راجع موافقات Exec.
يلزم Node >= 22. يوصى باستخدام pnpm. لا يوصى باستخدام Bun مع Gateway.
نعم. Gateway خفيف - تذكر الوثائق أن 512MB-1GB RAM، و1 core، وحوالي 500MB من مساحة القرص تكفي للاستخدام الشخصي، وتشير إلى أن Raspberry Pi 4 يمكنه تشغيله.إذا أردت هامشًا إضافيًا (للسجلات، والوسائط، والخدمات الأخرى)، فإن 2GB موصى بها، لكنها ليست حدًا أدنى صارمًا.نصيحة: يمكن لـ Pi/VPS صغير استضافة Gateway، ويمكنك إقران العُقد على حاسوبك المحمول/هاتفك من أجل الشاشة/الكاميرا/اللوحة المحلية أو تنفيذ الأوامر. راجع العُقد.
الخلاصة: يعمل، لكن توقع بعض الحواف الخشنة.
  • استخدم نظام تشغيل 64-bit وأبقِ Node >= 22.
  • فضّل التثبيت القابل للتعديل (git) حتى تتمكن من رؤية السجلات والتحديث بسرعة.
  • ابدأ من دون قنوات/Skills، ثم أضفها واحدة تلو الأخرى.
  • إذا واجهت مشكلات ثنائية غريبة، فعادةً ما تكون مشكلة توافق ARM.
الوثائق: Linux، التثبيت.
تعتمد تلك الشاشة على إمكانية الوصول إلى Gateway والمصادقة معه. يرسل TUI أيضًا “Wake up, my friend!” تلقائيًا عند أول فقس. إذا رأيت ذلك السطر مع عدم وجود رد وبقيت الرموز عند 0، فهذا يعني أن الوكيل لم يعمل قط.
  1. أعد تشغيل Gateway:
openclaw gateway restart
  1. تحقق من الحالة + المصادقة:
openclaw status
openclaw models status
openclaw logs --follow
  1. إذا استمر التعليق، فشغّل:
openclaw doctor
إذا كان Gateway بعيدًا، فتأكد من أن اتصال النفق/Tailscale يعمل وأن الواجهة تشير إلى Gateway الصحيح. راجع الوصول البعيد.
نعم. انسخ دليل الحالة ومساحة العمل، ثم شغّل Doctor مرة واحدة. هذا يبقي روبوتك “كما هو تمامًا” (الذاكرة، وسجل الجلسات، والمصادقة، وحالة القنوات) ما دمت تنسخ كلا الموقعين:
  1. ثبّت OpenClaw على الجهاز الجديد.
  2. انسخ $OPENCLAW_STATE_DIR (الافتراضي: ~/.openclaw) من الجهاز القديم.
  3. انسخ مساحة عملك (الافتراضي: ~/.openclaw/workspace).
  4. شغّل openclaw doctor وأعد تشغيل خدمة Gateway.
يحافظ ذلك على الإعدادات، وملفات تعريف المصادقة، واعتمادات WhatsApp، والجلسات، والذاكرة. إذا كنت في الوضع البعيد، فتذكر أن مضيف Gateway يملك مخزن الجلسات ومساحة العمل.مهم: إذا اكتفيت بإيداع/دفع مساحة عملك إلى GitHub، فأنت تنسخ احتياطيًا الذاكرة + ملفات bootstrap، لكن ليس سجل الجلسات أو المصادقة. تلك موجودة تحت ~/.openclaw/ (على سبيل المثال ~/.openclaw/agents/<agentId>/sessions/).ذو صلة: الترحيل، أين توجد الأشياء على القرص، مساحة عمل الوكيل، Doctor، الوضع البعيد.
تحقق من سجل التغييرات على GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.mdتوجد أحدث الإدخالات في الأعلى. إذا كان القسم العلوي موسومًا Unreleased، فإن القسم المؤرخ التالي هو أحدث إصدار مشحون. تُجمّع الإدخالات حسب أبرز النقاط، والتغييرات، و الإصلاحات (بالإضافة إلى أقسام الوثائق/الأقسام الأخرى عند الحاجة).
تحظر بعض اتصالات Comcast/Xfinity بشكل غير صحيح docs.openclaw.ai عبر Xfinity Advanced Security. عطّله أو أضف docs.openclaw.ai إلى قائمة السماح، ثم أعد المحاولة. يُرجى مساعدتنا في رفع الحظر عنه بالإبلاغ هنا: https://spa.xfinity.com/check_url_status.إذا كنت ما زلت لا تستطيع الوصول إلى الموقع، فالوثائق منعكسة على GitHub: https://github.com/openclaw/openclaw/tree/main/docs
الإصدار المستقر وبيتا هما وسما توزيع npm، وليسا خطي كود منفصلين:
  • latest = مستقر
  • beta = بنية مبكرة للاختبار
عادة، يصل الإصدار المستقر إلى بيتا أولاً، ثم تنقل خطوة ترقية صريحة الإصدار نفسه إلى latest. يمكن للمشرفين أيضاً النشر مباشرة إلى latest عند الحاجة. لهذا يمكن أن يشير بيتا والمستقر إلى الإصدار نفسه بعد الترقية.اطّلع على ما تغيّر: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.mdلمختصرات التثبيت من سطر واحد والفرق بين بيتا وdev، راجع الأكورديون أدناه.
بيتا هو وسم توزيع npm beta (قد يطابق latest بعد الترقية). Dev هو الرأس المتحرك لـmain (git)؛ وعند نشره، يستخدم وسم توزيع npm dev.أوامر من سطر واحد (macOS/Linux):
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
مثبّت Windows (PowerShell): https://openclaw.ai/install.ps1مزيد من التفاصيل: قنوات التطوير وأعلام المثبّت.
خياران:
  1. قناة Dev (git checkout):
openclaw update --channel dev
ينتقل هذا إلى فرع main ويحدّث من المصدر.
  1. تثبيت قابل للتعديل (من موقع المثبّت):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
يمنحك هذا مستودعاً محلياً يمكنك تعديله، ثم تحديثه عبر git.إذا كنت تفضّل استنساخاً نظيفاً يدوياً، فاستخدم:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
الوثائق: التحديث، قنوات التطوير، التثبيت.
دليل تقريبي:
  • التثبيت: 2-5 دقائق
  • التهيئة الأولية: 5-15 دقيقة حسب عدد القنوات/النماذج التي تهيئها
إذا تعلّق، استخدم المثبّت عالق وحلقة التصحيح السريعة في أنا عالق.
أعد تشغيل المثبّت مع إخراج مفصّل:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
تثبيت بيتا مع الإخراج المفصّل:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
لتثبيت قابل للتعديل (git):
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose
المكافئ على Windows (PowerShell):
# install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
خيارات أكثر: أعلام المثبّت.
مشكلتان شائعتان على Windows:1) خطأ npm spawn git / git غير موجود
  • ثبّت Git for Windows وتأكد من أن git موجود في PATH لديك.
  • أغلق PowerShell وافتحه من جديد، ثم أعد تشغيل المثبّت.
2) لا يتم التعرف على openclaw بعد التثبيت
  • مجلد npm global bin لديك غير موجود في PATH.
  • تحقق من المسار: 
    npm config get prefix
  • أضف ذلك الدليل إلى PATH الخاص بالمستخدم لديك (لا حاجة إلى لاحقة \bin على Windows؛ في معظم الأنظمة يكون %AppData%\npm).
  • أغلق PowerShell وافتحه من جديد بعد تحديث PATH.
إذا كنت تريد أسلس إعداد على Windows، فاستخدم WSL2 بدلاً من Windows الأصلي. الوثائق: Windows.
يحدث هذا عادة بسبب عدم تطابق صفحة ترميز وحدة التحكم في صدَفات Windows الأصلية.الأعراض:
  • إخراج system.run/exec يعرض الصينية كنص mojibake
  • يبدو الأمر نفسه سليماً في ملف تعريف طرفية آخر
حل سريع في PowerShell:
chcp 65001
[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)
[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
$OutputEncoding = [System.Text.UTF8Encoding]::new($false)
ثم أعد تشغيل Gateway وجرّب الأمر مرة أخرى:
openclaw gateway restart
إذا كنت ما زلت تستطيع إعادة إنتاج ذلك على أحدث OpenClaw، فتتبّعه/أبلغ عنه في:
استخدم التثبيت القابل للتعديل (git) بحيث تكون لديك الشيفرة المصدرية والوثائق كاملة محلياً، ثم اسأل البوت لديك (أو Claude/Codex) من ذلك المجلد حتى يتمكن من قراءة المستودع والإجابة بدقة.
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
مزيد من التفاصيل: التثبيت وأعلام المثبّت.
الإجابة المختصرة: اتبع دليل Linux، ثم شغّل التهيئة الأولية.
يعمل أي VPS بنظام Linux. ثبّت على الخادم، ثم استخدم SSH/Tailscale للوصول إلى Gateway.الأدلة: exe.dev، Hetzner، Fly.io. الوصول عن بُعد: Gateway البعيد.
نحتفظ بمركز استضافة يضم المزوّدين الشائعين. اختر واحداً واتبع الدليل:كيف يعمل ذلك في السحابة: يعمل Gateway على الخادم، وتصل إليه من حاسوبك المحمول/هاتفك عبر واجهة التحكم (أو Tailscale/SSH). حالتك + مساحة عملك تبقى على الخادم، لذلك تعامل مع المضيف كمصدر الحقيقة وانسخه احتياطياً.يمكنك إقران العُقد (Mac/iOS/Android/بلا واجهة) بذلك Gateway السحابي للوصول إلى الشاشة/الكاميرا/canvas المحلية أو تشغيل أوامر على حاسوبك المحمول مع إبقاء Gateway في السحابة.المركز: المنصات. الوصول عن بُعد: Gateway البعيد. العُقد: العُقد، CLI العُقد.
الإجابة المختصرة: ممكن، غير موصى به. قد تعيد عملية التحديث تشغيل Gateway (ما يسقط الجلسة النشطة)، وقد تحتاج إلى git checkout نظيف، وقد تطلب تأكيداً. الأكثر أماناً: شغّل التحديثات من صدفة بصفتك المشغّل.استخدم CLI:
openclaw update
openclaw update status
openclaw update --channel stable|beta|dev
openclaw update --tag <dist-tag|version>
openclaw update --no-restart
إذا كان لا بد من الأتمتة من agent:
openclaw update --yes --no-restart
openclaw gateway restart
الوثائق: التحديث، التحديثات.
openclaw onboard هو مسار الإعداد الموصى به. في الوضع المحلي يرشدك عبر:
  • إعداد النموذج/المصادقة (OAuth للمزوّد، مفاتيح API، setup-token من Anthropic، إضافة إلى خيارات النماذج المحلية مثل LM Studio)
  • موقع مساحة العمل + ملفات التمهيد
  • إعدادات Gateway (bind/port/auth/tailscale)
  • القنوات (WhatsApp، Telegram، Discord، Mattermost، Signal، iMessage، إضافة إلى Plugins القنوات المضمّنة مثل QQ Bot)
  • تثبيت daemon (LaunchAgent على macOS؛ وحدة مستخدم systemd على Linux/WSL2)
  • فحوصات الصحة واختيار Skills
كما يحذّرك إذا كان النموذج المهيأ غير معروف أو تنقصه المصادقة.
لا. يمكنك تشغيل OpenClaw باستخدام مفاتيح API (Anthropic/OpenAI/غيرهما) أو باستخدام نماذج محلية فقط بحيث تبقى بياناتك على جهازك. الاشتراكات (Claude Pro/Max أو OpenAI Codex) طرق اختيارية لمصادقة هؤلاء المزوّدين.بالنسبة إلى Anthropic في OpenClaw، التقسيم العملي هو:
  • مفتاح API من Anthropic: فوترة Anthropic API العادية
  • Claude CLI / مصادقة اشتراك Claude في OpenClaw: أخبرنا موظفو Anthropic أن هذا الاستخدام مسموح به مجدداً، ويتعامل OpenClaw مع استخدام claude -p باعتباره معتمداً لهذا التكامل ما لم تنشر Anthropic سياسة جديدة
بالنسبة إلى مضيفي gateway طويلي العمر، ما تزال مفاتيح API من Anthropic هي الإعداد الأكثر قابلية للتنبؤ. OAuth الخاص بـ OpenAI Codex مدعوم صراحة للأدوات الخارجية مثل OpenClaw.يدعم OpenClaw أيضاً خيارات مستضافة أخرى بأسلوب الاشتراك، منها Qwen Cloud Coding Plan وMiniMax Coding Plan و Z.AI / GLM Coding Plan.الوثائق: Anthropic، OpenAI، Qwen Cloud، MiniMax، نماذج GLM، النماذج المحلية، النماذج.
نعم.أخبرنا موظفو Anthropic أن استخدام Claude CLI بأسلوب OpenClaw مسموح به مجدداً، لذلك يتعامل OpenClaw مع مصادقة اشتراك Claude واستخدام claude -p باعتبارهما معتمدين لهذا التكامل ما لم تنشر Anthropic سياسة جديدة. إذا كنت تريد الإعداد الخادمي الأكثر قابلية للتنبؤ، فاستخدم مفتاح API من Anthropic بدلاً من ذلك.
نعم.أخبرنا موظفو Anthropic أن هذا الاستخدام مسموح به مجدداً، لذلك يتعامل OpenClaw مع إعادة استخدام Claude CLI واستخدام claude -p باعتبارهما معتمدين لهذا التكامل ما لم تنشر Anthropic سياسة جديدة.ما يزال Anthropic setup-token متاحاً كمسار رمز مدعوم في OpenClaw، لكن OpenClaw يفضّل الآن إعادة استخدام Claude CLI وclaude -p عند توفرهما. بالنسبة إلى أعباء العمل الإنتاجية أو متعددة المستخدمين، ما تزال مصادقة مفتاح API من Anthropic هي الخيار الأكثر أماناً وقابلية للتنبؤ. إذا كنت تريد خيارات مستضافة أخرى بأسلوب الاشتراك في OpenClaw، فراجع OpenAI، Qwen / Model Cloud، MiniMax، ونماذج GLM.
يعني ذلك أن حصة/حد معدل Anthropic لديك قد استُنفد للنافذة الحالية. إذا كنت تستخدم Claude CLI، فانتظر إعادة ضبط النافذة أو رقِّ خطتك. إذا كنت تستخدم مفتاح API من Anthropic، فتحقق من Anthropic Console للاستخدام/الفوترة وارفع الحدود حسب الحاجة.إذا كانت الرسالة تحديدًا: Extra usage is required for long context requests، فهذا يعني أن الطلب يحاول استخدام إصدار Anthropic التجريبي لسياق 1M (context1m: true). يعمل ذلك فقط عندما تكون بيانات اعتمادك مؤهلة لفوترة السياق الطويل (فوترة مفتاح API أو مسار تسجيل الدخول إلى Claude في OpenClaw مع تفعيل Extra Usage).نصيحة: عيّن نموذجًا احتياطيًا حتى يتمكن OpenClaw من مواصلة الرد أثناء خضوع أحد المزوّدين لقيود المعدّل. راجع النماذج، وOAuth، و /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context.
نعم. يحتوي OpenClaw على مزوّد Amazon Bedrock (Converse) مضمّن. عند وجود علامات بيئة AWS، يمكن لـ OpenClaw اكتشاف كتالوج Bedrock للبث/النص تلقائيًا ودمجه كمزوّد amazon-bedrock ضمني؛ وإلا يمكنك تفعيل plugins.entries.amazon-bedrock.config.discovery.enabled صراحةً أو إضافة إدخال مزوّد يدوي. راجع Amazon Bedrock ومزوّدي النماذج. إذا كنت تفضّل تدفق مفتاح مُدار، فسيظل استخدام وكيل متوافق مع OpenAI أمام Bedrock خيارًا صالحًا.
يدعم OpenClaw OpenAI Code (Codex) عبر OAuth (تسجيل الدخول إلى ChatGPT). استخدم openai/gpt-5.5 للإعداد الشائع: مصادقة اشتراك ChatGPT/Codex بالإضافة إلى تنفيذ خادم تطبيق Codex الأصلي. مراجع نماذج openai-codex/gpt-* هي إعدادات قديمة يتم إصلاحها بواسطة openclaw doctor --fix. يظل الوصول المباشر باستخدام مفتاح OpenAI API متاحًا لأسطح OpenAI API غير الخاصة بالوكلاء ولنماذج الوكلاء عبر ملف تعريف مفتاح API مرتب باسم openai-codex. راجع مزوّدي النماذج والإعداد الأولي (CLI).
openai-codex هو معرّف المزوّد وملف تعريف المصادقة لـ OAuth الخاص بـ ChatGPT/Codex. استخدمته الإعدادات الأقدم أيضًا كبادئة نموذج:
  • openai/gpt-5.5 = مصادقة اشتراك ChatGPT/Codex مع وقت تشغيل Codex الأصلي لدورات الوكيل
  • openai-codex/gpt-5.5 = مسار نموذج قديم يتم إصلاحه بواسطة openclaw doctor --fix
  • openai/gpt-5.5 بالإضافة إلى ملف تعريف مفتاح API مرتب باسم openai-codex = مصادقة مفتاح API لنموذج وكيل OpenAI
  • openai-codex:... = معرّف ملف تعريف مصادقة، وليس مرجع نموذج
إذا كنت تريد مسار فوترة/حدود OpenAI Platform المباشر، فعيّن OPENAI_API_KEY. إذا كنت تريد مصادقة اشتراك ChatGPT/Codex، فسجّل الدخول باستخدام openclaw models auth login --provider openai-codex. أبقِ مرجع النموذج openai/gpt-5.5؛ مراجع نماذج openai-codex/* هي إعدادات قديمة يعيد openclaw doctor --fix كتابتها.
يستخدم Codex OAuth نوافذ حصص مُدارة من OpenAI وتعتمد على الخطة. عمليًا، يمكن أن تختلف هذه الحدود عن تجربة موقع/تطبيق ChatGPT، حتى عندما يكون كلاهما مرتبطًا بالحساب نفسه.يستطيع OpenClaw عرض نوافذ استخدام/حصة المزوّد المرئية حاليًا في openclaw models status، لكنه لا يخترع استحقاقات ChatGPT على الويب أو يطبّعها إلى وصول مباشر إلى API. إذا كنت تريد مسار فوترة/حدود OpenAI Platform المباشر، فاستخدم openai/* مع مفتاح API.
نعم. يدعم OpenClaw بالكامل OAuth لاشتراك OpenAI Code (Codex). تسمح OpenAI صراحةً باستخدام OAuth الخاص بالاشتراك في أدوات/تدفقات عمل خارجية مثل OpenClaw. يمكن للإعداد الأولي تشغيل تدفق OAuth نيابةً عنك.راجع OAuth، ومزوّدي النماذج، والإعداد الأولي (CLI).
يستخدم Gemini CLI تدفق مصادقة Plugin، وليس معرّف عميل أو سرًا في openclaw.json.الخطوات:
  1. ثبّت Gemini CLI محليًا حتى يكون gemini ضمن PATH
    • Homebrew: brew install gemini-cli
    • npm: npm install -g @google/gemini-cli
  2. فعّل Plugin: openclaw plugins enable google
  3. سجّل الدخول: openclaw models auth login --provider google-gemini-cli --set-default
  4. النموذج الافتراضي بعد تسجيل الدخول: google-gemini-cli/gemini-3-flash-preview
  5. إذا فشلت الطلبات، فعيّن GOOGLE_CLOUD_PROJECT أو GOOGLE_CLOUD_PROJECT_ID على مضيف Gateway
يخزّن هذا رموز OAuth في ملفات تعريف المصادقة على مضيف Gateway. التفاصيل: مزوّدو النماذج.
عادةً لا. يحتاج OpenClaw إلى سياق كبير وأمان قوي؛ البطاقات الصغيرة تقتطع وتسرّب. إذا كان لا بد من ذلك، فشغّل أكبر بناء نموذج يمكنك تشغيله محليًا (LM Studio) وراجع /gateway/local-models. تزيد النماذج الأصغر/المكمّمة خطر حقن المطالبات - راجع الأمان.
اختر نقاط نهاية مثبتة بالمنطقة. يوفّر OpenRouter خيارات مستضافة في الولايات المتحدة لـ MiniMax وKimi وGLM؛ اختر المتغير المستضاف في الولايات المتحدة لإبقاء البيانات داخل المنطقة. لا يزال بإمكانك إدراج Anthropic/OpenAI إلى جانب هذه باستخدام models.mode: "merge" حتى تظل البدائل الاحتياطية متاحة مع احترام المزوّد الإقليمي الذي تختاره.
لا. يعمل OpenClaw على macOS أو Linux (Windows عبر WSL2). جهاز Mac mini اختياري - يشتريه بعض الأشخاص كمضيف دائم التشغيل، لكن VPS صغيرًا أو خادمًا منزليًا أو جهازًا من فئة Raspberry Pi يعمل أيضًا.لا تحتاج إلى Mac إلا للأدوات الخاصة بـ macOS فقط. بالنسبة إلى iMessage، استخدم iMessage مع imsg على أي Mac مسجّل الدخول إلى Messages. إذا كان Gateway يعمل على Linux أو في مكان آخر، فعيّن channels.imessage.cliPath إلى مغلّف SSH يشغّل imsg على ذلك الـ Mac. إذا كنت تريد أدوات أخرى خاصة بـ macOS فقط، فشغّل Gateway على Mac أو اربط Node يعمل بنظام macOS.المستندات: iMessage، وNodes، ووضع Mac البعيد.
تحتاج إلى جهاز macOS ما مسجّل الدخول إلى Messages. لا يجب أن يكون Mac mini - أي Mac يفي بالغرض. استخدم iMessage مع imsg؛ يمكن تشغيل Gateway على ذلك الـ Mac، أو يمكن تشغيله في مكان آخر مع مغلّف SSH في cliPath.الإعدادات الشائعة:
  • شغّل Gateway على Linux/VPS، وعيّن channels.imessage.cliPath إلى مغلّف SSH يشغّل imsg على Mac مسجّل الدخول إلى Messages.
  • شغّل كل شيء على الـ Mac إذا كنت تريد أبسط إعداد على جهاز واحد.
المستندات: iMessage، وNodes، ووضع Mac البعيد.
نعم. يمكن أن يشغّل Mac mini الـ Gateway، ويمكن لـ MacBook Pro الخاص بك الاتصال كـ Node (جهاز مرافق). لا تشغّل Nodes الـ Gateway - بل توفّر قدرات إضافية مثل الشاشة/الكاميرا/اللوحة وsystem.run على ذلك الجهاز.النمط الشائع:
  • Gateway على Mac mini (دائم التشغيل).
  • يشغّل MacBook Pro تطبيق macOS أو مضيف Node ويرتبط بـ Gateway.
  • استخدم openclaw nodes status / openclaw nodes list لرؤيته.
المستندات: Nodes، وNodes CLI.
لا يُنصح باستخدام Bun. نرى أخطاء وقت تشغيل، خاصةً مع WhatsApp وTelegram. استخدم Node من أجل Gateways مستقرة.إذا كنت لا تزال تريد تجربة Bun، فافعل ذلك على Gateway غير إنتاجي بدون WhatsApp/Telegram.
channels.telegram.allowFrom هو معرّف مستخدم Telegram الخاص بالمرسل البشري (رقمي). وليس اسم مستخدم البوت.يطلب الإعداد معرّفات المستخدم الرقمية فقط. إذا كانت لديك بالفعل إدخالات @username قديمة في الإعداد، فيمكن لـ openclaw doctor --fix محاولة حلّها.أكثر أمانًا (بدون بوت تابع لجهة خارجية):
  • أرسل رسالة مباشرة إلى البوت، ثم شغّل openclaw logs --follow واقرأ from.id.
Bot API الرسمي:
  • أرسل رسالة مباشرة إلى البوت، ثم استدعِ https://api.telegram.org/bot<bot_token>/getUpdates واقرأ message.from.id.
جهة خارجية (أقل خصوصية):
  • أرسل رسالة مباشرة إلى @userinfobot أو @getidsbot.
راجع /channels/telegram.
نعم، عبر التوجيه متعدد الوكلاء. اربط الرسالة المباشرة في WhatsApp لكل مرسل (نظير kind: "direct"، مرسل بصيغة E.164 مثل +15551234567) بـ agentId مختلف، بحيث يحصل كل شخص على مساحة عمل ومخزن جلسات خاصين به. لا تزال الردود تأتي من حساب WhatsApp نفسه، والتحكم في وصول الرسائل المباشرة (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) عام لكل حساب WhatsApp. راجع التوجيه متعدد الوكلاء وWhatsApp.
نعم. استخدم التوجيه متعدد الوكلاء: أعطِ كل وكيل نموذجه الافتراضي الخاص، ثم اربط المسارات الواردة (حساب المزوّد أو نظراء محددين) بكل وكيل. يوجد مثال إعداد في التوجيه متعدد الوكلاء. راجع أيضًا النماذج والإعدادات.
نعم. يدعم Homebrew نظام Linux (Linuxbrew). إعداد سريع:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profile
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
brew install <formula>
إذا كنت تشغّل OpenClaw عبر systemd، فتأكد من أن PATH الخاص بالخدمة يتضمن /home/linuxbrew/.linuxbrew/bin (أو بادئة brew لديك) حتى تُحل أدوات brew المثبتة في أصداف غير تسجيل الدخول. تضيف الإصدارات الحديثة أيضًا مجلدات bin الشائعة للمستخدم في خدمات Linux systemd (على سبيل المثال ~/.local/bin و~/.npm-global/bin و~/.local/share/pnpm و~/.bun/bin) وتراعي PNPM_HOME وNPM_CONFIG_PREFIX وBUN_INSTALL وVOLTA_HOME وASDF_DATA_DIR وNVM_DIR وFNM_DIR عند تعيينها.
  • تثبيت قابل للتعديل (git): نسخة كاملة من المصدر، قابلة للتحرير، والأفضل للمساهمين. تشغّل عمليات البناء محليًا ويمكنك تعديل الكود/المستندات.
  • تثبيت npm: تثبيت CLI عام، بدون مستودع، والأفضل لمن يريد “تشغيله فقط”. تأتي التحديثات من وسوم توزيع npm.
المستندات: بدء الاستخدام، والتحديث.
نعم. استخدم openclaw update --channel ... عندما يكون OpenClaw مثبتًا بالفعل. هذا لا يحذف بياناتك - بل يغيّر تثبيت كود OpenClaw فقط. تظل حالتك (~/.openclaw) ومساحة عملك (~/.openclaw/workspace) كما هي دون مساس.من npm إلى git:
openclaw update --channel dev
من git إلى npm:
openclaw update --channel stable
أضف --dry-run لمعاينة تبديل الوضع المخطط له أولًا. يشغّل المحدّث متابعات Doctor، ويحدّث مصادر Plugin للقناة المستهدفة، ويعيد تشغيل Gateway ما لم تمرر --no-restart.يمكن للمثبّت فرض أي من الوضعين أيضًا:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm
نصائح النسخ الاحتياطي: راجع استراتيجية النسخ الاحتياطي.
الإجابة المختصرة: إذا كنت تريد موثوقية على مدار الساعة، فاستخدم VPS. إذا كنت تريد أقل قدر من التعقيد ولا تمانع السكون/إعادة التشغيل، فشغّله محليًا.الحاسوب المحمول (Gateway المحلي)
  • الإيجابيات: لا توجد تكلفة خادم، وصول مباشر إلى الملفات المحلية، نافذة متصفح مباشرة.
  • السلبيات: السكون/انقطاع الشبكة = انقطاع الاتصال، تحديثات/إعادات تشغيل نظام التشغيل تقاطع العمل، يجب أن يبقى الجهاز مستيقظًا.
VPS / السحابة
  • الإيجابيات: يعمل دائمًا، شبكة مستقرة، لا مشكلات سكون الحاسوب المحمول، أسهل في إبقائه قيد التشغيل.
  • السلبيات: غالبًا يعمل بلا واجهة رسومية (استخدم لقطات الشاشة)، وصول إلى الملفات عن بُعد فقط، يجب استخدام SSH للتحديثات.
ملاحظة خاصة بـ OpenClaw: تعمل WhatsApp/Telegram/Slack/Mattermost/Discord كلها جيدًا من VPS. المفاضلة الحقيقية الوحيدة هي متصفح بلا واجهة رسومية مقابل نافذة مرئية. راجع المتصفح.الإعداد الافتراضي الموصى به: VPS إذا واجهت انقطاعات في gateway من قبل. المحلي خيار ممتاز عندما تستخدم Mac بنشاط وتريد الوصول إلى الملفات المحلية أو أتمتة واجهة المستخدم مع متصفح مرئي.
ليس مطلوبًا، لكنه موصى به من أجل الموثوقية والعزل.
  • مضيف مخصص (VPS/Mac mini/Pi): يعمل دائمًا، انقطاعات أقل بسبب السكون/إعادة التشغيل، أذونات أنظف، أسهل في إبقائه قيد التشغيل.
  • حاسوب محمول/مكتبي مشترك: مناسب تمامًا للاختبار والاستخدام النشط، لكن توقّع توقفات مؤقتة عندما يدخل الجهاز في وضع السكون أو يجري تحديثات.
إذا كنت تريد أفضل ما في الخيارين، فأبقِ Gateway على مضيف مخصص واربط حاسوبك المحمول بصفته Node لأدوات الشاشة/الكاميرا/التنفيذ المحلية. راجع Nodes. للحصول على إرشادات الأمان، اقرأ الأمان.
OpenClaw خفيف الوزن. لأجل Gateway أساسي + قناة دردشة واحدة:
  • الحد الأدنى المطلق: وحدة vCPU واحدة، ذاكرة RAM بسعة 1GB، قرص بسعة ~500MB.
  • الموصى به: وحدة vCPU واحدة إلى وحدتين، وذاكرة RAM بسعة 2GB أو أكثر لتوفير هامش إضافي (السجلات، الوسائط، قنوات متعددة). قد تكون أدوات Node وأتمتة المتصفح كثيرة الاستهلاك للموارد.
نظام التشغيل: استخدم Ubuntu LTS (أو أي Debian/Ubuntu حديث). مسار التثبيت على Linux هو الأكثر اختبارًا هناك.المستندات: Linux، استضافة VPS.
نعم. تعامل مع VM مثل VPS: يجب أن يكون قيد التشغيل دائمًا، ويمكن الوصول إليه، ولديه ما يكفي من ذاكرة RAM لـ Gateway وأي قنوات تفعّلها.إرشادات خط الأساس:
  • الحد الأدنى المطلق: وحدة vCPU واحدة، ذاكرة RAM بسعة 1GB.
  • الموصى به: ذاكرة RAM بسعة 2GB أو أكثر إذا كنت تشغّل قنوات متعددة، أو أتمتة المتصفح، أو أدوات الوسائط.
  • نظام التشغيل: Ubuntu LTS أو Debian/Ubuntu حديث آخر.
إذا كنت تستخدم Windows، فإن WSL2 هو أسهل إعداد بأسلوب VM ولديه أفضل توافق مع الأدوات. راجع Windows، استضافة VPS. إذا كنت تشغّل macOS داخل VM، فراجع macOS VM.

​
ذات صلة