OpenClaw استكشاف نافذة السياق وتقييد المعدل

حدّد نوع الخطأ أولًا

موضع Model Window في صفحة الإعدادات OpenClaw. تختلف أسماء الحقول باختلاف…

ماذا يمثّل كل حقل من الحقول الثلاثة

• contextWindow: بيانات وصف نافذة السياق الأصلية للنموذج.
• contextTokens: الحد OpenClaw المسموح به فعليًا للإدخال، وقد يكون أقل من النافذة الأصلية.
• maxTokens: الحد الأقصى لرموز الإخراج للاستجابة الواحدة، وليس حجم السياق الكلي.

لا تكتب 1M عشوائيًا لمجرد «الحصول على سياق أكبر». يجب أن تتوافق القيم المكتوبة في الوقت نفسه مع قدرات النموذج وحدود التوجيه الحالية لدى LLM API Gateway وإصدار العميل.

مواضع الإعداد

عادةً ما يقع الإعداد الرئيسي في:

~/.openclaw/openclaw.json

وعند الإعداد لكل Agent على حدة، يكون عادةً في:

~/.openclaw/agents/<agentId>/agent/models.json

إذا كان OPENCLAW_AGENT_DIR مضبوطًا، فابحث عن الإعداد المقابل للـ Agent في ذلك الدليل.

مثال تعديل آمن

القيم أدناه توضّح العلاقة بين الحقول فقط، ولا تمثل الحدود الحقيقية لكل النماذج. تحقّق أولًا من القيم في قائمة نماذج هذا الموقع وشرح التوجيه الحالي:

{
  models: {
    mode: "merge",
    providers: {
      guishu: {
        baseUrl: "https://api.llm-token.cn/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "YOUR_MODEL_ID",
            contextWindow: 128000,
            contextTokens: 96000,
            maxTokens: 8192,
            input: ["text"]
          }
        ]
      }
    }
  }
}

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

ترتيب التعديل والتحقق

1. انسخ ملف الإعداد الحالي احتياطيًا، ولا تكتب فوق النسخة الوحيدة مباشرة.
2. عدّل فقط إدخال provider والنموذج الحاليين، واحتفظ ببقية الإعداد.
3. شغّل openclaw models list وتأكد من التعرف على النموذج.
4. شغّل openclaw models set guishu/YOUR_MODEL_ID وتأكد من أن provider/model المحدد صحيح.
5. أعد تشغيل البوابة: openclaw gateway restart.
6. أرسل أولًا طلب اختبار قصيرًا جدًا، ثم زد سياق التدريجيًا.

إذا كان الطلب القصير يعيد 429 أيضًا، فلن يفيد تكبير نافذة السياق؛ فانتقل إلى فحص التزامن وحصة الحساب وحالة الطرف العلوي. أما إذا فشلت الطلبات الطويلة فقط، فافحص طول الإدخال واستراتيجية الضغط وحقول السياق الثلاثة.