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

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.

​
ما الذي يفعله

  • توجيه مضمن في أي نص وارد: /t <level>، أو /think:<level>، أو /thinking <level>.
  • المستويات (الأسماء البديلة): off | minimal | low | medium | high | xhigh | adaptive | max
    • minimal → “think”
    • low → “think hard”
    • medium → “think harder”
    • 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.7 التفكير التكيّفي افتراضياً. تبقى قيمة جهد API الافتراضية مملوكة للمزوّد ما لم تضبط مستوى تفكير صراحةً.
    • يعيّن Anthropic Claude Opus 4.7 الأمر /think xhigh إلى التفكير التكيّفي مع output_config.effort: "xhigh"، لأن /think توجيه تفكير وxhigh هو إعداد الجهد في Opus 4.7.
    • يوفّر 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. تتراجع تجاوزات 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 (minimax/*) على مسار البث المتوافق مع Anthropic القيمة الافتراضية thinking: { type: "disabled" } ما لم تضبط التفكير صراحةً في معاملات النموذج أو معاملات الطلب. يتجنب هذا تسريب دلتا reasoning_content من تنسيق بث Anthropic غير الأصلي لدى MiniMax.
    • يدعم Z.AI (zai/*) التفكير الثنائي فقط (on/off). يُعامَل أي مستوى غير off على أنه on (ويُعيَّن إلى low).
    • يعيّن 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:) بلا وسيطة لرؤية مستوى التفكير الحالي.

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

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

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

  • المستويات: on|off|default.
  • تبدّل الرسالة التي تحتوي على التوجيه فقط تجاوز الوضع السريع للجلسة وترد بـ Fast mode enabled. / Fast mode disabled.. استخدم /fast default لمسح تجاوز الجلسة ووراثة الإعداد الافتراضي المكوَّن؛ تشمل الأسماء البديلة inherit وclear وreset وunpin.
  • أرسل /fast (أو /fast status) بلا وضع لرؤية حالة الوضع السريع الفعالة الحالية.
  • يحل OpenClaw الوضع السريع بهذا الترتيب:
    1. تجاوز /fast on|off المضمن/الخاص برسالة التوجيه فقط (/fast default يمسح هذه الطبقة)
    2. تجاوز الجلسة
    3. الإعداد الافتراضي لكل وكيل (agents.list[].fastModeDefault)
    4. تكوين لكل نموذج: agents.defaults.models["<provider>/<model>"].params.fastMode
    5. الاحتياطي: off
  • بالنسبة إلى openai/*، يُعيَّن الوضع السريع إلى معالجة OpenAI ذات الأولوية بإرسال service_tier=priority في طلبات Responses المدعومة.
  • بالنسبة إلى openai-codex/*، يرسل الوضع السريع علامة service_tier=priority نفسها في Codex Responses. يحتفظ OpenClaw بمفتاح تبديل /fast مشترك واحد عبر مساري المصادقة.
  • بالنسبة إلى طلبات anthropic/* العامة المباشرة، بما في ذلك الحركة المرسلة إلى api.anthropic.com والمصادق عليها عبر OAuth، يُعيَّن الوضع السريع إلى طبقات خدمة 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 فقط عندما يكون الوضع السريع مفعلاً.

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

  • المستويات: on (أدنى حد) | full | off (افتراضي).
  • تبدّل الرسالة التي تحتوي على التوجيه فقط إسهاب الجلسة وترد بـ Verbose logging enabled. / Verbose logging disabled.؛ تعيد المستويات غير الصالحة تلميحاً دون تغيير الحالة.
  • يخزن /verbose off تجاوز جلسة صريحاً؛ امسحه عبر واجهة الجلسات باختيار inherit.
  • يؤثر التوجيه المضمن في تلك الرسالة فقط؛ وتنطبق افتراضيات الجلسة/العامة بخلاف ذلك.
  • أرسل /verbose (أو /verbose:) بلا وسيطة لرؤية مستوى الإسهاب الحالي.
  • عند تفعيل الإسهاب، ترسل الوكلاء التي تصدر نتائج أدوات مهيكلة (Pi ووكلاء JSON الآخرون) كل استدعاء أداة كرسالة مستقلة خاصة بالبيانات الوصفية فقط، مسبوقة بـ <emoji> <tool-name>: <arg> عند توفرها. تُرسل ملخصات الأدوات هذه بمجرد بدء كل أداة (فقاعات منفصلة)، وليس كدلتا بث.
  • تبقى ملخصات فشل الأدوات مرئية في الوضع العادي، لكن تُخفى لواحق تفاصيل الخطأ الخام ما لم يكن الإسهاب on أو 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.
  • تبدّل الرسالة التي تحتوي على التوجيه فقط ما إذا كانت كتل التفكير تُعرض في الردود.
  • عند التفعيل، يُرسل الاستدلال كـ رسالة منفصلة مسبوقة بـ Reasoning:.
  • stream (Telegram فقط): يبث الاستدلال في فقاعة مسودة Telegram أثناء توليد الرد، ثم يرسل الإجابة النهائية دون الاستدلال.
  • الاسم البديل: /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 افتراضياً على الحمولة النهائية فقط. لإرسال رسالة Reasoning: المنفصلة أيضاً (عند توفرها)، اضبط agents.defaults.heartbeat.includeReasoning: true أو agents.list[].heartbeat.includeReasoning: true لكل وكيل.

​
واجهة دردشة الويب

  • يعكس محدّد التفكير في دردشة الويب المستوى المخزّن للجلسة من مخزن/تكوين الجلسة الواردة عند تحميل الصفحة.
  • يؤدي اختيار مستوى آخر إلى كتابة تجاوز الجلسة فورًا عبر sessions.patch؛ فهو لا ينتظر الإرسال التالي وليس تجاوزًا لمرة واحدة عبر thinkingOnce.
  • يكون الخيار الأول دائمًا خيار مسح التجاوز. يعرض Inherited: <resolved level> عندما ترث الجلسة افتراضيًا فعّالًا غير متوقف، أو Off عندما يكون التفكير الموروث معطّلًا.
  • تُوسم اختيارات المحدّد الصريحة كتجاوزات، مع الحفاظ على تسميات المزوّد عند وجودها (على سبيل المثال Override: 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" }.
  • يجب على 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/الدردشة معرّفات وتسميات ملفات التعريف نفسها التي يستخدمها تحقق وقت التشغيل.