التكوين — الأدوات والمزوّدون المخصّصون

tools.* مفاتيح إعداد وإعداد المزوّد المخصّص / عنوان URL الأساسي. بالنسبة إلى الوكلاء والقنوات ومفاتيح الإعداد الأخرى ذات المستوى الأعلى، راجع مرجع الإعداد.

الأدوات

ملفات تعريف الأدوات

يضبط 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 متوقفًا.

{
  tools: { deny: ["browser", "canvas"] },
}

write وapply_patch معرّفا أداتين منفصلان. يفعّل allow: ["write"] أيضًا apply_patch للنماذج المتوافقة، لكن deny: ["write"] لا يرفض apply_patch. لحظر كل تعديل للملفات، ارفض group:fs أو اذكر كل أداة مُعدِّلة صراحةً:

{
  tools: { deny: ["write", "edit", "apply_patch"] },
}

`tools.byProvider`

يقيّد الأدوات أكثر لمزوّدين أو نماذج محددة. الترتيب: ملف التعريف الأساسي ← ملف تعريف المزوّد ← السماح/الرفض.

{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
      "openai/gpt-5.4": { allow: ["group:fs", "sessions_list"] },
    },
  },
}

`tools.toolsBySender`

يقيّد الأدوات لهوية طالب محددة. هذا دفاع متعدد الطبقات فوق التحكم في وصول القناة؛ يجب أن تأتي قيم المرسل من محوّل القناة، لا من نص الرسالة.

{
  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:<channelId>:<senderId> أو id:<senderId> أو e164:<phone> أو username:<handle> أو name:<displayName> أو "*". معرّفات القنوات هي معرّفات OpenClaw القياسية؛ تُطبَّع الأسماء البديلة مثل teams إلى msteams. تُقبل المفاتيح القديمة بلا بادئة كـ id: فقط. ترتيب المطابقة هو القناة+المعرّف، ثم المعرّف، ثم e164، ثم اسم المستخدم، ثم الاسم، ثم حرف البدل. يتجاوز agents.list[].tools.toolsBySender الخاص بكل وكيل مطابقة المرسل العامة عند مطابقته، حتى مع سياسة فارغة {}.

`tools.elevated`

يتحكم في وصول exec المرتفع خارج صندوق العزل:

{
  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`

{
  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.

{
  tools: {
    loopDetection: {
      enabled: true,
      historySize: 30,
      warningThreshold: 10,
      criticalThreshold: 20,
      globalCircuitBreakerThreshold: 30,
      detectors: {
        genericRepeat: true,
        knownPollNoProgress: true,
        pingPong: true,
      },
    },
  },
}

historySize

number

الحد الأقصى لسجل استدعاءات الأدوات المحتفَظ به لتحليل الحلقات.

warningThreshold

number

عتبة نمط التكرار بلا تقدم للتحذيرات.

criticalThreshold

number

عتبة تكرار أعلى لحظر الحلقات الحرجة.

globalCircuitBreakerThreshold

number

عتبة إيقاف صارمة لأي تشغيل بلا تقدم.

detectors.genericRepeat

boolean

التحذير عند تكرار استدعاءات الأداة نفسها/الوسائط نفسها.

detectors.knownPollNoProgress

boolean

التحذير/الحظر عند أدوات الاستطلاع المعروفة (process.poll، command_status، إلخ).

detectors.pingPong

boolean

التحذير/الحظر عند أنماط الأزواج المتناوبة بلا تقدم.

إذا كان warningThreshold >= criticalThreshold أو criticalThreshold >= globalCircuitBreakerThreshold، يفشل التحقق.

`tools.web`

{
  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`

يضبط فهم الوسائط الواردة (الصور/الصوت/الفيديو):

{
  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" }],
      },
    },
  },
}

Media model entry fields

إدخال المزوّد (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`

{
  tools: {
    agentToAgent: {
      enabled: false,
      allow: ["home", "work"],
    },
  },
}

`tools.sessions`

يتحكم في الجلسات التي يمكن استهدافها بواسطة أدوات الجلسات (sessions_list، sessions_history، sessions_send). الافتراضي: tree (الجلسة الحالية + الجلسات التي أنشأتها، مثل الوكلاء الفرعيين).

{
  tools: {
    sessions: {
      // "self" | "tree" | "agent" | "all"
      visibility: "tree",
    },
  },
}

Visibility scopes

self: مفتاح الجلسة الحالية فقط.
tree: الجلسة الحالية + الجلسات التي أنشأتها الجلسة الحالية (الوكلاء الفرعيون).
agent: أي جلسة تنتمي إلى معرّف الوكيل الحالي (يمكن أن تشمل مستخدمين آخرين إذا شغّلت جلسات لكل مرسل تحت معرّف الوكيل نفسه).
all: أي جلسة. لا يزال الاستهداف عبر الوكلاء يتطلب tools.agentToAgent.
تقييد صندوق العزل: عندما تكون الجلسة الحالية معزولة ويكون agents.defaults.sandbox.sessionToolsVisibility="spawned"، تُفرض الرؤية على tree حتى إذا كان tools.sessions.visibility="all".

`tools.sessions_spawn`

يتحكم في دعم المرفقات المضمنة لـ sessions_spawn.

{
  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"
      },
    },
  },
}

Attachment notes

لا تُدعم المرفقات إلا مع runtime: "subagent". يرفضها وقت تشغيل ACP.
تُحوَّل الملفات إلى ملفات فعلية داخل مساحة عمل الابن في .openclaw/attachments/<uuid>/ مع ملف .manifest.json.
يُحجب محتوى المرفقات تلقائيًا من استمرارية النصوص المنسوخة.
تُتحقق مُدخلات Base64 بفحوصات صارمة للأبجدية/الحشو وحارس حجم قبل فك الترميز.
أذونات الملفات هي 0700 للأدلة و0600 للملفات.
يتبع التنظيف سياسة cleanup: يزيل delete المرفقات دائمًا؛ ويُبقيها keep فقط عند ضبط retainOnSessionKeep: true.

`tools.experimental`

أعلام الأدوات المضمّنة التجريبية. تكون متوقفة افتراضيًا ما لم تنطبق قاعدة تفعيل تلقائي صارمة-وكيلية لـ GPT-5.

{
  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`

{
  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/<agentId>/agent/models.json.

{
  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,
          },
        ],
      },
    },
  },
}

Auth and merge precedence

استخدم 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 بالكامل.
- استمرارية العلامات موثوقة المصدر: تُكتب العلامات من لقطة إعدادات المصدر النشطة (قبل الحل)، وليس من قيم أسرار وقت التشغيل المحلولة.

تفاصيل حقول المزوّد

Top-level catalog

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.

Provider connection and auth

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: ترويسات ثابتة إضافية لتوجيه الوكيل/المستأجر.

Request transport overrides

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.

Model catalog entries

Amazon Bedrock discovery

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 لفرض بيانات وصفية نصية فقط.

أمثلة المزوّدين

Cerebras (GLM 4.7 / GPT OSS)

يمكن لـPlugin المزوّد المضمّن cerebras تهيئة ذلك عبر openclaw onboard --auth-choice cerebras-api-key. استخدم إعدادات المزوّد الصريحة فقط عند تجاوز القيم الافتراضية.

{
  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 المباشر.

Kimi Coding

{
  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.

Local models (LM Studio)

راجع النماذج المحلية. باختصار: شغّل نموذجًا محليًا كبيرًا عبر LM Studio Responses API على عتاد جاد؛ وأبقِ النماذج المستضافة مدمجة للاستخدام كبديل احتياطي.

MiniMax M2.7 (direct)

{
  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.

Moonshot AI (Kimi)

{
  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 ذلك بقدرات نقطة النهاية بدلًا من معرّف المزوّد المدمج وحده.

OpenCode

{
  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.

Synthetic (Anthropic-compatible)

{
  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.

Z.AI (GLM-4.7)

{
  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 الأساسي.

ذو صلة

الإعدادات — الوكلاء
الإعدادات — القنوات
مرجع الإعدادات — مفاتيح المستوى الأعلى الأخرى
الأدوات وPlugins

Documentation Index

​الأدوات

​ملفات تعريف الأدوات

​مجموعات الأدوات

​tools.allow / tools.deny

​tools.byProvider

​tools.toolsBySender

​tools.elevated

​tools.exec

​tools.loopDetection

​tools.web

​tools.media

​tools.agentToAgent

​tools.sessions

​tools.sessions_spawn

​tools.experimental

​agents.defaults.subagents

​المزوّدون المخصصون وعناوين URL الأساسية

​تفاصيل حقول المزوّد

​أمثلة المزوّدين

​ذو صلة

الأدوات

ملفات تعريف الأدوات

مجموعات الأدوات

`tools.allow` / `tools.deny`

`tools.byProvider`

`tools.toolsBySender`

`tools.elevated`

`tools.exec`

`tools.loopDetection`

`tools.web`

`tools.media`

`tools.agentToAgent`

`tools.sessions`

`tools.sessions_spawn`

`tools.experimental`

`agents.defaults.subagents`

المزوّدون المخصصون وعناوين URL الأساسية

تفاصيل حقول المزوّد

أمثلة المزوّدين

ذو صلة