--- read_when: - تكوين سياسة `tools.*` أو قوائم السماح أو الميزات التجريبية - تسجيل موفّرين مخصصين أو تجاوز عناوين URL الأساسية - إعداد نقاط نهاية ذاتية الاستضافة متوافقة مع OpenAI sidebarTitle: Tools and custom providers summary: إعدادات الأدوات (السياسة، والمفاتيح التجريبية، والأدوات المدعومة بمزوّد) وإعداد المزوّد المخصص/عنوان URL الأساسي title: التكوين — الأدوات والمزوّدون المخصّصون x-i18n: generated_at: "2026-05-11T20:32:08Z" model: gpt-5.5 provider: openai source_hash: c9ab0ec823da1e2e8598d9efb998a207c4486ba82dcf4dd65422c6bf90581b46 source_path: gateway/config-tools.md workflow: 16 --- `tools.*` مفاتيح إعداد وإعداد المزوّد المخصّص / عنوان URL الأساسي. بالنسبة إلى الوكلاء والقنوات ومفاتيح الإعداد الأخرى ذات المستوى الأعلى، راجع [مرجع الإعداد](/ar/gateway/configuration-reference). ## الأدوات ### ملفات تعريف الأدوات يضبط `tools.profile` قائمة سماح أساسية قبل `tools.allow`/`tools.deny`: تجعل التهيئة المحلية الإعدادات المحلية الجديدة تستخدم `tools.profile: "coding"` افتراضيًا عند عدم ضبطها (وتُحفَظ ملفات التعريف الصريحة الموجودة). | ملف التعريف | يتضمن | | ----------- | ------------------------------------------------------------------------------------------------------------------------------- | | `minimal` | `session_status` فقط | | `coding` | `group:fs`, `group:runtime`, `group:web`, `group:sessions`, `group:memory`, `cron`, `image`, `image_generate`, `video_generate` | | `messaging` | `group:messaging`, `sessions_list`, `sessions_history`, `sessions_send`, `session_status` | | `full` | بلا قيود (مثل عدم الضبط) | ### مجموعات الأدوات | المجموعة | الأدوات | | ------------------ | ----------------------------------------------------------------------------------------------------------------------- | | `group:runtime` | `exec`, `process`, `code_execution` (يُقبل `bash` كاسم بديل لـ `exec`) | | `group:fs` | `read`, `write`, `edit`, `apply_patch` | | `group:sessions` | `sessions_list`, `sessions_history`, `sessions_send`, `sessions_spawn`, `sessions_yield`, `subagents`, `session_status` | | `group:memory` | `memory_search`, `memory_get` | | `group:web` | `web_search`, `x_search`, `web_fetch` | | `group:ui` | `browser`, `canvas` | | `group:automation` | `heartbeat_respond`, `cron`, `gateway` | | `group:messaging` | `message` | | `group:nodes` | `nodes` | | `group:agents` | `agents_list`, `update_plan` | | `group:media` | `image`, `image_generate`, `music_generate`, `video_generate`, `tts` | | `group:openclaw` | كل الأدوات المضمّنة (تستثني Plugins المزوّدين) | ### `tools.allow` / `tools.deny` سياسة السماح/الرفض العامة للأدوات (الرفض له الأولوية). غير حساسة لحالة الأحرف، وتدعم أحرف البدل `*`. تُطبّق حتى عندما يكون صندوق عزل Docker متوقفًا. ```json5 { tools: { deny: ["browser", "canvas"] }, } ``` `write` و`apply_patch` معرّفا أداتين منفصلان. يفعّل `allow: ["write"]` أيضًا `apply_patch` للنماذج المتوافقة، لكن `deny: ["write"]` لا يرفض `apply_patch`. لحظر كل تعديل للملفات، ارفض `group:fs` أو اذكر كل أداة مُعدِّلة صراحةً: ```json5 { tools: { deny: ["write", "edit", "apply_patch"] }, } ``` ### `tools.byProvider` يقيّد الأدوات أكثر لمزوّدين أو نماذج محددة. الترتيب: ملف التعريف الأساسي ← ملف تعريف المزوّد ← السماح/الرفض. ```json5 { tools: { profile: "coding", byProvider: { "google-antigravity": { profile: "minimal" }, "openai/gpt-5.4": { allow: ["group:fs", "sessions_list"] }, }, }, } ``` ### `tools.toolsBySender` يقيّد الأدوات لهوية طالب محددة. هذا دفاع متعدد الطبقات فوق التحكم في وصول القناة؛ يجب أن تأتي قيم المرسل من محوّل القناة، لا من نص الرسالة. ```json5 { tools: { toolsBySender: { "channel:discord:1234567890123": { alsoAllow: ["group:fs"] }, "id:guest-user-id": { deny: ["group:runtime", "group:fs"] }, "*": { deny: ["exec", "process", "write", "edit", "apply_patch"] }, }, }, } ``` تستخدم المفاتيح بادئات صريحة: `channel::` أو `id:` أو `e164:` أو `username:` أو `name:` أو `"*"`. معرّفات القنوات هي معرّفات OpenClaw القياسية؛ تُطبَّع الأسماء البديلة مثل `teams` إلى `msteams`. تُقبل المفاتيح القديمة بلا بادئة كـ `id:` فقط. ترتيب المطابقة هو القناة+المعرّف، ثم المعرّف، ثم e164، ثم اسم المستخدم، ثم الاسم، ثم حرف البدل. يتجاوز `agents.list[].tools.toolsBySender` الخاص بكل وكيل مطابقة المرسل العامة عند مطابقته، حتى مع سياسة فارغة `{}`. ### `tools.elevated` يتحكم في وصول `exec` المرتفع خارج صندوق العزل: ```json5 { tools: { elevated: { enabled: true, allowFrom: { whatsapp: ["+15555550123"], discord: ["1234567890123", "987654321098765432"], }, }, }, } ``` - لا يمكن للتجاوز الخاص بكل وكيل (`agents.list[].tools.elevated`) إلا أن يقيّد أكثر. - يخزّن `/elevated on|off|ask|full` الحالة لكل جلسة؛ وتُطبّق التوجيهات المضمنة على رسالة واحدة. - يتجاوز `exec` المرتفع العزل ويستخدم مسار الخروج المضبوط (`gateway` افتراضيًا، أو `node` عندما يكون هدف التنفيذ هو `node`). ### `tools.exec` ```json5 { tools: { exec: { backgroundMs: 10000, timeoutSec: 1800, cleanupMs: 1800000, notifyOnExit: true, notifyOnExitEmptySuccess: false, commandHighlighting: false, applyPatch: { enabled: false, allowModels: ["gpt-5.5"], }, }, }, } ``` ### `tools.loopDetection` Tool-loop safety checks معطّلة **افتراضيًا**. اضبط `enabled: true` لتفعيل الاكتشاف. يمكن تعريف الإعدادات عموميًا في `tools.loopDetection` وتجاوزها لكل وكيل في `agents.list[].tools.loopDetection`. ```json5 { tools: { loopDetection: { enabled: true, historySize: 30, warningThreshold: 10, criticalThreshold: 20, globalCircuitBreakerThreshold: 30, detectors: { genericRepeat: true, knownPollNoProgress: true, pingPong: true, }, }, }, } ``` الحد الأقصى لسجل استدعاءات الأدوات المحتفَظ به لتحليل الحلقات. عتبة نمط التكرار بلا تقدم للتحذيرات. عتبة تكرار أعلى لحظر الحلقات الحرجة. عتبة إيقاف صارمة لأي تشغيل بلا تقدم. التحذير عند تكرار استدعاءات الأداة نفسها/الوسائط نفسها. التحذير/الحظر عند أدوات الاستطلاع المعروفة (`process.poll`، `command_status`، إلخ). التحذير/الحظر عند أنماط الأزواج المتناوبة بلا تقدم. إذا كان `warningThreshold >= criticalThreshold` أو `criticalThreshold >= globalCircuitBreakerThreshold`، يفشل التحقق. ### `tools.web` ```json5 { tools: { web: { search: { enabled: true, apiKey: "brave_api_key", // or BRAVE_API_KEY env maxResults: 5, timeoutSeconds: 30, cacheTtlMinutes: 15, }, fetch: { enabled: true, provider: "firecrawl", // optional; omit for auto-detect maxChars: 50000, maxCharsCap: 50000, maxResponseBytes: 2000000, timeoutSeconds: 30, cacheTtlMinutes: 15, maxRedirects: 3, readability: true, userAgent: "custom-ua", }, }, }, } ``` ### `tools.media` يضبط فهم الوسائط الواردة (الصور/الصوت/الفيديو): ```json5 { tools: { media: { concurrency: 2, asyncCompletion: { directSend: false, // deprecated: completions stay agent-mediated }, audio: { enabled: true, maxBytes: 20971520, scope: { default: "deny", rules: [{ action: "allow", match: { chatType: "direct" } }], }, models: [ { provider: "openai", model: "gpt-4o-mini-transcribe" }, { type: "cli", command: "whisper", args: ["--model", "base", "{{MediaPath}}"] }, ], }, image: { enabled: true, timeoutSeconds: 180, models: [{ provider: "ollama", model: "gemma4:26b", timeoutSeconds: 300 }], }, video: { enabled: true, maxBytes: 52428800, models: [{ provider: "google", model: "gemini-3-flash-preview" }], }, }, }, } ``` **إدخال المزوّد** (`type: "provider"` أو محذوف): - `provider`: معرّف مزوّد API (`openai`، `anthropic`، `google`/`gemini`، `groq`، إلخ) - `model`: تجاوز معرّف النموذج - `profile` / `preferredProfile`: اختيار ملف تعريف `auth-profiles.json` **إدخال CLI** (`type: "cli"`): - `command`: الملف التنفيذي المراد تشغيله - `args`: وسائط بنمط قالب (تدعم `{{MediaPath}}`، `{{Prompt}}`، `{{MaxChars}}`، إلخ؛ يرحّل `openclaw doctor --fix` العناصر النائبة المهملة `{input}` إلى `{{MediaPath}}`) **الحقول المشتركة:** - `capabilities`: قائمة اختيارية (`image`، `audio`، `video`). القيم الافتراضية: `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` ```json5 { tools: { agentToAgent: { enabled: false, allow: ["home", "work"], }, }, } ``` ### `tools.sessions` يتحكم في الجلسات التي يمكن استهدافها بواسطة أدوات الجلسات (`sessions_list`، `sessions_history`، `sessions_send`). الافتراضي: `tree` (الجلسة الحالية + الجلسات التي أنشأتها، مثل الوكلاء الفرعيين). ```json5 { tools: { sessions: { // "self" | "tree" | "agent" | "all" visibility: "tree", }, }, } ``` - `self`: مفتاح الجلسة الحالية فقط. - `tree`: الجلسة الحالية + الجلسات التي أنشأتها الجلسة الحالية (الوكلاء الفرعيون). - `agent`: أي جلسة تنتمي إلى معرّف الوكيل الحالي (يمكن أن تشمل مستخدمين آخرين إذا شغّلت جلسات لكل مرسل تحت معرّف الوكيل نفسه). - `all`: أي جلسة. لا يزال الاستهداف عبر الوكلاء يتطلب `tools.agentToAgent`. - تقييد صندوق العزل: عندما تكون الجلسة الحالية معزولة ويكون `agents.defaults.sandbox.sessionToolsVisibility="spawned"`، تُفرض الرؤية على `tree` حتى إذا كان `tools.sessions.visibility="all"`. ### `tools.sessions_spawn` يتحكم في دعم المرفقات المضمنة لـ `sessions_spawn`. ```json5 { tools: { sessions_spawn: { attachments: { enabled: false, // opt-in: set true to allow inline file attachments maxTotalBytes: 5242880, // 5 MB total across all files maxFiles: 50, maxFileBytes: 1048576, // 1 MB per file retainOnSessionKeep: false, // keep attachments when cleanup="keep" }, }, }, } ``` - لا تُدعم المرفقات إلا مع `runtime: "subagent"`. يرفضها وقت تشغيل ACP. - تُحوَّل الملفات إلى ملفات فعلية داخل مساحة عمل الابن في `.openclaw/attachments//` مع ملف `.manifest.json`. - يُحجب محتوى المرفقات تلقائيًا من استمرارية النصوص المنسوخة. - تُتحقق مُدخلات Base64 بفحوصات صارمة للأبجدية/الحشو وحارس حجم قبل فك الترميز. - أذونات الملفات هي `0700` للأدلة و`0600` للملفات. - يتبع التنظيف سياسة `cleanup`: يزيل `delete` المرفقات دائمًا؛ ويُبقيها `keep` فقط عند ضبط `retainOnSessionKeep: true`. ### `tools.experimental` أعلام الأدوات المضمّنة التجريبية. تكون متوقفة افتراضيًا ما لم تنطبق قاعدة تفعيل تلقائي صارمة-وكيلية لـ GPT-5. ```json5 { tools: { experimental: { planTool: true, // enable experimental update_plan }, }, } ``` - `planTool`: يفعّل أداة `update_plan` المهيكلة لتتبّع الأعمال متعددة الخطوات غير البسيطة. - الافتراضي: `false` ما لم يتم ضبط `agents.defaults.embeddedPi.executionContract` (أو تجاوز لكل وكيل) على `"strict-agentic"` لتشغيل من عائلة OpenAI أو OpenAI Codex GPT-5. اضبطه على `true` لفرض تشغيل الأداة خارج ذلك النطاق، أو `false` لإبقائها متوقفة حتى في تشغيلات GPT-5 صارمة-وكيلية. - عند تفعيلها، تضيف مطالبة النظام أيضًا إرشادات استخدام كي لا يستخدمها النموذج إلا للأعمال الكبيرة، مع إبقاء خطوة واحدة على الأكثر بحالة `in_progress`. ### `agents.defaults.subagents` ```json5 { agents: { defaults: { subagents: { allowAgents: ["research"], model: "minimax/MiniMax-M2.7", maxConcurrent: 8, runTimeoutSeconds: 900, announceTimeoutMs: 120000, archiveAfterMinutes: 60, }, }, }, } ``` - `model`: النموذج الافتراضي للوكلاء الفرعيين المُنشئين. إذا حُذف، يرث الوكلاء الفرعيون نموذج المستدعي. - `allowAgents`: قائمة السماح الافتراضية لمعرّفات الوكلاء الهدف لـ `sessions_spawn` عندما لا يضبط الوكيل الطالب `subagents.allowAgents` الخاص به (`["*"]` = أي وكيل؛ الافتراضي: الوكيل نفسه فقط). - `runTimeoutSeconds`: المهلة الافتراضية (بالثواني) لـ `sessions_spawn` عندما يحذف استدعاء الأداة `runTimeoutSeconds`. تعني `0` عدم وجود مهلة. - `announceTimeoutMs`: مهلة لكل استدعاء (بالمللي ثانية) لمحاولات تسليم إعلان `agent` عبر Gateway. الافتراضي: `120000`. قد تجعل إعادة المحاولة المؤقتة إجمالي انتظار الإعلان أطول من مهلة واحدة مكوّنة. - سياسة أدوات لكل وكيل فرعي: `tools.subagents.tools.allow` / `tools.subagents.tools.deny`. --- ## المزوّدون المخصصون وعناوين URL الأساسية يستخدم OpenClaw كتالوج النماذج المضمّن. أضف مزوّدين مخصصين عبر `models.providers` في الإعدادات أو `~/.openclaw/agents//agent/models.json`. ```json5 { models: { mode: "merge", // merge (default) | replace providers: { "custom-proxy": { baseUrl: "http://localhost:4000/v1", apiKey: "LITELLM_KEY", api: "openai-completions", // openai-completions | openai-responses | anthropic-messages | google-generative-ai models: [ { id: "llama-3.1-8b", name: "Llama 3.1 8B", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, contextTokens: 96000, maxTokens: 32000, }, ], }, }, }, } ``` - استخدم `authHeader: true` + `headers` لاحتياجات المصادقة المخصصة. - تجاوز جذر إعدادات الوكيل باستخدام `OPENCLAW_AGENT_DIR` (أو `PI_CODING_AGENT_DIR`، وهو اسم مستعار قديم لمتغير بيئة). - أسبقية الدمج لمعرّفات المزوّدين المتطابقة: - قيم `baseUrl` غير الفارغة في `models.json` الخاصة بالوكيل هي التي تفوز. - قيم `apiKey` غير الفارغة في الوكيل تفوز فقط عندما لا يكون ذلك المزوّد مُدارًا بواسطة SecretRef في سياق الإعدادات/ملف تعريف المصادقة الحالي. - تُحدَّث قيم `apiKey` للمزوّد المُدار بواسطة SecretRef من علامات المصدر (`ENV_VAR_NAME` لمراجع env، و`secretref-managed` لمراجع file/exec) بدلًا من الاستمرار في تخزين الأسرار المحلولة. - تُحدَّث قيم ترويسة المزوّد المُدار بواسطة SecretRef من علامات المصدر (`secretref-env:ENV_VAR_NAME` لمراجع env، و`secretref-managed` لمراجع file/exec). - تعود قيم `apiKey`/`baseUrl` الفارغة أو المفقودة في الوكيل إلى `models.providers` في الإعدادات. - تستخدم `contextWindow`/`maxTokens` للنموذج المتطابق القيمة الأعلى بين الإعدادات الصريحة وقيم الكتالوج الضمنية. - تحفظ `contextTokens` للنموذج المتطابق حدًا صريحًا لوقت التشغيل عند وجوده؛ استخدمه للحد من السياق الفعّال دون تغيير بيانات النموذج الأصلية. - استخدم `models.mode: "replace"` عندما تريد أن تعيد الإعدادات كتابة `models.json` بالكامل. - استمرارية العلامات موثوقة المصدر: تُكتب العلامات من لقطة إعدادات المصدر النشطة (قبل الحل)، وليس من قيم أسرار وقت التشغيل المحلولة. ### تفاصيل حقول المزوّد - `models.mode`: سلوك كتالوج المزوّدين (`merge` أو `replace`). - `models.providers`: خريطة المزوّدين المخصصين، مفهرسة حسب معرّف المزوّد. - تعديلات آمنة: استخدم `openclaw config set models.providers. '' --strict-json --merge` أو `openclaw config set models.providers..models '' --strict-json --merge` للتحديثات الإضافية. يرفض `config set` الاستبدالات المدمّرة ما لم تمرر `--replace`. - `models.providers.*.api`: محوّل الطلبات (`openai-completions`، `openai-responses`، `anthropic-messages`، `google-generative-ai`، إلخ). للخلفيات ذاتية الاستضافة `/v1/chat/completions` مثل MLX وvLLM وSGLang ومعظم الخوادم المحلية المتوافقة مع OpenAI، استخدم `openai-completions`. مزوّد مخصص لديه `baseUrl` دون `api` يستخدم افتراضيًا `openai-completions`؛ اضبط `openai-responses` فقط عندما تدعم الخلفية `/v1/responses`. - `models.providers.*.apiKey`: بيانات اعتماد المزوّد (يفضّل استبدال SecretRef/env). - `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`، يسمح بـ HTTPS إلى `baseUrl` عندما يحل DNS إلى نطاقات خاصة أو CGNAT أو نطاقات مشابهة، عبر حارس جلب HTTP للمزوّد (اشتراك صريح من المشغّل لنقاط نهاية متوافقة مع OpenAI وذاتية الاستضافة وموثوقة). يُسمح تلقائيًا بعناوين URL الخاصة بتدفق مزوّد النموذج عبر local loopback مثل `localhost` و`127.0.0.1` و`[::1]` ما لم يُضبط هذا صراحة على `false`؛ ولا تزال مضيفات LAN وtailnet وDNS الخاصة تتطلب اشتراكًا صريحًا. يستخدم WebSocket نفس `request` للترويسات/TLS لكن لا يستخدم بوابة SSRF لجلب HTTP تلك. الافتراضي `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`: تلميح اختياري لحمولة التفكير. استخدم `"qwen"` لـ `enable_thinking` على المستوى الأعلى، أو `"qwen-chat-template"` لـ `chat_template_kwargs.enable_thinking` على خوادم عائلة Qwen المتوافقة مع OpenAI والتي تدعم kwargs لقالب الدردشة على مستوى الطلب، مثل vLLM. - `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`: الحد الأقصى الاحتياطي لرموز الإخراج للنماذج المكتشفة. تستنتج عملية إعداد المزوّد المخصّص التفاعلية دعم إدخال الصور لمعرّفات نماذج الرؤية الشائعة مثل GPT-4o وClaude وGemini وQwen-VL وLLaVA وPixtral وInternVL وMllama وMiniCPM-V وGLM-4V، وتتجاوز السؤال الإضافي للعائلات المعروفة بأنها نصية فقط. لا تزال معرّفات النماذج غير المعروفة تطلب تحديد دعم الصور. يستخدم الإعداد غير التفاعلي الاستنتاج نفسه؛ مرّر `--custom-image-input` لفرض بيانات وصفية تدعم الصور أو `--custom-text-input` لفرض بيانات وصفية نصية فقط. ### أمثلة المزوّدين يمكن لـPlugin المزوّد المضمّن `cerebras` تهيئة ذلك عبر `openclaw onboard --auth-choice cerebras-api-key`. استخدم إعدادات المزوّد الصريحة فقط عند تجاوز القيم الافتراضية. ```json5 { env: { CEREBRAS_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "cerebras/zai-glm-4.7", fallbacks: ["cerebras/gpt-oss-120b"], }, models: { "cerebras/zai-glm-4.7": { alias: "GLM 4.7 (Cerebras)" }, "cerebras/gpt-oss-120b": { alias: "GPT OSS 120B (Cerebras)" }, }, }, }, models: { mode: "merge", providers: { cerebras: { baseUrl: "https://api.cerebras.ai/v1", apiKey: "${CEREBRAS_API_KEY}", api: "openai-completions", models: [ { id: "zai-glm-4.7", name: "GLM 4.7 (Cerebras)" }, { id: "gpt-oss-120b", name: "GPT OSS 120B (Cerebras)" }, ], }, }, }, } ``` استخدم `cerebras/zai-glm-4.7` لـCerebras؛ و`zai/glm-4.7` لاتصال Z.AI المباشر. ```json5 { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" }, models: { "kimi/kimi-for-coding": { alias: "Kimi Code" } }, }, }, } ``` متوافق مع Anthropic ومزوّد مدمج. الاختصار: `openclaw onboard --auth-choice kimi-code-api-key`. راجع [النماذج المحلية](/ar/gateway/local-models). باختصار: شغّل نموذجًا محليًا كبيرًا عبر LM Studio Responses API على عتاد جاد؛ وأبقِ النماذج المستضافة مدمجة للاستخدام كبديل احتياطي. ```json5 { agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" }, models: { "minimax/MiniMax-M2.7": { alias: "Minimax" }, }, }, }, models: { mode: "merge", providers: { minimax: { baseUrl: "https://api.minimax.io/anthropic", apiKey: "${MINIMAX_API_KEY}", api: "anthropic-messages", models: [ { id: "MiniMax-M2.7", name: "MiniMax M2.7", reasoning: true, input: ["text"], cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 }, contextWindow: 204800, maxTokens: 131072, }, ], }, }, }, } ``` عيّن `MINIMAX_API_KEY`. الاختصارات: `openclaw onboard --auth-choice minimax-global-api` أو `openclaw onboard --auth-choice minimax-cn-api`. يقتصر كتالوج النماذج افتراضيًا على M2.7 فقط. في مسار البث المتوافق مع Anthropic، يعطّل OpenClaw التفكير في MiniMax افتراضيًا ما لم تضبط `thinking` صراحة بنفسك. يعيد `/fast on` أو `params.fastMode: true` كتابة `MiniMax-M2.7` إلى `MiniMax-M2.7-highspeed`. ```json5 { env: { MOONSHOT_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "moonshot/kimi-k2.6" }, models: { "moonshot/kimi-k2.6": { alias: "Kimi K2.6" } }, }, }, models: { mode: "merge", providers: { moonshot: { baseUrl: "https://api.moonshot.ai/v1", apiKey: "${MOONSHOT_API_KEY}", api: "openai-completions", models: [ { id: "kimi-k2.6", name: "Kimi K2.6", reasoning: false, input: ["text", "image"], cost: { input: 0.95, output: 4, cacheRead: 0.16, cacheWrite: 0 }, contextWindow: 262144, maxTokens: 262144, }, ], }, }, }, } ``` لنقطة النهاية في الصين: `baseUrl: "https://api.moonshot.cn/v1"` أو `openclaw onboard --auth-choice moonshot-api-key-cn`. تعلن نقاط نهاية Moonshot الأصلية عن توافق استخدام البث على نقل `openai-completions` المشترك، ويربط OpenClaw ذلك بقدرات نقطة النهاية بدلًا من معرّف المزوّد المدمج وحده. ```json5 { agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" }, models: { "opencode/claude-opus-4-6": { alias: "Opus" } }, }, }, } ``` عيّن `OPENCODE_API_KEY` (أو `OPENCODE_ZEN_API_KEY`). استخدم مراجع `opencode/...` لكتالوج Zen أو مراجع `opencode-go/...` لكتالوج Go. الاختصار: `openclaw onboard --auth-choice opencode-zen` أو `openclaw onboard --auth-choice opencode-go`. ```json5 { env: { SYNTHETIC_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" }, models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "MiniMax M2.5" } }, }, }, models: { mode: "merge", providers: { synthetic: { baseUrl: "https://api.synthetic.new/anthropic", apiKey: "${SYNTHETIC_API_KEY}", api: "anthropic-messages", models: [ { id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5", reasoning: true, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 192000, maxTokens: 65536, }, ], }, }, }, } ``` يجب أن يحذف عنوان URL الأساسي `/v1` (يضيفه عميل Anthropic). الاختصار: `openclaw onboard --auth-choice synthetic-api-key`. ```json5 { agents: { defaults: { model: { primary: "zai/glm-4.7" }, models: { "zai/glm-4.7": {} }, }, }, } ``` عيّن `ZAI_API_KEY`. تُقبل `z.ai/*` و`z-ai/*` كأسماء بديلة. الاختصار: `openclaw onboard --auth-choice zai-api-key`. - نقطة النهاية العامة: `https://api.z.ai/api/paas/v4` - نقطة نهاية البرمجة (افتراضية): `https://api.z.ai/api/coding/paas/v4` - لنقطة النهاية العامة، عرّف مزوّدًا مخصّصًا مع تجاوز عنوان URL الأساسي. --- ## ذو صلة - [الإعدادات — الوكلاء](/ar/gateway/config-agents) - [الإعدادات — القنوات](/ar/gateway/config-channels) - [مرجع الإعدادات](/ar/gateway/configuration-reference) — مفاتيح المستوى الأعلى الأخرى - [الأدوات وPlugins](/ar/tools)