الانتقال إلى المحتوى الرئيسي
توفّر Moonshot واجهة Kimi API بنقاط نهاية متوافقة مع OpenAI. اضبط المزوّد وعيّن النموذج الافتراضي إلى moonshot/kimi-k2.6، أو استخدم Kimi Coding مع kimi/kimi-for-coding.
Moonshot وKimi Coding هما مزوّدان منفصلان. المفاتيح غير قابلة للتبادل، ونقاط النهاية مختلفة، ومراجع النماذج مختلفة (moonshot/... مقابل kimi/...).

​
كتالوج النماذج المضمّن

مرجع النموذجالاسمالاستدلالالإدخالالسياقأقصى مخرجات
moonshot/kimi-k2.6Kimi K2.6لانص، صورة262,144262,144
moonshot/kimi-k2.7-codeKimi K2.7 Codeمفعّل دائمًانص، صورة262,144262,144
moonshot/kimi-k2.5Kimi K2.5لانص، صورة262,144262,144
moonshot/kimi-k2-thinkingKimi K2 Thinkingنعمنص262,144262,144
moonshot/kimi-k2-thinking-turboKimi K2 Thinking Turboنعمنص262,144262,144
moonshot/kimi-k2-turboKimi K2 Turboلانص256,00016,384
تستخدم تقديرات تكلفة الكتالوج لنماذج K2 الحالية المستضافة لدى Moonshot أسعار الدفع حسب الاستخدام المنشورة من Moonshot: Kimi K2.7 Code بسعر 0.19/MTokعندإصابةذاكرةالتخزينالمؤقت،و0.19/MTok عند إصابة ذاكرة التخزين المؤقت، و0.95/MTok للإدخال، و4.00/MTokللإخراج؛KimiK2.6بسعر4.00/MTok للإخراج؛ Kimi K2.6 بسعر 0.16/MTok عند إصابة ذاكرة التخزين المؤقت، و0.95/MTokللإدخال،و0.95/MTok للإدخال، و4.00/MTok للإخراج؛ وKimi K2.5 بسعر 0.10/MTokعندإصابةذاكرةالتخزينالمؤقت،و0.10/MTok عند إصابة ذاكرة التخزين المؤقت، و0.60/MTok للإدخال، و$3.00/MTok للإخراج. تحتفظ إدخالات الكتالوج القديمة الأخرى بعناصر نائبة بتكلفة صفرية ما لم تتجاوزها في الإعدادات. يستخدم Kimi K2.7 Code التفكير الأصلي دائمًا. يعرض OpenClaw حالة التفكير on فقط لهذا النموذج، ويحذف عناصر التحكم الصادرة thinking و reasoning_effort، كما تتطلب Moonshot. ويحذف OpenClaw أيضًا تجاوزات أخذ العينات التي يثبّتها K2.7 على افتراضيات المزوّد. يظل Kimi K2.6 هو افتراضي الإعداد الأولي.

​
البدء

اختر مزوّدك واتبع خطوات الإعداد.
الأفضل لـ: نماذج Kimi K2 عبر Moonshot Open Platform.
1

اختر منطقة نقطة النهاية

خيار المصادقةنقطة النهايةالمنطقة
moonshot-api-keyhttps://api.moonshot.ai/v1دولية
moonshot-api-key-cnhttps://api.moonshot.cn/v1الصين
2

شغّل الإعداد الأولي

openclaw onboard --auth-choice moonshot-api-key
أو لنقطة نهاية الصين:
openclaw onboard --auth-choice moonshot-api-key-cn
3

عيّن نموذجًا افتراضيًا

{
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
    },
  },
}
4

تحقق من توفر النماذج

openclaw models list --provider moonshot
5

شغّل اختبار دخان مباشر

استخدم دليل حالة معزولًا عندما تريد التحقق من الوصول إلى النموذج وتتبع التكلفة دون لمس جلساتك العادية:
OPENCLAW_CONFIG_PATH=/tmp/openclaw-kimi/openclaw.json \
OPENCLAW_STATE_DIR=/tmp/openclaw-kimi \
openclaw agent --local \
  --session-id live-kimi-cost \
  --message 'Reply exactly: KIMI_LIVE_OK' \
  --thinking off \
  --json
يجب أن يبلّغ رد JSON عن provider: "moonshot" و model: "kimi-k2.6". يخزّن إدخال نص المساعد استخدام الرموز الموحّد مع التكلفة المقدّرة ضمن usage.cost عندما تعيد Moonshot بيانات تعريف الاستخدام.

​
مثال إعدادات

{
  env: { MOONSHOT_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.6" },
      models: {
        // moonshot-kimi-k2-aliases:start
        "moonshot/kimi-k2.6": { alias: "Kimi K2.6" },
        "moonshot/kimi-k2.7-code": { alias: "Kimi K2.7 Code" },
        "moonshot/kimi-k2.5": { alias: "Kimi K2.5" },
        "moonshot/kimi-k2-thinking": { alias: "Kimi K2 Thinking" },
        "moonshot/kimi-k2-thinking-turbo": { alias: "Kimi K2 Thinking Turbo" },
        "moonshot/kimi-k2-turbo": { alias: "Kimi K2 Turbo" },
        // moonshot-kimi-k2-aliases:end
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [
          // moonshot-kimi-k2-models:start
          {
            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,
          },
          {
            id: "kimi-k2.7-code",
            name: "Kimi K2.7 Code",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.95, output: 4, cacheRead: 0.19, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2.5",
            name: "Kimi K2.5",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0.6, output: 3, cacheRead: 0.1, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking",
            name: "Kimi K2 Thinking",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-thinking-turbo",
            name: "Kimi K2 Thinking Turbo",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            id: "kimi-k2-turbo",
            name: "Kimi K2 Turbo",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 256000,
            maxTokens: 16384,
          },
          // moonshot-kimi-k2-models:end
        ],
      },
    },
  },
}

​
بحث الويب في Kimi

يسجّل Plugin الخاص بـ Moonshot أيضًا Kimi كمزوّد web_search، مدعومًا ببحث الويب من Moonshot.
1

شغّل إعداد بحث الويب التفاعلي

openclaw configure --section web
اختر Kimi في قسم بحث الويب لتخزين plugins.entries.moonshot.config.webSearch.*.
2

اضبط منطقة بحث الويب والنموذج

يطلب الإعداد التفاعلي ما يلي:
الإعدادالخيارات
منطقة APIhttps://api.moonshot.ai/v1 (دولية) أو https://api.moonshot.cn/v1 (الصين)
نموذج بحث الويبيساوي افتراضيًا kimi-k2.6
توجد الإعدادات ضمن plugins.entries.moonshot.config.webSearch: 
{
  plugins: {
    entries: {
      moonshot: {
        config: {
          webSearch: {
            apiKey: "sk-...", // or use KIMI_API_KEY / MOONSHOT_API_KEY
            baseUrl: "https://api.moonshot.ai/v1",
            model: "kimi-k2.6",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "kimi",
      },
    },
  },
}

​
الإعدادات المتقدمة

يستخدم Kimi K2.7 Code التفكير الأصلي دائمًا. تتطلب Moonshot من العملاء حذف الحقل thinking لهذا النموذج، لذلك يعرض OpenClaw on فقط ويتجاهل إعدادات off القديمة. يثبّت K2.7 أيضًا temperature وtop_p وn وpresence_penalty وfrequency_penalty؛ ويحذف OpenClaw التجاوزات المضبوطة لهذه الحقول.تدعم نماذج Moonshot Kimi الأخرى التفكير الأصلي الثنائي:
  • thinking: { type: "enabled" }
  • thinking: { type: "disabled" }
اضبطه لكل نموذج عبر agents.defaults.models.<provider/model>.params:
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "disabled" },
          },
        },
      },
    },
  },
}
يربط OpenClaw مستويات /think وقت التشغيل لهذه النماذج:
مستوى /thinkسلوك Moonshot
/think offthinking.type=disabled
أي مستوى ليس offthinking.type=enabled
عند تفعيل تفكير Moonshot، يجب أن يكون tool_choice هو auto أو none. يوحّد OpenClaw القيم غير المتوافقة إلى auto. يشمل ذلك Kimi K2.7 Code، الذي لا يمكن تعطيل وضع التفكير فيه للحفاظ على اختيار أداة مثبّت.
يقبل Kimi K2.6 أيضًا حقل thinking.keep اختياريًا يتحكم في الاحتفاظ متعدد الأدوار بـ reasoning_content. اضبطه على "all" للاحتفاظ بسجل الاستدلال الكامل عبر الأدوار؛ أو احذفه (أو اتركه null) لاستخدام استراتيجية الخادم الافتراضية. يمرر OpenClaw الحقل thinking.keep فقط لـ moonshot/kimi-k2.6 ويزيله من النماذج الأخرى. يحافظ Kimi K2.7 Code على سجل الاستدلال الكامل افتراضيًا بينما يحذف OpenClaw حقل thinking بالكامل.
{
  agents: {
    defaults: {
      models: {
        "moonshot/kimi-k2.6": {
          params: {
            thinking: { type: "enabled", keep: "all" },
          },
        },
      },
    },
  },
}
يقدّم Moonshot Kimi معرّفات tool_call أصلية على شكل functions.<name>:<index>. بالنسبة إلى نقل إكمالات OpenAI، يحافظ OpenClaw على أول ظهور لكل معرّف Kimi أصلي ويعيد كتابة التكرارات اللاحقة إلى معرّفات call_* حتمية بأسلوب OpenAI. تُعاد مطابقة نتائج الأدوات بالمعرّف نفسه كي تظل إعادة التشغيل فريدة من دون إزالة أول معرّف Kimi أصلي.لفرض تنقية صارمة على مزود مخصص متوافق مع OpenAI، اضبط sanitizeToolCallIds: true:
{
  models: {
    providers: {
      "my-kimi-proxy": {
        api: "openai-completions",
        sanitizeToolCallIds: true,
      },
    },
  },
}
تعلن نقاط نهاية Moonshot الأصلية (https://api.moonshot.ai/v1 و https://api.moonshot.cn/v1) عن توافق استخدام البث على نقل openai-completions المشترك. يربط OpenClaw ذلك بقدرات نقطة النهاية، لذلك ترث معرّفات المزودين المخصصين المتوافقين التي تستهدف مضيفي Moonshot الأصليين أنفسهم سلوك استخدام البث نفسه.مع تسعير K2.6 في الفهرس، يُحوَّل الاستخدام المتدفق الذي يتضمن رموز الإدخال والإخراج وقراءة التخزين المؤقت أيضًا إلى تكلفة محلية تقديرية بالدولار الأمريكي من أجل /status و/usage full و/usage cost ومحاسبة الجلسات المدعومة بالنصوص.
المزودبادئة مرجع النموذجنقطة النهايةمتغير بيئة المصادقة
Moonshotmoonshot/https://api.moonshot.ai/v1MOONSHOT_API_KEY
Moonshot CNmoonshot/https://api.moonshot.cn/v1MOONSHOT_API_KEY
Kimi Codingkimi/نقطة نهاية Kimi CodingKIMI_API_KEY
بحث الويبغير متاحمماثلة لمنطقة Moonshot APIKIMI_API_KEY أو MOONSHOT_API_KEY
  • يستخدم بحث الويب في Kimi KIMI_API_KEY أو MOONSHOT_API_KEY، ويفترض افتراضيًا https://api.moonshot.ai/v1 مع النموذج kimi-k2.6.
  • تجاوز التسعير وبيانات سياق التعريف في models.providers إذا لزم الأمر.
  • إذا نشر Moonshot حدود سياق مختلفة لنموذج ما، فاضبط contextWindow وفقًا لذلك.

​
ذو صلة

اختيار النموذج

اختيار المزودين، ومراجع النماذج، وسلوك تجاوز الفشل.

بحث الويب

تكوين مزودي بحث الويب بما في ذلك Kimi.

مرجع التكوين

مخطط التكوين الكامل للمزودين والنماذج وplugins.

Moonshot Open Platform

إدارة مفتاح Moonshot API ووثائقه.