4 حلول لحل خطأ OpenClaw المتمثل في رفض طلب نموذج اللغة الكبير بسبب نفاد الاستخدام الإضافي

ملاحظة المؤلف: شرح مفصل لسبب ظهور خطأ LLM request rejected: You're out of extra usage عند استخدام Claude في OpenClaw، مع 4 حلول عملية تشمل شحن الرصيد الإضافي، تبديل مفتاح API، واستخدام خدمة وكيل API بدون قيود سرعة.

يعد ظهور خطأ LLM request rejected: You're out of extra usage فجأة عند استدعاء نموذج Claude عبر OpenClaw مشكلة شائعة واجهها العديد من المطورين مؤخراً. سنستعرض في هذا المقال السبب الجذري لهذا الخطأ (تغييرات سياسة Anthropic) و4 حلول مجربة لمساعدتك على استعادة العمل في OpenClaw بسرعة.

القيمة الأساسية: بعد قراءة هذا المقال، ستفهم سبب توقف اشتراك Claude في OpenClaw فجأة، وكيفية استعادة سير عملك بأقل تكلفة ممكنة.

تحليل أسباب خطأ OpenClaw Claude

تفسير رسالة الخطأ

عندما تظهر لك رسالة الخطأ التالية في OpenClaw:

claw APP
LLM request rejected: You're out of extra usage.
Add more at claude.ai/settings/usage and keep going.

فإن معنى هذا الخطأ هو: لقد قامت Anthropic بإزالة صلاحية استخدام اشتراك Claude الخاص بك من الأدوات الخارجية مثل OpenClaw. ستحتاج إما إلى شراء رصيد إضافي (Extra Usage) أو الانتقال إلى طريقة ربط أخرى.

لماذا توقف Claude في OpenClaw فجأة عن العمل؟

نفذت Anthropic رسمياً حظر الأدوات الخارجية في 4 أبريل 2026 الساعة 12:00 مساءً بتوقيت المحيط الهادئ. إليك التغييرات الجوهرية:

• ❌ سابقاً: كان يمكن استخدام رصيد اشتراك Claude Pro (20 دولاراً/شهرياً) أو Max (200 دولار/شهرياً) داخل OpenClaw.
• ✅ حالياً: تقتصر رموز OAuth الخاصة بالاشتراك على المنتجات الرسمية مثل Claude.ai وClaude Code وClaude Desktop.
• ⚠️ الأدوات الخارجية: يجب على OpenClaw وNanoClaw وغيرها استخدام رصيد إضافي (Extra Usage) أو مفتاح API مستقل.

أوضح بوريس تشيرني، المسؤول عن Claude Code في Anthropic: "نموذج اشتراكنا لم يُصمم ليتناسب مع أنماط استخدام هذه الأدوات الخارجية. فقد تسببت هذه الأدوات في ضغط غير متناسب على أنظمتنا".

يعود السبب التقني إلى مراجحة الرموز (Token Arbitrage)؛ حيث كان بعض المستخدمين يستغلون اشتراك Max بقيمة 200 دولار شهرياً لتشغيل أحمال عمل تصل قيمتها في OpenClaw إلى 1,000 ~ 5,000 دولار، بالإضافة إلى أن الأدوات الخارجية لا يمكنها الاستفادة من ميزة التخزين المؤقت للموجهات (Prompt Cache) الخاصة بـ Anthropic، مما يؤدي إلى تكلفة حسابية كاملة مع كل استدعاء.

حل مشكلة خطأ OpenClaw Claude 1: شراء رصيد الاستخدام الإضافي (Extra Usage)

خطوات التنفيذ

هذه هي الطريقة الرسمية التي توجهك إليها Anthropic، وهي شراء رصيد استخدام إضافي (Extra Usage) بنظام الدفع حسب الاستخدام عبر موقع claude.ai.

الخطوة الأولى: افتح المتصفح وانتقل إلى claude.ai/settings/usage (وهو الرابط الموجود في رسالة الخطأ).

الخطوة الثانية: سجل الدخول إلى حساب Claude Pro/Max الخاص بك.

الخطوة الثالثة: قم بتفعيل خيار الدفع حسب الاستخدام في إعدادات الاستخدام الإضافي (Extra Usage).

الخطوة الرابعة: حدد حد التعبئة التلقائية (اختياري) أو قم بشراء رصيد لمرة واحدة.

معايير محاسبة الاستخدام الإضافي

يتم احتساب الاستخدام الإضافي وفقاً لأسعار API القياسية:

تقدير التكلفة

بناءً على معدل الاستخدام النموذجي لـ OpenClaw:

⚠️ تحذير بشأن التكلفة: إذا كنت من مستخدمي OpenClaw بكثافة عالية، فقد تتجاوز التكلفة الشهرية لخيار الاستخدام الإضافي اشتراك Max السابق البالغ $200. وهذا هو السبب الحقيقي وراء توقف Anthropic عن تغطية الأدوات الخارجية، حيث أن الاستهلاك الفعلي لبعض المستخدمين يتجاوز بكثير قيمة الاشتراك.

رصيد التعويض من Anthropic بقيمة $200

قدمت Anthropic رصيد تعويض لمرة واحدة للمستخدمين المتأثرين يعادل قيمة اشتراكهم الشهري:

• يحصل مستخدمو Pro على رصيد بقيمة $20.
• يحصل مستخدمو Max على رصيد بقيمة $200.
• يجب استخدام الرصيد قبل 17 أبريل 2026، وإلا سيفقد صلاحيته.
• يمكن استخدام الرصيد في Claude.ai، أو Claude Code، أو Claude Desktop، أو للاستخدام الإضافي في التطبيقات الخارجية.

حل مشكلة خطأ OpenClaw Claude 2: الانتقال إلى استخدام مفتاح API (موصى به)

لماذا نوصي بخيار مفتاح API؟

توصي وثائق OpenClaw الرسمية بوضوح: بالنسبة لبيئات الإنتاج أو سيناريوهات المستخدمين المتعددين، يعد توثيق الهوية عبر مفتاح Anthropic API هو الخيار الأكثر أماناً. مقارنة بخيار الاستخدام الإضافي، يتميز خيار مفتاح API بالمزايا التالية:

• لا يعتمد على حالة اشتراك Claude.
• التكاليف أكثر شفافية (يتم المحاسبة مباشرة حسب عدد الـ Token).
• لا يتأثر بتغييرات سياسة Anthropic المستقبلية.
• يدعم إدارة أكثر مرونة للرصيد.

طريقة إعداد مفتاح API في OpenClaw

الطريقة الأولى: الإعداد عبر متغيرات البيئة

# تعيين مفتاح Anthropic API
export ANTHROPIC_API_KEY="sk-ant-your-api-key-here"

# إضافته إلى ملف إعدادات shell لجعله دائماً
echo 'export ANTHROPIC_API_KEY="sk-ant-your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

الطريقة الثانية: الإعداد عبر خدمة وكيل API (موصى به)

# استخدام خدمة وكيل APIYI - مفتاح واحد للوصول إلى جميع النماذج
export OPENAI_API_KEY="your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

# ملف إعدادات OpenClaw
# الانتقال من وضع OAuth إلى وضع مفتاح API

providers:
  # الطريقة 1: استخدام مفتاح Anthropic API مباشرة
  anthropic:
    api_key: "sk-ant-your-key"
    models:
      - claude-sonnet-4
      - claude-haiku-4

  # الطريقة 2: الوصول الموحد عبر APIYI (موصى به)
  # مفتاح واحد للوصول إلى Claude و GPT و Gemini في آن واحد
  openai-compatible:
    api_key: "your-apiyi-key"
    base_url: "https://api.apiyi.com/v1"
    models:
      - claude-sonnet-4
      - claude-opus-4
      - gpt-4o
      - gemini-3.1-pro

default_provider: openai-compatible
default_model: claude-sonnet-4

🚀 انتقال سريع: يتطلب الانتقال من OAuth إلى مفتاح API ثلاث خطوات فقط: الحصول على مفتاح API ← تعيين متغيرات البيئة ← إعادة تشغيل OpenClaw. من خلال APIYI apiyi.com يمكنك الحصول على مفتاح API موحد، وبإعداد واحد يمكنك الوصول إلى جميع النماذج مثل Claude و GPT و Gemini دون الحاجة لإدارة حسابات API متعددة بشكل منفصل.

حلول أخطاء OpenClaw Claude (الجزء الثالث): استخدام خدمة وكيل API

المزايا الجوهرية لخدمة وكيل API

بالنسبة للمطورين الذين يستخدمون OpenClaw بشكل متكرر، توفر خدمة وكيل API المزايا الفريدة التالية:

كود الربط مع خدمة الوكيل

import openai

# ما عليك سوى تعديل base_url، وبقية الكود يبقى كما هو
client = openai.OpenAI(
    api_key="your-apiyi-key",
    base_url="https://api.apiyi.com/v1"
)

# استدعاء النموذج Claude المستخدم في OpenClaw
response = client.chat.completions.create(
    model="claude-sonnet-4",
    messages=[{"role": "user", "content": "ساعدني في تحليل هذا الكود"}]
)

🎯 نصيحة عملية: إذا كنت تستخدم Claude ونماذج أخرى في OpenClaw في آن واحد، فإن الواجهة الموحدة من APIYI (apiyi.com) مريحة للغاية؛ حيث لا تحتاج إلى إعداد مفتاح API و base_url بشكل منفصل لكل مزود، فإعداد واحد يغطي جميع النماذج.

حلول أخطاء OpenClaw Claude (الجزء الرابع): الانتقال إلى نماذج أخرى

اختيار النماذج البديلة

إذا كنت لا ترغب في دفع تكاليف إضافية لـ Claude، يمكنك التبديل إلى مزودي نماذج آخرين داخل OpenClaw:

مثال التبديل إلى OpenAI في OpenClaw

تؤكد OpenAI حالياً أن اشتراك ChatGPT لا يزال قابلاً للاستخدام في OpenClaw، وهو رد تنافسي من OpenAI على قيود Anthropic.

# التبديل إلى OpenAI في OpenClaw
export OPENAI_API_KEY="sk-your-openai-key"

# أو استخدام نموذج محلي (عبر Ollama)
# مجاني تماماً، لا يتطلب أي مفتاح API
ollama run llama4

استخدام النماذج المحلية في OpenClaw

بالنسبة للمستخدمين المهتمين بالميزانية، يعد تشغيل النماذج المحلية عبر Ollama بديلاً بتكلفة صفرية:

# تثبيت Ollama
curl -fsSL https://ollama.com/install.sh | sh

# تحميل النماذج
ollama pull llama4
ollama pull qwen3:14b

# سيكتشف OpenClaw نماذج Ollama المحلية تلقائياً

💡 استراتيجية هجينة: يعتمد العديد من المطورين استراتيجية هجينة تتمثل في "استخدام Claude/GPT للمهام الحرجة + النماذج المحلية للمهام اليومية". إن إدارة استدعاء النموذج السحابي عبر APIYI (apiyi.com) مع استخدام Ollama محلياً للمهام البسيطة هو التوازن الأمثل بين التكلفة والأداء.

إليك نظرة عامة شاملة على الحلول الأربعة للتعامل مع أخطاء Claude في OpenClaw:

قائمة التحقق من أخطاء OpenClaw

إذا واجهت أخطاء متعلقة بـ Claude في OpenClaw، يرجى اتباع خطوات التحقق التالية بالترتيب:

الخطوة الأولى: تحديد نوع الخطأ

• You're out of extra usage ← راجع الحلول في هذا المقال (الاشتراك لم يعد يغطي الاستخدام)
• invalid_api_key ← تأكد من صحة مفتاح API
• rate_limit_exceeded ← انتظر قليلاً أو انتقل إلى خدمة وكيل API
• model_not_found ← تحقق من كتابة اسم نموذج اللغة الكبير بشكل صحيح

الخطوة الثانية: فحص طريقة المصادقة الحالية

• إذا كنت تستخدم OAuth (تسجيل الدخول عبر اشتراك Claude) ← يجب عليك التبديل إلى مفتاح API أو شراء رصيد استخدام إضافي (Extra Usage)
• إذا كنت تستخدم مفتاح API ← تحقق من الرصيد والحدود المتاحة

الخطوة الثالثة: اختيار الحل المناسب

• للاستخدام المؤقت ← اشترِ رصيد استخدام إضافي
• للاستخدام طويل الأمد ← انتقل إلى استخدام مفتاح API مع خدمة وكيل API
• لتقليل التكاليف ← انتقل إلى نماذج أخرى أو نماذج محلية

الأسئلة الشائعة

ملخص

نقاط الحل لخطأ OpenClaw الذي يظهر كـ LLM request rejected: You're out of extra usage:

1. السبب الجذري: حظرت Anthropic اعتباراً من 4 أبريل 2026 استخدام رموز OAuth الخاصة بالاشتراكات في الأدوات الخارجية.
2. حل مؤقت: شراء رصيد "استخدام إضافي" (Extra Usage) من خلال الرابط claude.ai/settings/usage.
3. الحل الموصى به: الانتقال إلى وضع الاتصال عبر مفتاح API، حيث لا يعتمد ذلك على حالة الاشتراك.
4. الحل الأمثل: استخدام خدمة وكيل API، حيث يتيح لك مفتاح واحد الوصول إلى جميع النماذج دون مشاكل في تحديد السرعة.
5. رصيد التعويض: لا تنسَ المطالبة برصيد التعويض المعادل لرسوم الاشتراك الشهرية (صالح حتى 17 أبريل).

بالنسبة للمطورين الذين يستخدمون OpenClaw على المدى الطويل، نوصي بالاتصال عبر APIYI (apiyi.com). ما عليك سوى تعديل base_url لإدارة استدعاء النماذج الرئيسية مثل Claude وGPT وGemini بشكل موحد باستخدام مفتاح API واحد، مما يغنيك عن عناء إدارة حسابات ومنصات متعددة.

📚 مراجع

1. وثائق OpenClaw الرسمية: شرح طرق مصادقة البوابة

   • الرابط: docs.openclaw.ai/gateway/authentication
   • الوصف: الطريقة الرسمية الموصى بها لإعداد مفتاح API.

2. الأسئلة الشائعة لـ OpenClaw: استكشاف الأخطاء وإصلاحها

   • الرابط: docs.openclaw.ai/help/faq
   • الوصف: يتضمن الإجابة الرسمية على خطأ رفض طلب نموذج اللغة (LLM request rejected).

3. إدارة الاستخدام الإضافي لـ Anthropic: إعدادات الدفع حسب الاستخدام لـ Claude

   • الرابط: support.claude.com/en/articles/12429409-manage-extra-usage-for-paid-claude-plans
   • الوصف: كيفية تفعيل وإدارة الاستخدام الإضافي.

4. تقرير VentureBeat: قيام Anthropic بقطع دعم اشتراكات Claude عن OpenClaw

   • الرابط: venturebeat.com/technology/anthropic-cuts-off-the-ability-to-use-claude-subscriptions-with-openclaw-and
   • الوصف: تقرير مفصل وتحليل لخلفية تغيير السياسة.

5. صفحة تسعير Claude API: أسعار الرموز (Tokens) لكل نموذج

   • الرابط: platform.claude.com/docs/en/about-claude/pricing
   • الوصف: أحدث أسعار نماذج Claude عبر API.

الكاتب: فريق APIYI التقني
تبادل تقني: إذا واجهت مشاكل في إعداد OpenClaw، نرحب بمناقشتها في قسم التعليقات. لمزيد من مواد تطوير الذكاء الاصطناعي، يمكنك زيارة مركز وثائق APIYI على docs.apiyi.com.