tools.* وإعداد المزوّد المخصّص / عنوان URL الأساسي. للوكلاء والقنوات ومفاتيح الإعداد الأخرى ذات المستوى الأعلى، راجع مرجع الإعدادات.
الأدوات
ملفات تعريف الأدوات
يحدّدtools.profile قائمة سماح أساسية قبل tools.allow/tools.deny:
تضبط عملية الإعداد المحلية افتراضيًا الإعدادات المحلية الجديدة على
tools.profile: "coding" عندما لا تكون محددة (مع الحفاظ على ملفات التعريف الصريحة الحالية).
يسمح
coding وmessaging أيضًا ضمنيًا بـ bundle-mcp (خوادم MCP التي تم إعدادها).
مجموعات الأدوات
تتيح
spawn_task لوكيل برمجة اقتراح عمل متابعة مؤكَّد من دون بدئه. تعرض واجهة التحكم العنوان والملخص على هيئة شارة قابلة للتنفيذ؛ وتعرض TUI مدعومة من Gateway مطالبة تفاعلية مكافئة. يؤدي قبول أيٍّ منهما إلى إنشاء جلسة جديدة في شجرة عمل مُدارة وإرسال المطالبة الكاملة إليها، بينما تستمر الجولة الحالية. تسحب dismiss_task اقتراحًا لا يزال معلّقًا باستخدام task_id المؤقت الذي أعادته spawn_task.
لا تُعرض الأدوات إلا عندما يكون سطح المشغّل الذي بدأ العملية قادرًا على استقبال أحداث اقتراح المهام من Gateway والتعامل معها. لا تتلقاها جلسات القنوات ولا جلسات TUI المحلية/المضمّنة؛ وتحتاج وسائل نقل القنوات إلى إجراء مهام نمطي قابل للنقل قبل أن تتمكن من إتاحة هذا التدفق بأمان. تكون الاقتراحات محلية للعملية وتختفي عند إعادة تشغيل Gateway. تظل الأداتان ضمن ملف التعريف coding والمجموعة group:sessions، ولذلك تضبطهما سياسة tools.allow وtools.deny العادية تلقائيًا عندما يدعمهما السطح.
أدوات MCP والإضافات ضمن سياسة أدوات البيئة المعزولة
تُكشف خوادم MCP التي تم إعدادها بوصفها أدوات مملوكة للإضافات تحت معرّف الإضافةbundle-mcp. يمكن لملفات تعريف الأدوات العادية السماح بها، لكن tools.sandbox.tools تمثّل بوابة إضافية للجلسات المعزولة. إذا كان وضع البيئة المعزولة هو "all" أو "non-main"، فأدرج أحد الإدخالات التالية في قائمة سماح أدوات البيئة المعزولة عندما ينبغي أن تكون أدوات MCP/الإضافات مرئية:
bundle-mcpلخوادم MCP المُدارة بواسطة OpenClaw منmcp.servers- معرّف الإضافة لإضافة أصلية محددة
group:pluginsلجميع الأدوات المملوكة للإضافات المحمّلة- أسماء أدوات خادم MCP الدقيقة أو أنماط الخوادم العامة مثل
outlook__send_mailأوoutlook__*عندما تريد خادمًا واحدًا فقط
mcp.servers الخام. تتحول الأحرف غير التابعة للنطاق [A-Za-z0-9_-] إلى -، وتحصل الأسماء التي لا تبدأ بحرف على البادئة mcp-، وقد تُقتطع البادئات الطويلة أو المكررة أو تُلحق بها لاحقة؛ فعلى سبيل المثال، يستخدم mcp.servers["Outlook Graph"] نمطًا عامًا مثل outlook-graph__*.
openclaw doctor لاكتشاف هذا النمط لخوادم MCP المُدارة بواسطة OpenClaw في mcp.servers. تستخدم خوادم MCP المحمّلة من بيانات الإضافات المضمّنة أو ملف Claude .mcp.json بوابة البيئة المعزولة نفسها، لكن هذا التشخيص لا يسرد هذه المصادر حتى الآن؛ استخدم إدخالات قائمة السماح نفسها إذا اختفت أدواتها في الجولات المعزولة.
tools.codeMode
يفعّل tools.codeMode سطح وضع البرمجة العام في OpenClaw. عند تفعيله
لتشغيل يتضمن أدوات، تنتقل أدوات OpenClaw العادية خلف جسر كتالوج tools.*
داخل البيئة المعزولة، وتصبح أدوات MCP متاحة عبر نطاق الأسماء MCP
المُنشأ. يرى النموذج عادةً exec وwait؛ وتظل الأدوات مثل computer
التي لا يمكن لنتائجها المنظّمة عبور الجسر المقتصر على JSON مباشرةً.
API.list("mcp") و
API.read("mcp/<server>.d.ts") لفحص التواقيع المشابهة لـ TypeScript قبل
استدعاء MCP.<server>.<tool>(). راجع وضع البرمجة للاطلاع على
عقد وقت التشغيل والقيود وخطوات تصحيح الأخطاء.
tools.allow / tools.deny
سياسة عامة للسماح بالأدوات أو منعها (المنع له الأولوية). لا تراعي حالة الأحرف، وتدعم أحرف البدل *. تُطبَّق حتى عندما يكون وضع الحماية Docker متوقفًا.
write وapply_patch معرّفي أداتين منفصلتين. يؤدي allow: ["write"] أيضًا إلى تمكين apply_patch للنماذج المتوافقة، لكن deny: ["write"] لا يمنع apply_patch. لمنع جميع تعديلات الملفات، امنع group:fs أو أدرج كل أداة تعديل صراحةً:
لا يمكن تعيين
allow وalsoAllow معًا في النطاق نفسه (tools أو tools.byProvider.<id> أو agents.list[].tools) — إذ يرفض التحقق من صحة الإعداد ذلك. ادمج إدخالات alsoAllow في allow، أو احذف allow واستخدم profile مع alsoAllow بدلًا منه.tools.byProvider
يفرض قيودًا إضافية على الأدوات لموفّرين أو نماذج محددة. الترتيب: ملف التعريف الأساسي ← ملف تعريف الموفّر ← السماح/المنع.
tools.toolsBySender
يفرض قيودًا على الأدوات لهوية طالب محددة. يمثّل ذلك طبقة دفاع إضافية فوق التحكم في الوصول إلى القناة؛ ويجب أن تأتي قيم المرسل من مهايئ القناة، لا من نص الرسالة.
channel:<channelId>:<senderId> أو id:<senderId> أو e164:<phone> أو username:<handle> أو name:<displayName> أو "*". معرّفات القنوات هي معرّفات OpenClaw القياسية؛ وتُطبَّع الأسماء البديلة مثل teams إلى msteams. تُقبل المفاتيح القديمة التي لا تحتوي على بادئة بصفتها id: فقط. ترتيب المطابقة هو القناة+المعرّف، ثم المعرّف، ثم e164، ثم اسم المستخدم، ثم الاسم، وأخيرًا حرف البدل.
يتجاوز agents.list[].tools.toolsBySender الخاص بكل وكيل مطابقة المرسل العامة عند تطابقه، حتى مع سياسة فارغة {}.
tools.elevated
يتحكم في الوصول المرتفع لتنفيذ الأوامر خارج وضع الحماية:
- لا يمكن للتجاوز الخاص بكل وكيل (
agents.list[].tools.elevated) سوى فرض قيود إضافية. - يخزّن
/elevated on|off|ask|fullالحالة لكل جلسة؛ وتنطبق التوجيهات المضمّنة على رسالة واحدة. - يتجاوز
execالمرتفع وضع الحماية ويستخدم مسار الخروج المُعدّ (gatewayافتراضيًا، أوnodeعندما يكون هدف التنفيذ هوnode).
tools.exec
applyPatch.allowModels (تكون فارغة/غير معيّنة افتراضيًا، ما يعني أنه يجوز لأي نموذج متوافق استخدام apply_patch). يصدر approvalRunningNoticeMs إشعارًا باستمرار التشغيل عندما يطول تنفيذ أمر مستند إلى موافقة؛ وتعطّله القيمة 0.
tools.loopDetection
تكون فحوصات أمان حلقات الأدوات معطّلة افتراضيًا. عيّن enabled: true لتفعيل الاكتشاف. يمكن تعريف الإعدادات عموميًا في tools.loopDetection وتجاوزها لكل وكيل في agents.list[].tools.loopDetection.
number
الحد الأقصى لسجل استدعاءات الأدوات المحتفظ به لتحليل الحلقات.
number
عتبة نمط التكرار دون تقدم لإصدار التحذيرات.
number
يحظر الاستدعاءات المتكررة لاسم الأداة غير المتاحة أو غير المعروفة نفسه بعد هذا العدد من الإخفاقات.
number
عتبة تكرار أعلى لحظر الحلقات الحرجة.
number
عتبة إيقاف صارمة لأي تشغيل لا يحرز تقدمًا.
boolean
يصدر تحذيرًا عند تكرار الاستدعاءات بالأداة نفسها والوسائط نفسها.
boolean
يصدر تحذيرًا أو يحظر عند استخدام أدوات الاستطلاع المعروفة (
process.poll وcommand_status وما إلى ذلك).boolean
يصدر تحذيرًا أو يحظر عند حدوث أنماط زوجية متناوبة لا تحرز تقدمًا.
number
عدد المحاولات التي يظل خلالها الحارس مفعّلًا بعد Compaction التلقائي؛ ويُجهض التشغيل إذا كرر الوكيل المجموعة نفسها (الأداة، الوسائط، النتيجة) ضمن تلك النافذة.
tools.web
provider وuserAgent. تُقيَّد قيمة maxResponseBytes بالنطاق 32000–10000000؛ وتُقيَّد قيمة maxChars بقيمة maxCharsCap (ارفع maxCharsCap للسماح باستجابات أكبر).
tools.media
يضبط فهم الوسائط الواردة (الصور/الصوت/الفيديو):
concurrency (القيمة الافتراضية 2) وaudio.maxBytes (القيمة الافتراضية 20 ميغابايت) وvideo.maxBytes (القيمة الافتراضية 50 ميغابايت) بقيمها الافتراضية؛ وتبلغ القيمة الافتراضية لـimage.maxBytes مقدار 10 ميغابايت. القيم الافتراضية لمهلة الطلب لكل قدرة: 60 ثانية للصور/الصوت، و120 ثانية للفيديو.
حقول إدخال نموذج الوسائط
حقول إدخال نموذج الوسائط
إدخال المزوّد (
type: "provider" أو محذوف):provider: معرّف مزوّد API (openaiوanthropicوgoogle/geminiوgroqوما إلى ذلك)model: تجاوز معرّف النموذجprofile/preferredProfile: اختيار ملف التعريف منauth-profiles.json
type: "cli"):command: الملف التنفيذي المراد تشغيلهargs: وسائط قالبية (تدعم{{MediaPath}}و{{Prompt}}و{{MaxChars}}وما إلى ذلك؛ ينقلopenclaw doctor --fixالعناصر النائبة المهملة{input}إلى{{MediaPath}})
capabilities: قائمة اختيارية (imageوaudioوvideo). يعلن كل Plugin مزوّد عن مجموعة قدراته الافتراضية؛ فعلى سبيل المثال، تكون القيم الافتراضية لمزوّدopenaiالمضمّن هي الصور+الصوت، ولمزوّديanthropic/minimaxالصور، ولمزوّدgoogleالصور+الصوت+الفيديو، ولمزوّدgroqالصوت.promptوmaxCharsوmaxBytesوtimeoutSecondsوlanguage: تجاوزات خاصة بكل إدخال.- تنطبق أيضًا إدخالات
tools.media.image.timeoutSecondsوإدخالاتtimeoutSecondsالمطابقة لنموذج الصور عندما يستدعي الوكيل أداةimageالصريحة. بالنسبة إلى فهم الصور، تنطبق هذه المهلة على الطلب نفسه ولا تُخفَّض بسبب أعمال التحضير السابقة. - تنتقل الإخفاقات إلى الإدخال التالي.
auth-profiles.json ← متغيرات البيئة ← models.providers.*.apiKey.حقول الإكمال غير المتزامن:asyncCompletion.directSend: علامة توافق مهملة. تظل مهام الوسائط غير المتزامنة المكتملة بوساطة جلسة مقدم الطلب، لكي يتلقى الوكيل النتيجة ويقرر كيفية إبلاغ المستخدم ويستخدم أداة الرسائل عندما يتطلب تسليم المصدر ذلك.
tools.agentToAgent
tools.sessions
يتحكم في الجلسات التي يمكن لأدوات الجلسات (sessions_list وsessions_history وsessions_send) استهدافها.
القيمة الافتراضية: tree (الجلسة الحالية + الجلسات التي أنشأتها، مثل الوكلاء الفرعيين).
نطاقات الرؤية
نطاقات الرؤية
self: مفتاح الجلسة الحالية فقط.tree: الجلسة الحالية + الجلسات التي أنشأتها الجلسة الحالية (الوكلاء الفرعيون).agent: أي جلسة تنتمي إلى معرّف الوكيل الحالي (قد تشمل مستخدمين آخرين إذا شغّلت جلسات منفصلة لكل مرسل تحت معرّف الوكيل نفسه).all: أي جلسة. لا يزال الاستهداف عبر الوكلاء يتطلبtools.agentToAgent.- تقييد صندوق العزل: عندما تكون الجلسة الحالية معزولة وتكون
agents.defaults.sandbox.sessionToolsVisibility="spawned"(القيمة الافتراضية)، تُفرض الرؤية علىtreeحتى إذا كانتtools.sessions.visibility="all". - عندما لا تكون القيمة
all، يتضمنsessions_listحقلvisibilityموجزًا يصف الوضع الفعلي وتحذيرًا بأن بعض الجلسات قد تكون محذوفة إذا كانت خارج النطاق الحالي.
tools.sessions_spawn
يتحكم في دعم المرفقات المضمّنة لـsessions_spawn.
ملاحظات المرفقات
ملاحظات المرفقات
- تتطلب المرفقات
enabled: true. - تُنشأ مرفقات الوكلاء الفرعيين فعليًا في مساحة عمل الجلسة التابعة ضمن
.openclaw/attachments/<uuid>/مع ملف.manifest.json. - تقتصر مرفقات ACP على الصور، وتُمرر مضمّنة إلى وقت تشغيل ACP بعد استيفاء حدود عدد الملفات وحجم كل ملف وإجمالي الحجم نفسها.
- تُحجب محتويات المرفقات تلقائيًا من التخزين الدائم للنصوص المنسوخة.
- يُتحقق من مدخلات Base64 باستخدام فحوص صارمة للأبجدية والحشو، مع حارس للحجم قبل فك الترميز.
- تكون أذونات ملفات مرفقات الوكلاء الفرعيين
0700للمجلدات و0600للملفات. - تتبع إزالة مرفقات الوكلاء الفرعيين سياسة
cleanup: تزيلdeleteالمرفقات دائمًا؛ ولا تحتفظ بهاkeepإلا عندما تكونretainOnSessionKeep: true.
tools.experimental
علامات الأدوات التجريبية المضمّنة. تكون معطّلة افتراضيًا ما لم تنطبق قاعدة التفعيل التلقائي لنماذج GPT-5 ذات النمط الوكيلي الصارم.
planTool: يفعّل أداةupdate_planالمنظَّمة لتتبّع الأعمال غير البسيطة متعددة الخطوات.- القيمة الافتراضية:
falseما لم تُضبطagents.defaults.embeddedAgent.executionContract(أو تجاوز خاص بكل وكيل) على"strict-agentic"لتشغيل مزوّدopenaiباستخدام معرّف نموذج من عائلة GPT-5 (يشمل ذلك أيضًا عمليات تشغيل OpenAI Codex CLI، لأن توجيه المصادقة والنماذج في Codex يقع ضمن مزوّدopenai). اضبطها علىtrueلفرض تشغيل الأداة خارج هذا النطاق، أو علىfalseلإبقائها معطّلة حتى لعمليات GPT-5 ذات النمط الوكيلي الصارم. - عند تفعيلها، تضيف مطالبة النظام أيضًا إرشادات استخدام لكي لا يستخدمها النموذج إلا للأعمال المهمة، وألا يحتفظ بأكثر من خطوة واحدة بالحالة
in_progress.
agents.defaults.subagents
model: النموذج الافتراضي للوكلاء الفرعيين المُنشَئين. إذا حُذف، يرث الوكلاء الفرعيون نموذج المستدعي.allowAgents: قائمة السماح الافتراضية لمعرّفات الوكلاء المستهدفين المضبوطة لـsessions_spawnعندما لا يضبط الوكيل مقدم الطلب قيمةsubagents.allowAgentsالخاصة به (["*"]= أي هدف مضبوط؛ القيمة الافتراضية: الوكيل نفسه فقط). يرفضsessions_spawnالإدخالات القديمة التي حُذف إعداد وكيلها، ويحذفهاagents_list؛ شغّلopenclaw doctor --fixلتنظيفها.maxConcurrent: الحد الأقصى لعمليات تشغيل الوكلاء الفرعيين المتزامنة. القيمة الافتراضية:8.runTimeoutSeconds: المهلة (بالثواني) لـsessions_spawnعندما لا يمرر المستدعي تجاوزه الخاص. القيمة الافتراضية:0(دون مهلة)؛ أما القيمة900المعروضة أعلاه فهي قيمة اختيارية شائعة وليست القيمة الافتراضية المضمّنة.announceTimeoutMs: مهلة كل استدعاء (بالمللي ثانية) لمحاولات تسليم إعلانagentعبر Gateway. القيمة الافتراضية:120000. قد تجعل إعادات المحاولة العابرة إجمالي انتظار الإعلان أطول من مهلة واحدة مضبوطة.archiveAfterMinutes: عدد الدقائق بعد اكتمال جلسة وكيل فرعي قبل أرشفتها تلقائيًا. القيمة الافتراضية:60؛ وتعطّل0الأرشفة التلقائية.- سياسة الأدوات لكل وكيل فرعي:
tools.subagents.tools.allow/tools.subagents.tools.deny.
المزوّدون المخصصون وعناوين URL الأساسية
تنشر Plugins المزوّدين صفوف كتالوج النماذج الخاصة بها. أضف مزوّدين مخصصين عبرmodels.providers في الإعداد أو ~/.openclaw/agents/<agentId>/agent/models.json.
يمثّل ضبط baseUrl لمزوّد مخصص/محلي أيضًا قرار الثقة الشبكية المحدود لطلبات HTTP الخاصة بالنماذج: يسمح OpenClaw لذلك الأصل المحدد المطابق لـscheme://host:port بالمرور عبر مسار الجلب المحمي، دون إضافة خيار إعداد منفصل أو الوثوق بأصول خاصة أخرى.
المصادقة وأسبقية الدمج
المصادقة وأسبقية الدمج
- استخدم
authHeader: trueمعheadersلتلبية احتياجات المصادقة المخصصة. - تجاوز جذر إعدادات الوكيل باستخدام
OPENCLAW_AGENT_DIR. - أسبقية الدمج لمعرّفات المزوّدين المتطابقة:
- تكون الأولوية لقيم
baseUrlغير الفارغة فيmodels.jsonالخاص بالوكيل. - تكون الأولوية لقيم
apiKeyغير الفارغة الخاصة بالوكيل فقط عندما لا يكون ذلك المزوّد مُدارًا بواسطة SecretRef في سياق الإعدادات/ملف تعريف المصادقة الحالي. - تُحدَّث قيم
apiKeyللمزوّد المُدار بواسطة SecretRef من علامات المصدر (ENV_VAR_NAMEلمراجع متغيرات البيئة، وsecretref-managedلمراجع الملف/التنفيذ) بدلًا من تخزين الأسرار المحلولة بصورة دائمة. - تُحدَّث قيم ترويسات المزوّد المُدار بواسطة SecretRef من علامات المصدر (
secretref-env:ENV_VAR_NAMEلمراجع متغيرات البيئة، وsecretref-managedلمراجع الملف/التنفيذ). - تعود قيم
apiKey/baseUrlالفارغة أو المفقودة الخاصة بالوكيل إلىmodels.providersفي الإعدادات. - عند تطابق
contextWindow/maxTokensللنموذج: تكون الأولوية لقيمة الإعداد الصريحة عند وجودها وصلاحيتها (عدد موجب ومحدود)؛ وإلا فتُستخدم قيمة الكتالوج الضمنية/المولَّدة. - يتبع
contextTokensللنموذج المتطابق القاعدة نفسها: الأولوية للقيمة الصريحة وإلا فالقيمة الضمنية؛ استخدمه لتقييد السياق الفعلي دون تغيير البيانات الوصفية الأصلية للنموذج. - تُخزَّن كتالوجات Plugin المزوّد على هيئة أجزاء كتالوج مولَّدة ومملوكة للـPlugin ضمن حالة Plugins الخاصة بالوكيل.
- استخدم
models.mode: "replace"عندما تريد من الإعدادات إعادة كتابةmodels.jsonبالكامل وتخطي دمج أجزاء الكتالوج المملوكة للـPlugin. - تخزين العلامات خاضع لمرجعية المصدر: تُكتب العلامات من لقطة إعداد المصدر النشط (قبل الحل)، لا من قيم أسرار وقت التشغيل المحلولة.
- تكون الأولوية لقيم
تفاصيل حقول المزوّد
الكتالوج عالي المستوى
الكتالوج عالي المستوى
models.mode: سلوك كتالوج المزوّد (mergeأوreplace).models.providers: خريطة مزوّدين مخصصة مفهرسة بمعرّف المزوّد.- التعديلات الآمنة: استخدم
openclaw config set models.providers.<id> '<json>' --strict-json --mergeأوopenclaw config set models.providers.<id>.models '<json-array>' --strict-json --mergeلإجراء تحديثات إضافية. يرفضconfig setعمليات الاستبدال المتلفة ما لم تمرّر--replace.
- التعديلات الآمنة: استخدم
اتصال المزوّد والمصادقة
اتصال المزوّد والمصادقة
models.providers.*.api: محوّل الطلبات (openai-completions، أوopenai-responses، أوopenai-chatgpt-responses، أوanthropic-messages، أوgoogle-generative-ai، أوgoogle-vertex، أوgithub-copilot، أوbedrock-converse-stream، أوollama، أوazure-openai-responses). بالنسبة إلى الواجهات الخلفية ذاتية الاستضافة التي تستخدم/v1/chat/completionsمثل MLX وvLLM وSGLang ومعظم الخوادم المحلية المتوافقة مع OpenAI، استخدمopenai-completions. يستخدم المزوّد المخصص الذي يحتوي علىbaseUrlمن دونapiالقيمة الافتراضيةopenai-completions؛ لا تضبطopenai-responsesإلا عندما تدعم الواجهة الخلفية/v1/responses.models.providers.*.apiKey: بيانات اعتماد المزوّد (يُفضّل استبدال SecretRef/متغير البيئة).models.providers.*.auth: استراتيجية المصادقة (api-key، أوtoken، أوoauth، أوaws-sdk).models.providers.*.contextWindow: نافذة السياق الأصلية الافتراضية للنماذج التابعة لهذا المزوّد عندما لا يضبط إدخال النموذجcontextWindow.models.providers.*.contextTokens: الحد الافتراضي الفعلي لسياق وقت التشغيل للنماذج التابعة لهذا المزوّد عندما لا يضبط إدخال النموذجcontextTokens.models.providers.*.maxTokens: الحد الافتراضي لرموز الإخراج للنماذج التابعة لهذا المزوّد عندما لا يضبط إدخال النموذجmaxTokens.models.providers.*.timeoutSeconds: مهلة اختيارية، بالثواني ولكل مزوّد، لطلب HTTP الخاص بالنموذج، وتشمل الاتصال والترويسات والنص ومعالجة إلغاء الطلب بالكامل.models.providers.*.injectNumCtxForOpenAICompat: بالنسبة إلى Ollama معopenai-completions، يحقنoptions.num_ctxفي الطلبات (الافتراضي:true).models.providers.*.authHeader: يفرض نقل بيانات الاعتماد في ترويسةAuthorizationعند الحاجة.models.providers.*.baseUrl: عنوان URL الأساسي لواجهة API في المنبع.models.providers.*.headers: ترويسات ثابتة إضافية لتوجيه الوكيل/المستأجر.
تجاوزات نقل الطلبات
تجاوزات نقل الطلبات
models.providers.*.request: تجاوزات النقل لطلبات HTTP بين النموذج والمزوّد.request.headers: ترويسات إضافية (تُدمج مع إعدادات المزوّد الافتراضية). تقبل القيم SecretRef.request.auth: تجاوز استراتيجية المصادقة. الأوضاع:"provider-default"(استخدام المصادقة المضمّنة للمزوّد)، و"authorization-bearer"(معtoken)، و"header"(معheaderNameوvalueوprefixاختياري).request.proxy: تجاوز وكيل HTTP. الأوضاع:"env-proxy"(استخدام متغيري البيئةHTTP_PROXY/HTTPS_PROXY) و"explicit-proxy"(معurl). يقبل كلا الوضعين كائنtlsفرعيًا اختياريًا.request.tls: تجاوز TLS للاتصالات المباشرة. الحقول:caوcertوkeyوpassphrase(تقبل جميعها SecretRef)، وserverName، وinsecureSkipVerify.request.allowPrivateNetwork: عندما تكون القيمةtrue، يسمح لطلبات HTTP بين النموذج والمزوّد بالوصول إلى النطاقات الخاصة أو CGNAT أو النطاقات المشابهة عبر حاجز جلب HTTP الخاص بالمزوّد. تثق عناوين URL الأساسية للمزوّد المخصص/المحلي مسبقًا في الأصل المضبوط نفسه تمامًا، باستثناء أصول البيانات الوصفية/الارتباط المحلي التي تظل محظورة من دون اشتراك صريح. اضبط هذا علىfalseلإلغاء الثقة بالأصل المطابق تمامًا. يستخدم WebSocket إعدادrequestنفسه للترويسات/TLS، لكن ليس بوابة SSRF الخاصة بالجلب. القيمة الافتراضيةfalse.
إدخالات كتالوج النماذج
إدخالات كتالوج النماذج
models.providers.*.models: إدخالات كتالوج نماذج المزوّد الصريحة.models.providers.*.models.*.input: أنماط إدخال النموذج. استخدم["text"]للنماذج النصية فقط و["text", "image"]للنماذج الأصلية للصور/الرؤية. لا تُحقن مرفقات الصور في دورات الوكيل إلا عندما يُعلَّم النموذج المحدد بأنه قادر على معالجة الصور.models.providers.*.models.*.contextWindow: البيانات الوصفية لنافذة السياق الأصلية للنموذج. يتجاوز هذاcontextWindowعلى مستوى المزوّد لذلك النموذج.models.providers.*.models.*.contextTokens: حد اختياري لسياق وقت التشغيل. يتجاوز هذاcontextTokensعلى مستوى المزوّد؛ استخدمه عندما تريد ميزانية سياق فعلية أصغر منcontextWindowالأصلية للنموذج؛ يعرضopenclaw models listالقيمتين عندما تختلفان.models.providers.*.models.*.compat.supportsDeveloperRole: تلميح توافق اختياري. عند استخدامapi: "openai-completions"معbaseUrlغير فارغ وغير أصلي (المضيف ليسapi.openai.com)، يفرض OpenClaw القيمةfalseفي وقت التشغيل. يحافظbaseUrlالفارغ/المحذوف على سلوك OpenAI الافتراضي.models.providers.*.models.*.compat.requiresStringContent: تلميح توافق اختياري لنقاط نهاية الدردشة المتوافقة مع OpenAI التي تقبل السلاسل فقط. عندما تكون القيمةtrue، يحوّل OpenClaw مصفوفاتmessages[].contentالنصية البحتة إلى سلاسل عادية قبل إرسال الطلب.models.providers.*.models.*.compat.strictMessageKeys: تلميح توافق اختياري لنقاط نهاية الدردشة الصارمة المتوافقة مع OpenAI. عندما تكون القيمةtrue، يختزل OpenClaw كائنات رسائل Chat Completions الصادرة إلىroleوcontentقبل إرسال الطلب.models.providers.*.models.*.compat.thinkingFormat: تلميح اختياري لحمولة التفكير. استخدم"together"معreasoning.enabledبأسلوب Together، أو"qwen"معenable_thinkingعالي المستوى، أو"qwen-chat-template"معchat_template_kwargs.enable_thinkingعلى خوادم عائلة Qwen المتوافقة مع OpenAI التي تدعم معاملات قالب الدردشة على مستوى الطلب، مثل vLLM. تعرض نماذج Qwen المضبوطة في vLLM خيارات/thinkثنائية (offوon) لهذه التنسيقات.models.providers.*.models.*.compat.requiresReasoningContentOnAssistantMessages: تلميح توافق اختياري لواجهات Chat Completions الخلفية بأسلوب DeepSeek التي تتطلب احتفاظ رسائل المساعد السابقة بـreasoning_contentعند إعادة التشغيل. عندما تكون القيمةtrue، يحافظ OpenClaw على هذا الحقل في رسائل المساعد الصادرة. استخدم هذا عند توصيل وكيل مخصص متوافق مع DeepSeek يرفض الطلبات بعد إزالة الاستدلال. القيمة الافتراضيةfalse.
اكتشاف Amazon Bedrock
اكتشاف Amazon Bedrock
plugins.entries.amazon-bedrock.config.discovery: جذر إعدادات الاكتشاف التلقائي لـBedrock.plugins.entries.amazon-bedrock.config.discovery.enabled: تشغيل/إيقاف الاكتشاف الضمني.plugins.entries.amazon-bedrock.config.discovery.region: منطقة AWS للاكتشاف.plugins.entries.amazon-bedrock.config.discovery.providerFilter: مرشح اختياري لمعرّف المزوّد للاكتشاف المستهدف.plugins.entries.amazon-bedrock.config.discovery.refreshInterval: الفاصل الزمني للاستقصاء لتحديث الاكتشاف.plugins.entries.amazon-bedrock.config.discovery.defaultContextWindow: نافذة السياق الاحتياطية للنماذج المكتشفة.plugins.entries.amazon-bedrock.config.discovery.defaultMaxTokens: الحد الأقصى الاحتياطي لرموز الإخراج للنماذج المكتشفة.
o1/o3/o4 وClaude وGemini وأي معرّف ينتهي بـ-vl (Qwen-VL وما شابه) والعائلات المسماة مثل LLaVA وPixtral وInternVL وMllama وMiniCPM-V وGLM-4V؛ ويتخطى السؤال الإضافي لعائلات النماذج النصية فقط المعروفة (Llama وDeepSeek وMistral/Mixtral وKimi/Moonshot وCodestral وDevstral وPhi وQwQ وCodeLlama ومعرّفات Qwen المجردة التي لا تحتوي على لاحقة vl/vision). تظل معرّفات النماذج غير المعروفة تطلب تحديد دعم الصور. يستخدم الإعداد غير التفاعلي الاستنتاج نفسه؛ مرّر --custom-image-input لفرض بيانات وصفية تدعم الصور أو --custom-text-input لفرض بيانات وصفية نصية فقط.
أمثلة المزوّدين
Cerebras (GLM 4.7 / GPT OSS)
Cerebras (GLM 4.7 / GPT OSS)
يمكن لـPlugin المزوّد الخارجي الرسمي استخدم
cerebras ضبط ذلك عبر openclaw onboard --auth-choice cerebras-api-key. استخدم إعداد المزوّد الصريح فقط عند تجاوز الإعدادات الافتراضية.cerebras/zai-glm-4.7 مع Cerebras؛ وzai/glm-4.7 للاتصال المباشر بـZ.AI.Kimi Coding
Kimi Coding
openclaw onboard --auth-choice kimi-code-api-key.النماذج المحلية (LM Studio)
النماذج المحلية (LM Studio)
راجع النماذج المحلية. الخلاصة: شغّل نموذجًا محليًا كبيرًا عبر LM Studio Responses API على عتاد قوي؛ وأبقِ النماذج المستضافة مدمجة لاستخدامها كخيار احتياطي.
MiniMax M3 (مباشر)
MiniMax M3 (مباشر)
MINIMAX_API_KEY. الاختصارات: openclaw onboard --auth-choice minimax-global-api أو openclaw onboard --auth-choice minimax-cn-api. يستخدم كتالوج النماذج M3 افتراضيًا، ويتضمن أيضًا متغيرات M2.7. في مسار البث المتوافق مع Anthropic، يعطّل OpenClaw التفكير في MiniMax M2.x افتراضيًا ما لم تعيّن thinking بنفسك صراحةً؛ بينما يظل MiniMax-M3 (وM3.x) افتراضيًا على مسار التفكير المحذوف/التكيفي الخاص بموفّر الخدمة. يعيد /fast on أو params.fastMode: true كتابة MiniMax-M2.7 إلى MiniMax-M2.7-highspeed.Moonshot AI (Kimi)
Moonshot AI (Kimi)
baseUrl: "https://api.moonshot.cn/v1" أو openclaw onboard --auth-choice moonshot-api-key-cn.تعلن نقاط نهاية Moonshot الأصلية توافق استخدام البث عبر وسيلة النقل المشتركة openai-completions، ويحدد OpenClaw ذلك استنادًا إلى إمكانات نقطة النهاية بدلًا من الاعتماد على معرّف موفّر الخدمة المدمج وحده.OpenCode
OpenCode
OPENCODE_API_KEY (أو OPENCODE_ZEN_API_KEY). استخدم مراجع opencode/... لكتالوج Zen أو مراجع opencode-go/... لكتالوج Go. الاختصار: openclaw onboard --auth-choice opencode-zen أو openclaw onboard --auth-choice opencode-go.Synthetic (متوافق مع Anthropic)
Synthetic (متوافق مع Anthropic)
/v1 (إذ يضيفها عميل Anthropic). الاختصار: openclaw onboard --auth-choice synthetic-api-key.Z.AI (GLM-4.7)
Z.AI (GLM-4.7)
ZAI_API_KEY. تستخدم مراجع النماذج معرّف موفّر الخدمة القياسي zai/*. الاختصار: openclaw onboard --auth-choice zai-api-key.- نقطة النهاية العامة:
https://api.z.ai/api/paas/v4 - نقطة نهاية البرمجة:
https://api.z.ai/api/coding/paas/v4 - يفحص خيار المصادقة الافتراضي
zai-api-keyمفتاحك ويكتشف تلقائيًا نقطة النهاية التي ينتمي إليها (وينتقل إلى مطالبة عند تعذّر الوصول إلى نتيجة حاسمة، مع اعتماد Global افتراضيًا). تتوفر أيضًا خيارات مصادقة مخصصة للصين وخطة البرمجة للاختيار الصريح. - لنقطة النهاية العامة، عرّف موفّر خدمة مخصصًا مع تجاوز عنوان URL الأساسي.
ذو صلة
- الإعدادات — الوكلاء
- الإعدادات — القنوات
- مرجع الإعدادات — مفاتيح أخرى من المستوى الأعلى
- الأدوات والإضافات