الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

توفر 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.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.6 مقدار 0.16/MTokعندإصابةذاكرةالتخزينالمؤقت،و0.16/MTok عند إصابة ذاكرة التخزين المؤقت، و0.95/MTok للإدخال، و4.00/MTokللإخراج؛ويبلغسعرKimiK2.5مقدار4.00/MTok للإخراج؛ ويبلغ سعر Kimi K2.5 مقدار 0.10/MTok عند إصابة ذاكرة التخزين المؤقت، و0.60/MTokللإدخال،و0.60/MTok للإدخال، و3.00/MTok للإخراج. تحتفظ إدخالات الكتالوج القديمة الأخرى بعناصر تكلفة صفرية نائبة ما لم تتجاوزها في الإعدادات.

​
بدء الاستخدام

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

Choose your endpoint region

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

Run onboarding

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

Set a default model

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

Verify models are available

openclaw models list --provider moonshot
5

Run a live smoke test

استخدم دليل حالة معزولًا عندما تريد التحقق من الوصول إلى النموذج وتتبع التكلفة دون لمس جلساتك العادية:
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 على الويب

يشحن OpenClaw أيضًا 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",
      },
    },
  },
}

​
التكوين المتقدم

يدعم 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 وقت التشغيل لـ Moonshot:
مستوى /thinkسلوك Moonshot
/think offthinking.type=disabled
أي مستوى غير offthinking.type=enabled
عند تمكين التفكير في Moonshot، يجب أن يكون tool_choice هو auto أو none. يطبّع OpenClaw قيم tool_choice غير المتوافقة إلى auto من أجل التوافق.
يقبل 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 المضمّن، يُحوَّل الاستخدام المتدفق الذي يتضمن رموز الإدخال والإخراج ورموز قراءة ذاكرة التخزين المؤقت أيضًا إلى تكلفة محلية تقديرية بالدولار الأمريكي من أجل /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 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 وفقًا لذلك.

​
ذو صلة

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

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

بحث الويب

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

مرجع التكوين

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

Moonshot Open Platform

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