مستويات التفكير

ما الذي يفعله

• توجيه مضمّن في أي محتوى وارد: /t <level> أو /think:<level> أو /thinking <level>.
• المستويات (والأسماء البديلة): off | minimal | low | medium | high | xhigh | adaptive | max | ultra، وهي تحاكي تقريبًا تسلسل الكلمات السحرية الكلاسيكي لدى Anthropic: "فكّر" < "فكّر بجدية" < "فكّر بجدية أكبر" < "فكّر بأقصى عمق":
  • minimal ~ "فكّر"
  • low ~ "فكّر بجدية"
  • medium ~ "فكّر بجدية أكبر"
  • high ~ "فكّر بأقصى عمق" (الميزانية القصوى)
  • xhigh ~ "فكّر بأقصى عمق+" (نماذج GPT-5.2+ وCodex، بالإضافة إلى جهد Anthropic Claude Opus 4.7+)
  • adaptive ← تفكير تكيّفي يديره المزوّد (مدعوم في Claude 4.6 على Anthropic/Bedrock، وAnthropic Claude Opus 4.7+، والتفكير الديناميكي في Google Gemini)
  • max ← أقصى استدلال لدى المزوّد (Anthropic Claude Opus 4.7+؛ يربط Ollama هذا بأعلى جهد think أصلي لديه)
  • ultra ← أقصى استدلال لدى المزوّد، بالإضافة إلى تنسيق استباقي للوكلاء الفرعيين عندما يدعمه النموذج أو وقت التشغيل المحدد
  • تُربط x-high وx_high وextra-high وextra high وextra_high بـ xhigh.
  • تُربط highest بـ high.
• ملاحظات المزوّد:
  • تُحدَّد قوائم التفكير وأدوات اختياره بواسطة ملف تعريف المزوّد. وتعلن Plugins المزوّد عن مجموعة المستويات الدقيقة للنموذج المحدد، بما في ذلك تسميات مثل الخيار الثنائي on.
  • لا يُعلن عن adaptive وxhigh وmax وultra إلا لملفات تعريف المزوّد/النموذج/وقت التشغيل التي تدعمها. وتُرفض التوجيهات المكتوبة لمستويات غير مدعومة مع عرض الخيارات الصالحة لذلك النموذج.
  • يُعاد ربط المستويات المخزنة غير المدعومة وفق ترتيب ملف تعريف المزوّد. يعود adaptive إلى medium في النماذج غير التكيّفية، بينما يعود xhigh وmax إلى أكبر مستوى مدعوم غير off للنموذج المحدد.
  • تستخدم نماذج Anthropic Claude 4.6 المستوى adaptive افتراضيًا عند عدم تعيين مستوى تفكير صريح.
  • تُبقي نماذج Anthropic Claude Opus 4.8 وOpus 4.7 التفكير متوقفًا ما لم تعيّن مستوى تفكير صراحةً. ويكون الجهد الافتراضي المملوك للمزوّد في Opus 4.8 هو high بعد تمكين التفكير التكيّفي.
  • تربط نماذج Anthropic Claude Opus 4.7+ الأمر /think xhigh بالتفكير التكيّفي مع output_config.effort: "xhigh"، لأن /think توجيه للتفكير وxhigh هو إعداد الجهد في Opus.
  • تعرض نماذج Anthropic Claude Opus 4.7+ أيضًا /think max؛ ويُربط بمسار أقصى جهد نفسه الذي يملكه المزوّد.
  • تعرض نماذج DeepSeek V4 المباشرة /think xhigh|max؛ ويُربط كلاهما بـ reasoning_effort: "max" في DeepSeek، بينما تُربط المستويات الأدنى غير off بـ high.
  • تعرض نماذج DeepSeek V4 الموجّهة عبر OpenRouter الأمر /think xhigh، وترسل قيم reasoning.effort المدعومة في OpenRouter بدلًا من reasoning_effort الأصلي ذي المستوى الأعلى في DeepSeek. تُربط المستويات الأدنى غير off بـ high، وتعود تجاوزات max المخزنة إلى xhigh.
  • تعرض نماذج Ollama القادرة على التفكير /think low|medium|high|max؛ ويُربط max بالقيمة الأصلية think: "high" لأن واجهة API الأصلية في Ollama تقبل سلاسل الجهد low وmedium وhigh.
  • تربط نماذج OpenAI GPT الأمر /think عبر دعم الجهد الخاص بكل نموذج في Responses API. لا يرسل /think off القيمة reasoning.effort: "none" إلا عندما يدعمها النموذج المستهدف؛ وإلا يحذف OpenClaw حمولة الاستدلال المعطلة بدلًا من إرسال قيمة غير مدعومة.
  • تعرض GPT-5.6 Sol وTerra الأمر الأصلي /think ultra عبر وقت تشغيل Codex. وتعرض GPT-5.6 Luna المستويات حتى max لأن كتالوج Codex الخاص بها لا يعلن عن Ultra.
  • يعرض وقت تشغيل OpenClaw المضمّن المستوى المنطقي /think ultra لنماذج GPT-5.6 Sol وTerra وLuna. ويرسل أقصى جهد لدى المزوّد ويضيف إرشادات لتنسيق استباقي للوكلاء الفرعيين ضمن نطاق التشغيل.
  • يمكن لإدخالات الكتالوج المخصصة المتوافقة مع OpenAI الاشتراك في /think xhigh عبر ضبط models.providers.<provider>.models[].compat.supportedReasoningEfforts ليتضمن "xhigh". ويستخدم ذلك بيانات التوافق الوصفية نفسها التي تربط حمولات جهد الاستدلال الصادرة في OpenAI، بحيث تتفق القوائم والتحقق من الجلسة وCLI الوكيل وllm-task مع سلوك النقل.
  • تتجاوز مراجع OpenRouter Hunter Alpha القديمة المكوّنة حقن الاستدلال عبر الوكيل، لأن ذلك المسار المتقاعد كان قد يعيد نص الإجابة النهائية عبر حقول الاستدلال.
  • يربط Google Gemini الأمر /think adaptive بالتفكير الديناميكي المملوك للمزوّد في Gemini. تحذف طلبات Gemini 3 قيمة thinkingLevel الثابتة، بينما ترسل طلبات Gemini 2.5 القيمة thinkingBudget: -1؛ وتظل المستويات الثابتة مرتبطة بأقرب thinkingLevel أو ميزانية في Gemini لعائلة النموذج تلك.
  • يستخدم MiniMax M2.x ‏(minimax/MiniMax-M2*) في مسار البث المتوافق مع Anthropic القيمة الافتراضية thinking: { type: "disabled" } ما لم تعيّن التفكير صراحةً في معاملات النموذج أو الطلب. يمنع ذلك تسرّب فروق reasoning_content من تنسيق بث Anthropic غير الأصلي في M2.x. ويُستثنى MiniMax-M3 ‏(وM3.x): إذ يصدر M3 كتل تفكير Anthropic سليمة ويعيد محتوى فارغًا عند تعطيل التفكير، ولذلك يُبقي OpenClaw نموذج M3 على مسار التفكير المحذوف/التكيّفي لدى المزوّد.
  • يكون Z.AI ‏(zai/*) ثنائيًا (on/off) لمعظم نماذج GLM. ويُستثنى GLM-5.2؛ إذ يعرض /think off|low|high|max، ويربط low وhigh بالقيمة reasoning_effort: "high" في Z.AI، ويربط max بالقيمة reasoning_effort: "max".
  • يفكّر Moonshot Kimi K2.7 Code ‏(moonshot/kimi-k2.7-code) دائمًا. ولا يعرض ملف تعريفه سوى on، ويحذف OpenClaw حقل thinking الصادر وفق متطلبات Moonshot. تربط نماذج moonshot/* الأخرى /think off بالقيمة thinking: { type: "disabled" }، وأي مستوى غير off بالقيمة thinking: { type: "enabled" }. وعند تمكين التفكير، لا يقبل Moonshot في tool_choice سوى auto|none؛ ويطبّع OpenClaw القيم غير المتوافقة إلى auto.

ترتيب الحسم

1. التوجيه المضمّن في الرسالة (ينطبق على تلك الرسالة فقط).
2. تجاوز الجلسة (يُعيّن بإرسال رسالة لا تحتوي إلا على التوجيه).
3. الإعداد الافتراضي لكل وكيل (agents.list[].thinkingDefault في الإعدادات).
4. الإعداد الافتراضي العام (agents.defaults.thinkingDefault في الإعدادات).
5. الرجوع الاحتياطي: الإعداد الافتراضي المعلن من المزوّد عند توفره؛ وإلا تُحسم النماذج القادرة على الاستدلال إلى medium أو أقرب مستوى مدعوم غير off لذلك النموذج، وتظل النماذج غير القادرة على الاستدلال على off.

تعيين إعداد افتراضي للجلسة

• أرسل رسالة تحتوي على التوجيه فقط (يُسمح بالمسافات البيضاء)، مثل /think:medium أو /t high.
• يستمر هذا الإعداد طوال الجلسة الحالية (لكل مرسل افتراضيًا). استخدم /think default لمسح تجاوز الجلسة ووراثة الإعداد الافتراضي المكوّن/الخاص بالمزوّد؛ وتشمل الأسماء البديلة inherit وclear وreset وunpin.
• يخزّن /think off تجاوزًا صريحًا لإيقاف التفكير. ويعطّل التفكير حتى تغيّر تجاوز الجلسة أو تمسحه.
• يُرسل رد تأكيد (تم تعيين مستوى التفكير إلى مرتفع. / تم تعطيل التفكير.). إذا كان المستوى غير صالح (مثل /thinking big)، يُرفض الأمر مع تلميح وتظل حالة الجلسة دون تغيير.
• أرسل /think (أو /think:) من دون وسيطة لعرض مستوى التفكير الحالي.

التطبيق حسب الوكيل

• OpenClaw المضمّن: يُمرَّر المستوى المحسوم إلى وقت تشغيل وكيل OpenClaw داخل العملية.
• واجهة Claude CLI الخلفية: تُمرَّر المستويات المحددة غير المتوقفة إلى Claude Code بصيغة --effort عند استخدام claude-cli؛ بينما يزيل adaptive علامات الجهد المكوّنة ويفوّض الجهد الفعلي إلى بيئة Claude Code وإعداداته والإعدادات الافتراضية للنموذج. راجع واجهات CLI الخلفية.

الوضع السريع (/fast)

• المستويات: auto|on|off|default.
• تبدّل الرسالة التي لا تحتوي إلا على التوجيه تجاوز الوضع السريع للجلسة وترد بـ تم تعيين الوضع السريع إلى تلقائي. أو تم تمكين الوضع السريع. أو تم تعطيل الوضع السريع.. استخدم /fast default لمسح تجاوز الجلسة ووراثة الإعداد الافتراضي المكوّن؛ وتشمل الأسماء البديلة inherit وclear وreset وunpin.
• أرسل /fast (أو /fast status) من دون وضع لعرض حالة الوضع السريع الفعالة الحالية.
• يحسم OpenClaw الوضع السريع بالترتيب الآتي:
  1. تجاوز /fast auto|on|off المضمّن/المقتصر على التوجيه (/fast default يمسح هذه الطبقة)
  2. تجاوز الجلسة
  3. الإعداد الافتراضي لكل وكيل (agents.list[].fastModeDefault)
  4. إعداد كل نموذج: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. الرجوع الاحتياطي: off
• يُبقي auto وضع الجلسة/الإعدادات على الوضع التلقائي، لكنه يحسم كل استدعاء جديد للنموذج بصورة مستقلة. تُفعّل الاستدعاءات التي تبدأ قبل الحد الفاصل التلقائي الوضع السريع؛ بينما تبدأ استدعاءات إعادة المحاولة أو الرجوع الاحتياطي أو نتيجة الأداة أو المتابعة اللاحقة مع تعطيل الوضع السريع. الحد الفاصل الافتراضي هو 60 ثانية؛ اضبط agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds في النموذج النشط لتغييره.
• بالنسبة إلى openai/*، يُربط الوضع السريع بالمعالجة ذات الأولوية في OpenAI عبر إرسال service_tier=priority في طلبات Responses المدعومة.
• بالنسبة إلى نماذج openai/* / openai-codex/* المدعومة بـ Codex، يرسل الوضع السريع علامة service_tier=priority نفسها في Codex Responses. ولا تتلقى دورات خادم تطبيق Codex الأصلية المستوى إلا عند turn/start أو بدء/استئناف سلسلة المحادثة، لذلك لا يستطيع auto تغيير مستوى دورة خادم تطبيق قيد التشغيل بالفعل؛ بل يُطبّق على دورة النموذج التالية التي يبدأها OpenClaw.
• بالنسبة إلى طلبات anthropic/* العامة المباشرة، بما فيها حركة البيانات المصادق عليها عبر OAuth والمرسلة إلى api.anthropic.com، يُربط الوضع السريع بمستويات خدمة Anthropic: يعيّن /fast on القيمة service_tier=auto، ويعيّن /fast off القيمة service_tier=standard_only.
• بالنسبة إلى minimax/* في المسار المتوافق مع Anthropic، يعيد /fast on (أو params.fastMode: true) كتابة MiniMax-M2.7 إلى MiniMax-M2.7-highspeed.
• تتجاوز معاملات النموذج الصريحة serviceTier / service_tier في Anthropic الإعداد الافتراضي للوضع السريع عند تعيين كليهما. ويظل OpenClaw يتجاوز حقن مستوى خدمة Anthropic لعناوين URL الأساسية للوكلاء غير التابعين لـ Anthropic.
• يعرض /status القيمة سريع عند تمكين الوضع السريع، والقيمة سريع:تلقائي عندما يكون الوضع المكوّن تلقائيًا.

توجيهات الإسهاب (/verbose أو /v)

• المستويات: on (الحد الأدنى) | full | off (الافتراضي).
• تبدّل الرسالة التي لا تحتوي إلا على التوجيه إسهاب الجلسة وترد بـ تم تمكين التسجيل المسهب. / تم تعطيل التسجيل المسهب.؛ وتعيد المستويات غير الصالحة تلميحًا من دون تغيير الحالة.
• يخزّن /verbose off تجاوزًا صريحًا للجلسة؛ امسحه عبر واجهة مستخدم الجلسات باختيار inherit.
• يجوز لمرسلي القنوات الخارجية المخوّلين حفظ تجاوز إسهاب الجلسة. وتحتاج عملاء Gateway/دردشة الويب الداخلية إلى operator.admin لحفظه.
• يؤثر التوجيه المضمّن في تلك الرسالة فقط؛ وتُطبّق الإعدادات الافتراضية للجلسة/العامة فيما عدا ذلك.
• أرسل /verbose (أو /verbose:) من دون وسيطة لعرض مستوى الإسهاب الحالي.
• عند تشغيل الإسهاب، ترسل الوكلاء التي تصدر نتائج أدوات منظّمة كل استدعاء أداة في رسالة مستقلة تحتوي على بيانات وصفية فقط، مسبوقةً بـ <emoji> <tool-name>: <arg> عند توفرها. وتُرسل ملخصات الأدوات هذه فور بدء كل أداة (في فقاعات منفصلة)، وليس كفروق متدفقة.
• تظل ملخصات فشل الأدوات ظاهرة في الوضع العادي، لكن لواحق تفاصيل الخطأ الخام تكون مخفية ما لم يكن الإسهاب full.
• عندما يكون الإسهاب full، تُمرّر مخرجات الأدوات أيضًا بعد الاكتمال (في فقاعة منفصلة، ومقتطعة إلى طول آمن). إذا بدّلت /verbose on|full|off أثناء تنفيذ عملية، فستلتزم فقاعات الأدوات اللاحقة بالإعداد الجديد.
• يتحكم agents.defaults.toolProgressDetail في شكل ملخصات أدوات /verbose وأسطر أدوات مسودة التقدم. استخدم "explain" (الافتراضي) لتسميات بشرية موجزة مثل 🛠️ تنفيذ: التحقق من صياغة JS؛ واستخدم "raw" عندما تريد أيضًا إلحاق الأمر/التفاصيل الخام لأغراض تصحيح الأخطاء. يتجاوز agents.list[].toolProgressDetail الخاص بكل وكيل الإعداد الافتراضي.
  • explain: 🛠️ تنفيذ: التحقق من صياغة JS للملف /tmp/app.js
  • raw: 🛠️ تنفيذ: التحقق من صياغة JS للملف /tmp/app.js, node --check /tmp/app.js

توجيهات تتبّع Plugin ‏(/trace)

• المستويات: on | off (الافتراضي).
• تبدّل الرسالة التي لا تحتوي إلا على التوجيه مخرجات تتبّع Plugin للجلسة وترد بـ تم تمكين تتبّع Plugin. / تم تعطيل تتبّع Plugin..
• يؤثر التوجيه المضمّن في تلك الرسالة فقط؛ وتُطبّق الإعدادات الافتراضية للجلسة/العامة فيما عدا ذلك.
• أرسل /trace (أو /trace:) من دون وسيطة لعرض مستوى التتبّع الحالي.
• نطاق /trace أضيق من /verbose: فهو لا يعرض إلا أسطر التتبّع/تصحيح الأخطاء المملوكة لـ Plugin، مثل ملخصات تصحيح أخطاء Active Memory.
• قد تظهر أسطر التتبّع في /status وفي رسالة تشخيصية لاحقة بعد رد المساعد العادي.

إظهار الاستدلال (/reasoning)

• المستويات: on|off|stream.
• تحدد الرسالة التي تحتوي على توجيه فقط ما إذا كانت كتل التفكير ستظهر في الردود.
• عند التفعيل، يُرسل الاستدلال في رسالة منفصلة تسبقها البادئة Thinking.
• stream: يبث الاستدلال أثناء إنشاء الرد عندما تدعم القناة النشطة معاينات الاستدلال، ثم يرسل الإجابة النهائية دون الاستدلال.
• الاسم البديل: /reason.
• أرسل /reasoning (أو /reasoning:) دون وسيطة لعرض مستوى الاستدلال الحالي.
• ترتيب الحسم: التوجيه المضمّن، ثم تجاوز الجلسة، ثم الإعداد الافتراضي لكل وكيل (agents.list[].reasoningDefault)، ثم الإعداد الافتراضي العام (agents.defaults.reasoningDefault)، ثم القيمة الاحتياطية (off).

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

ذو صلة

• تتوفر وثائق الوضع ذي الصلاحيات المرتفعة في الوضع ذو الصلاحيات المرتفعة.

Heartbeat

• نص فحص Heartbeat هو موجّه Heartbeat المضبوط (الافتراضي: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.). تُطبّق التوجيهات المضمّنة في رسالة Heartbeat كالمعتاد (لكن تجنّب تغيير الإعدادات الافتراضية للجلسة من رسائل Heartbeat).
• يقتصر تسليم Heartbeat افتراضيًا على الحمولة النهائية. لإرسال رسالة Thinking المنفصلة أيضًا (عند توفرها)، اضبط agents.defaults.heartbeat.includeReasoning: true أو agents.list[].heartbeat.includeReasoning: true لكل وكيل.

واجهة محادثة الويب

• يعكس محدد التفكير في محادثة الويب المستوى المخزّن للجلسة من مخزن/إعدادات الجلسة الواردة عند تحميل الصفحة.
• يؤدي اختيار مستوى آخر إلى كتابة تجاوز الجلسة فورًا عبر sessions.patch؛ ولا ينتظر الإرسال التالي، كما أنه ليس تجاوز thinkingOnce لمرة واحدة.
• عند الإرسال بينما لا تزال تغييرات محدد النموذج أو الاستدلال أو السرعة قيد التطبيق، يُنتظر اكتمال كل تصحيح معلّق للمحدد؛ وإذا فشل تغيير، تظل الرسالة غير مرسلة للمراجعة.
• يكون الخيار الأول دائمًا خيار مسح التجاوز. ويعرض Inherited: <resolved level>، بما في ذلك Inherited: Off عندما يكون التفكير الموروث معطّلًا.
• تستخدم الاختيارات الصريحة للمحدد تسميات مستوياتها المباشرة مع الحفاظ على تسميات المزوّد عند وجودها (مثل Maximum لخيار max ذي تسمية من المزوّد).
• يستخدم المحدد thinkingLevels الذي يعيده صف الجلسة/الإعدادات الافتراضية في Gateway، مع الاحتفاظ بـ thinkingOptions كقائمة تسميات قديمة. لا تحتفظ واجهة المتصفح بقائمة التعابير النمطية الخاصة بها للمزوّدين؛ إذ تملك Plugins مجموعات المستويات الخاصة بكل نموذج.
• يظل /think:<level> يعمل ويحدّث مستوى الجلسة المخزّن نفسه، وبذلك تظل توجيهات المحادثة والمحدد متزامنة.

ملفات تعريف المزوّدين

• يمكن لـ Plugins المزوّدين كشف resolveThinkingProfile(ctx) لتحديد المستويات التي يدعمها النموذج والمستوى الافتراضي.
• ينبغي لـ Plugins المزوّدين التي تعمل كوسيط لنماذج Claude إعادة استخدام resolveClaudeThinkingProfile(modelId) من openclaw/plugin-sdk/provider-model-shared كي تظل كتالوجات Anthropic المباشرة والوسيطة متوافقة.
• لكل مستوى في ملف التعريف id أساسي مخزّن (off أو minimal أو low أو medium أو high أو xhigh أو adaptive أو max أو ultra)، وقد يتضمن label للعرض. تستخدم المزوّدات الثنائية { id: "low", label: "on" }.
• تتلقى خطافات ملف التعريف حقائق الكتالوج المدمجة عند توفرها، بما في ذلك reasoning وcompat.thinkingFormat وcompat.supportedReasoningEfforts. استخدم هذه الحقائق لكشف ملفات تعريف ثنائية أو مخصصة فقط عندما يدعم عقد الطلب المضبوط الحمولة المطابقة.
• ينبغي لـ Plugins الأدوات التي تحتاج إلى التحقق من تجاوز صريح للتفكير استخدام api.runtime.agent.resolveThinkingPolicy({ provider, model, agentRuntime }) مع api.runtime.agent.normalizeThinkingLevel(...)؛ وينبغي ألا تحتفظ بقوائم مستويات خاصة بها للمزوّدين/النماذج. مرّر agentRuntime عندما تملك الأداة مسار التنفيذ، مثل تشغيل مضمّن دائمًا.
• يمكن لـ Plugins الأدوات التي تصل إلى بيانات النماذج المخصصة الوصفية المضبوطة تمرير catalog إلى resolveThinkingPolicy كي تنعكس خيارات الاشتراك في compat.supportedReasoningEfforts ضمن التحقق من جهة Plugin.
• تظل الخطافات القديمة المنشورة (supportsXHighThinking وisBinaryThinking وresolveDefaultThinkingLevel) محولات توافق، لكن ينبغي لمجموعات المستويات المخصصة الجديدة استخدام resolveThinkingProfile.
• تكشف صفوف Gateway/إعداداته الافتراضية thinkingLevels وthinkingOptions وthinkingDefault كي تعرض عملاء ACP/المحادثة معرّفات ملفات التعريف وتسمياتها نفسها التي يستخدمها التحقق في وقت التشغيل.