Providers

Moonshot AI

توفّر Moonshot واجهة Kimi API مع نقاط نهاية متوافقة مع OpenAI. اضبط الموفّر وعيّن النموذج الافتراضي إلى moonshot/kimi-k2.6، أو استخدم Kimi Coding مع kimi/kimi-code.

كتالوج النماذج المدمج

مرجع النموذج الاسم الاستدلال الإدخال السياق الحد الأقصى للإخراج
moonshot/kimi-k2.6 Kimi K2.6 لا text, image 262,144 262,144
moonshot/kimi-k2.5 Kimi K2.5 لا text, image 262,144 262,144
moonshot/kimi-k2-thinking Kimi K2 Thinking نعم text 262,144 262,144
moonshot/kimi-k2-thinking-turbo Kimi K2 Thinking Turbo نعم text 262,144 262,144
moonshot/kimi-k2-turbo Kimi K2 Turbo لا text 256,000 16,384

تستخدم تقديرات التكلفة المجمّعة لنماذج K2 الحالية المستضافة على Moonshot أسعار الدفع حسب الاستخدام المنشورة من Moonshot: تبلغ تكلفة Kimi K2.6 ‏$0.16/MTok لقراءة cache، و$0.95/MTok للإدخال، و$4.00/MTok للإخراج؛ وتبلغ تكلفة Kimi K2.5 ‏$0.10/MTok لقراءة cache، و$0.60/MTok للإدخال، و$3.00/MTok للإخراج. أما إدخالات الكتالوج القديمة الأخرى فتبقي عناصر تكلفة صفرية افتراضية ما لم تستبدلها في الإعدادات.

البدء

اختر الموفّر واتبع خطوات الإعداد.

Moonshot API

الأفضل لـ: نماذج Kimi K2 عبر Moonshot Open Platform.

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

    خيار المصادقة نقطة النهاية المنطقة
    moonshot-api-key https://api.moonshot.ai/v1 دولي
    moonshot-api-key-cn https://api.moonshot.cn/v1 الصين
  • شغّل الإعداد الأولي

    openclaw onboard --auth-choice moonshot-api-key
    

    أو لنقطة النهاية الخاصة بالصين:

    openclaw onboard --auth-choice moonshot-api-key-cn
    
  • عيّن نموذجًا افتراضيًا

    {
      agents: {
        defaults: {
          model: { primary: "moonshot/kimi-k2.6" },
        },
      },
    }
    
  • تحقق من أن النماذج متاحة

    openclaw models list --provider moonshot
    
  • شغّل اختبار smoke حي

    استخدم دليل حالة معزولًا عندما تريد التحقق من الوصول إلى النموذج وتتبع التكلفة من دون المساس بجلساتك العادية:

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

    الأفضل لـ: المهام المركّزة على البرمجة عبر نقطة نهاية Kimi Coding.

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

    openclaw onboard --auth-choice kimi-code-api-key
    
  • عيّن نموذجًا افتراضيًا

    {
      agents: {
        defaults: {
          model: { primary: "kimi/kimi-code" },
        },
      },
    }
    
  • تحقق من أن النموذج متاح

    openclaw models list --provider kimi
    
  • مثال على الإعدادات

    {
      env: { KIMI_API_KEY: "sk-..." },
      agents: {
        defaults: {
          model: { primary: "kimi/kimi-code" },
          models: {
            "kimi/kimi-code": { alias: "Kimi" },
          },
        },
      },
    }
    

    البحث على الويب في Kimi

    يشحن OpenClaw أيضًا Kimi كموفّر web_search، ومدعومًا ببحث Moonshot على الويب.

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

    openclaw configure --section web
    

    اختر Kimi في قسم البحث على الويب لتخزين plugins.entries.moonshot.config.webSearch.*.

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

    يطلب الإعداد التفاعلي ما يلي:

    الإعداد الخيارات
    منطقة API https://api.moonshot.ai/v1 (دولي) أو https://api.moonshot.cn/v1 (الصين)
    نموذج البحث على الويب الافتراضي هو kimi-k2.6
  • توجد الإعدادات تحت plugins.entries.moonshot.config.webSearch:

    {
      plugins: {
        entries: {
          moonshot: {
            config: {
              webSearch: {
                apiKey: "sk-...", // أو استخدم KIMI_API_KEY / MOONSHOT_API_KEY
                baseUrl: "https://api.moonshot.ai/v1",
                model: "kimi-k2.6",
              },
            },
          },
        },
      },
      tools: {
        web: {
          search: {
            provider: "kimi",
          },
        },
      },
    }
    

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

    وضع Thinking الأصلي

    يدعم Moonshot Kimi وضع Thinking الأصلي الثنائي:

    • 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 وقت التشغيل لـ Moonshot:

    مستوى /think سلوك Moonshot
    /think off thinking.type=disabled
    أي مستوى غير off thinking.type=enabled

    يقبل Kimi K2.6 أيضًا الحقل الاختياري thinking.keep الذي يتحكم في الاحتفاظ متعدد الأدوار بـ reasoning_content. اضبطه إلى "all" للاحتفاظ بجميع الاستدلالات عبر الأدوار؛ أو احذفه (أو اتركه null) لاستخدام استراتيجية الخادم الافتراضية. لا يمرّر OpenClaw الحقل thinking.keep إلا إلى moonshot/kimi-k2.6 ويزيله من النماذج الأخرى.

    {
      agents: {
        defaults: {
          models: {
            "moonshot/kimi-k2.6": {
              params: {
                thinking: { type: "enabled", keep: "all" },
              },
            },
          },
        },
      },
    }
    
    تنقية معرّف استدعاء الأداة

    يقدّم Moonshot Kimi معرّفات tool_call بالشكل functions.<name>:<index>. يحافظ OpenClaw عليها كما هي بحيث يظل استخدام الأدوات متعدد الأدوار يعمل.

    لفرض تنقية صارمة على معرّفات استدعاء الأدوات لموفّر مخصص متوافق مع 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 المجمّع، يُحوَّل الاستخدام المبثوث الذي يتضمن رموز الإدخال والإخراج وقراءة cache أيضًا إلى تكلفة محلية تقديرية بالدولار الأمريكي من أجل /status و/usage full و/usage cost، ومحاسبة الجلسات المعتمدة على السجل.

    مرجع نقطة النهاية ومرجع النموذج
    الموفّر بادئة مرجع النموذج نقطة النهاية متغير بيئة المصادقة
    Moonshot moonshot/ https://api.moonshot.ai/v1 MOONSHOT_API_KEY
    Moonshot CN moonshot/ https://api.moonshot.cn/v1 MOONSHOT_API_KEY
    Kimi Coding kimi/ نقطة نهاية Kimi Coding KIMI_API_KEY
    البحث على الويب N/A نفس منطقة Moonshot API KIMI_API_KEY أو MOONSHOT_API_KEY
    • يستخدم بحث Kimi على الويب KIMI_API_KEY أو MOONSHOT_API_KEY، ويكون افتراضيًا على https://api.moonshot.ai/v1 مع النموذج kimi-k2.6.
    • استبدل بيانات التسعير وبيانات السياق الوصفية في models.providers عند الحاجة.
    • إذا نشرت Moonshot حدود سياق مختلفة لنموذج ما، فعدّل contextWindow وفقًا لذلك.

    ذو صلة