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وفقًا لذلك.