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

ما الذي يفعله

• توجيه مضمن في أي نص وارد: /t <level> أو /think:<level> أو /thinking <level>.
• المستويات (الأسماء البديلة): off | minimal | low | medium | high | xhigh | adaptive | max
  • minimal ← "فكّر"
  • low ← "فكّر بعمق"
  • medium ← "فكّر بعمق أكبر"
  • high ← "ultrathink" (أقصى ميزانية)
  • xhigh ← "ultrathink+" (نماذج 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 أصلي لديه)
  • يتم ربط x-high وx_high وextra-high وextra high وextra_high بـ xhigh.
  • يتم ربط highest بـ high.
• ملاحظات المزوّد:
  • قوائم التفكير وأدوات الاختيار مدفوعة بملف تعريف المزوّد. تعلن Plugins المزوّد مجموعة المستويات الدقيقة للنموذج المحدد، بما في ذلك تسميات مثل on الثنائية.
  • لا يُعلَن عن adaptive وxhigh وmax إلا لملفات تعريف المزوّد/النموذج التي تدعمها. تُرفض التوجيهات المكتوبة للمستويات غير المدعومة مع خيارات ذلك النموذج الصالحة.
  • تُعاد خريطة المستويات غير المدعومة المخزنة حسب رتبة ملف تعريف المزوّد. يتراجع 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؛ ويرتبط كلاهما بـ DeepSeek reasoning_effort: "max"، بينما ترتبط المستويات الأدنى غير 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 حمولة الاستدلال المعطلة بدل إرسال قيمة غير مدعومة.
  • يمكن لإدخالات الكتالوج المخصصة المتوافقة مع 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 من تنسيق بث M2.x غير الأصلي لـ Anthropic. يُستثنى MiniMax-M3 (وM3.x): يصدر M3 كتل تفكير Anthropic صحيحة ويعيد محتوى فارغًا عند تعطيل التفكير، لذلك يبقي OpenClaw M3 على مسار التفكير المحذوف/التكيّفي للمزوّد.
  • Z.AI (zai/*) ثنائي (on/off) لمعظم نماذج GLM. الاستثناء هو GLM-5.2: يعرض /think off|low|high|max، ويربط low وhigh بـ Z.AI reasoning_effort: "high"، ويربط 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 level set to high. / Thinking disabled.). إذا كان المستوى غير صالح (مثل /thinking big)، يُرفض الأمر مع تلميح وتبقى حالة الجلسة دون تغيير.
• أرسل /think (أو /think:) دون وسيطة لرؤية مستوى التفكير الحالي.

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

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

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

• المستويات: auto|on|off|default.
• تبدّل الرسالة التي تحتوي على التوجيه فقط تجاوز وضع الجلسة السريع وترد بـ Fast mode set to auto. أو Fast mode enabled. أو Fast mode disabled.. استخدم /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 وضع الجلسة/الإعدادات كـ auto لكنه يحسم كل استدعاء نموذج جديد بشكل مستقل. الاستدعاءات التي تبدأ قبل حد 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.
• تتجاوز معلمات نموذج Anthropic الصريحة serviceTier / service_tier القيمة الافتراضية للوضع السريع عند تعيين كليهما. لا يزال OpenClaw يتخطى حقن فئة خدمة Anthropic لعناوين URL الأساسية للوكيل غير Anthropic.
• يعرض /status القيمة Fast عندما يكون الوضع السريع مفعّلًا وFast:auto عندما يكون الوضع المكوّن auto.

توجيهات التفصيل (/verbose أو /v)

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

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

• المستويات: on | off (افتراضي).
• تبدّل الرسالة التي تحتوي على التوجيه فقط إخراج تتبع Plugin للجلسة وترد بـ Plugin trace enabled. / Plugin trace disabled..
• يؤثر التوجيه المضمن على تلك الرسالة فقط؛ وإلا تنطبق القيم الافتراضية للجلسة/العامة.
• أرسل /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 وسم الفتح المشوّه ويسلّم النص المتبقي.

ذات صلة

• توجد مستندات الوضع المرتفع في الوضع المرتفع.

Heartbeats

• جسم مسبار 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 كالمعتاد (لكن تجنّب تغيير إعدادات الجلسة الافتراضية من Heartbeats).
• يكون تسليم 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 كقائمة تسميات قديمة. لا تحتفظ واجهة مستخدم المتصفح بقائمة regex خاصة بها للمزوّدين؛ إذ تملك 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) وقد يتضمن label للعرض. يستخدم المزوّدون الثنائيون { id: "low", label: "on" }.
• تتلقى خطافات ملف التعريف حقائق الكتالوج المدمجة عند توفرها، بما في ذلك reasoning وcompat.thinkingFormat وcompat.supportedReasoningEfforts. استخدم هذه الحقائق لكشف ملفات تعريف ثنائية أو مخصصة فقط عندما يدعم عقد الطلب المضبوط الحمولة المطابقة.
• يجب على Plugins الأدوات التي تحتاج إلى التحقق من تجاوز تفكير صريح استخدام api.runtime.agent.resolveThinkingPolicy({ provider, model }) مع api.runtime.agent.normalizeThinkingLevel(...)؛ ويجب ألا تحتفظ بقوائم مستويات خاصة بها للمزوّد/النموذج.
• يمكن لـ Plugins الأدوات التي لديها وصول إلى بيانات تعريف النماذج المخصصة المضبوطة تمرير catalog إلى resolveThinkingPolicy حتى تنعكس الاشتراكات الاختيارية في compat.supportedReasoningEfforts في التحقق من جانب Plugin.
• تبقى الخطافات القديمة المنشورة (supportsXHighThinking وisBinaryThinking وresolveDefaultThinkingLevel) كمحوّلات توافق، لكن يجب أن تستخدم مجموعات المستويات المخصصة الجديدة resolveThinkingProfile.
• تكشف صفوف/افتراضيات Gateway عن thinkingLevels وthinkingOptions وthinkingDefault حتى تعرض عملاء ACP/الدردشة معرفات وتسميات ملفات التعريف نفسها التي يستخدمها التحقق في وقت التشغيل.