ربط Kimi: إضافتا Moonshot و Kimi Coding
OpenClaw ربط Kimi هو المحطة الرابعة في صفحة الطرازات المحلية. Kimi هي عائلة طرازات Moonshot AI، وهي حالة خاصة بعض الشيء في OpenClaw: فقد قسّمها المسؤول إلى إضافتين مستقلتين — Moonshot API و Kimi Coding، تُثبَّت كل إضافة على حدة، والمفاتيح غير قابلة للتبادل، وبادئات مراجع الطرازات مختلفة أيضًا. الخطوات الثلاث «تثبيت الإضافة ← ضبط بيانات الاعتماد ← اختيار الطراز» من دروس DeepSeek و Qwen و GLM تنطبق كلها في هذا الدرس، لكن عليك أولًا أن تجيب بشكل صحيح عن سؤال اختيار المسار. تستغرق العملية كلها نحو 10 دقيقة (دون احتساب التسجيل في المنصة).
إليك أولًا جدولًا إجماليًا تنطلق منه جميع إعدادات هذا الدرس (الخصائص والقيم منقولة كما هي من الوثائق الرسمية):
| المسار A: Moonshot API | المسار B: Kimi Coding | |
|---|---|---|
| لمن يصلح | مستخدمو API بالدفع حسب الاستخدام (pay-as-you-go) | أعضاء Kimi Code (باشتراك شهري لكتابة الأكواد) |
| الإضافة الرسمية | @openclaw/moonshot-provider | @openclaw/kimi-provider |
| معرّف المزوّد (Provider id) | moonshot | kimi |
| متغير بيئة المصادقة | MOONSHOT_API_KEY | KIMI_API_KEY |
| نقطة نهاية API | https://api.moonshot.ai/v1 (دولي) / https://api.moonshot.cn/v1 (المنطقة الصينية) | https://api.kimi.com/coding/ (متوافق مع Anthropic، تستخدم الإضافة Anthropic Messages) |
| بادئة مرجع الطراز | moonshot/... | kimi/... |
| الافتراضي في onboarding الجديد | moonshot/kimi-k3 | kimi/kimi-for-coding |
| مدخل إدارة المفاتيح | https://platform.moonshot.ai | https://www.kimi.com/code/console |
أمر يجب تذكّره أولًا (المقصود من التحذير الرسمي): ** Moonshot و Kimi Coding مزوّدان منفصلان وإضافتان خارجيتان منفصلتان — المفاتيح غير قابلة للتبادل، ونقاط النهاية مختلفة، ومراجع الطرازات مختلفة أيضًا** (moonshot/... مقابل kimi/...). إذا أدخلت مفتاح Moonshot في onboarding الخاص بـ Kimi Coding (أو العكس)، فلن تحصل إلا على فشل في المصادقة.
كيف تختار؟ في ثلاث جمل:
| حالتك | اختر هذا |
|---|---|
| تدفع حسب الاستخدام وتريد العائلة الكاملة K3 / K2.7 مع إدخال فيديو أيضًا | Moonshot API (جميع الطرازات الخمسة في الدليل تقبل text + image + video) |
| لديك اشتراك عضوية Kimi Code وتستخدمه أساسًا لكتابة الأكواد | Kimi Coding (استخدام kimi/kimi-for-coding وسلسلة kimi/k3 ضمن حصة الباقة) |
| تريد استخدام المسارين معًا | ثبّت الإضافتين واضبط لكل منهما مفتاحها — البادئات مختلفة ولا يلغي أحدهما الآخر |
💡 للقادمين عبر البحث عن «Kimi» أو «Moonshot»
Kimi هي عائلة طرازات Moonshot AI. ربطها عبر OpenClaw لا يتطلب حساب تطبيق محادثة Kimi، بل API Key: للدفع حسب الاستخدام عبر منصة Moonshot المفتوحة، وللاشتراك العضوي عبر لوحة تحكم Kimi Code — المفتاحان غير قابلين للتبادل، وهذا الدرس يشرح المسارين بوضوح.
يستند هذا الدرس إلى OpenClaw إصدار v2026.10.9.
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- التمييز بين مساري Moonshot API و Kimi Coding: إضافتان مستقلتان، ومفتاحان، ومجموعتان من بادئات الطرازات، دون خلط بينها
- تثبيت الإضافة المناسبة وضبط
MOONSHOT_API_KEYأوKIMI_API_KEYفي OpenClaw (عبر إرشادات onboarding أو الإعداد اليدوي — كلا الطريقين) - فهم دليلي الطرازات: عائلة
moonshot/kimi-k3وعائلتاkimi/kimi-for-codingوkimi/k3وموقع كل منها وسياقها وقيمها الافتراضية - عدم الذعر عند مواجهة الحصة الأسبوعية
HTTP 403في Kimi Coding: معرفة أن عليك انتظار إعادة تعيين النافذة بدلًا من تغيير المفتاح - استخدم قدرات Kimi الحصرية: تعيين مستويات
/think، وبحث Kimi على الويب (موفرweb_search)
🎒 التحضير قبل البدء
- أنجزت نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج: الخطوات الثلاث «تثبيت الإضافة → ضبط بيانات الاعتماد → اختيار النموذج» وقاعدة مرجع
provider/modelواضحة في ذهنك - OpenClaw مثبت وGateway يعمل:
openclaw gateway statusيعطي مخرجات (تسري الإضافة تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن يعمل فتسري عند الإقلاع التالي) - تعرف أن ما بحوزتك هو (أو سيكون) Key بالدفع حسب الاستخدام من منصة Moonshot المفتوحة، أم Key عضوية Kimi Code — فهذا يحدد المسار الذي ستسلكه
- إن كنت ستسلك نشر الخادم / daemon، فتعرف أين يقع
~/.openclaw/.env— فالـ Key سيسكن هناك في النهاية
اتبع خطواتي
الخطوة 1: تحديد المسار والحصول على API Key المقابل له
لماذا: يمثل Kimi في OpenClaw مسارين مستقلين، ويُستلم الـ Key من لوحتي تحكم مختلفتين ولا يتبادلان الاستخدام — حدد المسار أولًا ثم خذ الـ Key.
المسار A: واجهة Moonshot API (دفع حسب الاستخدام)
- افتح المتصفح على Moonshot Open Platform
https://platform.moonshot.ai، وسجل / سجّل الدخول - أنشئ Key واحدًا في صفحة إدارة API Key، وانسخه واحفظه في مكان آمن
- ملاحظة لمستخدمي الصين: تستخدم المنطقة الصينية
moonshot-api-key-cn(نقطة النهايةhttps://api.moonshot.cn/v1)، ويُدار الـ Key عبر منصة Moonshot المحلية — الوثائق الرسمية تعطي رابطًا مباشرًا للوحة تحكم الموقع الدولي فقط، ومدخل الموقع المحلي يكون بحسب موقع Moonshot الرسمي
المسار B: Kimi Coding (عضوية Kimi Code)
- افتح المتصفح على لوحة تحكم Kimi Code
https://www.kimi.com/code/console، وسجّل الدخول - أنشئ membership key واحدًا، وانسخه واحفظه في مكان آمن
- لم تشترك بعد؟ أسعار العضوية في
https://www.kimi.com/membership/pricing(الموقع الرسمي هو المرجع)
ينبغي أن ترى: API Key قابل للنسخ، مع علمك أي مسار ينتمي إليه — فإضافة الخطوة 2 وأوامرها يجب أن تتطابق معه.
الخطوة 2: ربط OpenClaw بـ Kimi — تثبيت الإضافة وتشغيل onboarding
لماذا: كلا من Moonshot وKimi Coding عبارة عنإضافات رسمية خارجية (لا تُضمَّن مع النواة)، وتتطلب خطوة «تثبيت» إضافية عن الإضافات المدمجة؛ ولكل مسار حزمة إضافة وauth-choice خاصة به، وإن خلطت بينهما لن يتطابق الـ Key.
المسار A: واجهة Moonshot API
# 1. 装插件
openclaw plugins install @openclaw/moonshot-provider
# 2. 跑 onboarding(二选一)
openclaw onboard --auth-choice moonshot-api-key # 国际站
openclaw onboard --auth-choice moonshot-api-key-cn # 中国区ينبغي أن ترى: نجاح التحقق من الـ Key وحفظه؛ ووقوع النموذج الافتراضي في onboarding الجديد على moonshot/kimi-k3.
تحقق من الدليل على سبيل الفائدة:
openclaw models list --provider moonshotينبغي أن ترى: عائلة نماذج kimi-k3 وkimi-k3.1-pro وkimi-k2.7-code مدرجة في القائمة.
المسار B: Kimi Coding
# 1. 装插件
openclaw plugins install @openclaw/kimi-provider
# 2. 跑 onboarding
openclaw onboard --auth-choice kimi-code-api-keyينبغي أن ترى: نجاح التحقق من الـ Key وحفظه؛ والنموذج الافتراضي هو kimi/kimi-for-coding.
تحقق من الدليل على سبيل الفائدة:
openclaw models list --provider kimiينبغي أن ترى: عائلة نماذج kimi-for-coding وk3 وk3-256k وk3.1-pro مدرجة في القائمة.
ثلاثة ضمانات مطمئنة مشتركة بين المسارين (مذكورة صراحة في الوثائق الرسمية):
- تثبيت الإضافةيسري تلقائيًا على Gateway قيد التشغيل؛ وإن لم يكن Gateway يعمل فسيسري عند الإقلاع التالي (يضيف README الخاص بـ kimi-provider الأمر
openclaw gateway restartفي مثال التثبيت، وكلا الطريقين صالح) - يحافظ onboarding على مدخلات النماذج الموجودة لديك— إعادة تشغيله لن تمسح إعدادات provider الأخرى
- إضافة بيانات اعتماد provider جديدلنتغير نموذجك الافتراضي الحالي — لتغيير الافتراضي، استخدم
openclaw models setمن الخطوة 3
الضبط اليدوي (إن لم ترغب في تشغيل onboarding)
الإضافات الرسمية أصلًالا تحتاج إلى كتابة مدخلات models.providers — ثبّت الإضافة، واضبط auth، واختر النموذج فقط؛ ولا تُكتب إلا عند الرغبة في تثبيت نقطة النهاية / النموذج الافتراضي صراحةً.
المسار A (واجهة Moonshot API، مثال رسمي كما هو):
{
env: { vars: { MOONSHOT_API_KEY: "sk-..." } },
agents: {
defaults: {
model: { primary: "moonshot/kimi-k3" },
models: {
"moonshot/kimi-k3": { alias: "Kimi K3" },
"moonshot/kimi-k2.7-code": { alias: "Kimi K2.7 Code" },
"moonshot/kimi-k2.7-code-highspeed": { alias: "Kimi K2.7 Code HighSpeed" },
},
},
},
}المسار B (Kimi Coding، مثال رسمي كما هو):
{
env: { vars: { KIMI_API_KEY: "sk-..." } },
agents: {
defaults: {
model: { primary: "kimi/kimi-for-coding" },
models: {
"kimi/kimi-for-coding": { alias: "Kimi" },
},
},
},
}أين يوضع الـ Key: في الصدفة التفاعلية export MOONSHOT_API_KEY="<你的 API Key>" (المسار B يستخدم KIMI_API_KEY)، أو يُكتب في ~/.openclaw/.env (نشر daemon يجب أن يمر من هنا، انظر التحذير أدناه). وتقبل قائمة الإضافات أيضًا KIMICODE_API_KEY كاسم متغير بديل لـ Kimi Coding.
⚠️ هل يعمل Gateway كـ daemon؟ لا تضع الـ Key في الصدفة التفاعلية
عندما يعمل Gateway كخدمة launchd / systemd، لا يرى متغيرات البيئة الناتجة عن export في طرفيتك. اكتب MOONSHOT_API_KEY / KIMI_API_KEY في ~/.openclaw/.env، أو زوّد ذلك عبر env.shellEnv في الإعدادات لتلك العملية.
- في نظرة عامة بيانات الاعتماد لـ
openclaw models status، يمكنك رؤية مصدر متغيرات البيئة لمسارك
الخطوة 3: اختيار نموذج Kimi والتحقق
لماذا: النموذجان الافتراضيان في المسارين كافيان (moonshot/kimi-k3 / kimi/kimi-for-coding)، لكن الدليلين يختلفان في التقسيم — جانب Moonshot هو «حزمة K3 الكاملة + K2.7 Code»، وجانب Kimi Coding هو «نماذج حصة العضوية + سلسلة K3»، فألق نظرة قبل أن تقرر.
أولًا انظر دليل Moonshot (كما في الوثائق الرسمية):
| مرجع النموذج | الاستدلال | الإدخال | السياق | أقصى مخرجات |
|---|---|---|---|---|
moonshot/kimi-k3 | low / high / max | نص، صور، فيديو | 1,048,576 | 1,048,576 |
moonshot/kimi-k3.1-pro | low / high / max | نص، صور، فيديو | 1,048,576 | 1,048,576 |
moonshot/kimi-k3.1-pro-highspeed | low / high / max | نص، صور، فيديو | 1,048,576 | 1,048,576 |
moonshot/kimi-k2.7-code | مفعّل دائمًا | نص، صور، فيديو | 262,144 | 262,144 |
moonshot/kimi-k2.7-code-highspeed | مفعّل دائمًا | نصوص وصور وفيديو | 262,144 | 262,144 |
الآن نلقي نظرة على دليل Kimi Coding (جدول الوثائق الرسمية + قائمة الإضافات):
| مرجع النموذج | الاستدلال | الإدخال | السياق | الحد الأقصى للإخراج | ملاحظات |
|---|---|---|---|---|---|
kimi/k3.1-pro | مفعّل دائمًا؛ low / high / max | نصوص وصور | 1,048,576 | 131,072 | لا يمكن إيقاف التفكير |
kimi/k3.1-pro-highspeed | مفعّل دائمًا؛ low / high / max | نصوص وصور | 1,048,576 | 131,072 | نسخة K3.1 Pro عالية السرعة |
kimi/k3 | adaptive؛ low / high / max | نصوص وصور | 1,048,576 | 131,072 | سياق 1M متاح حسب مستوى العضوية (tier-gated) |
kimi/k3-256k | adaptive؛ low / high / max | نصوص وصور | 262,144 | 131,072 | نفس الأوزان، نسخة باستهلاك حصة أقل |
kimi/kimi-for-coding | فقط /think on (low) | نصوص وصور | 262,144 | 32,768 | النموذج الافتراضي، يستهلك حصة الباقة |
kimi/kimi-for-coding-highspeed | فقط /think on (low) | نصوص وصور | 262,144 | 32,768 | نسخة عالية السرعة |
سلوك يجب معرفته مسبقًا بشأن الدليل: إعداد كلا المسارين يحفظ إعدادات الاتصال والأسماء المستعارة فقط، دون نسخ أسطر الدليل إلى إعداداتك؛ ولا تُكتب بذور الدليل إلا عند models.mode: "replace" الصريح، ولا تتأثر أسطر النماذج التي خصصتها بنفسك.
كيف تختار، في أربع جمل:
| احتياجك | اختره | الأساس |
|---|---|---|
| Moonshot بالاستهلاك، ومهام عامة تتطلب سياقًا طويلًا | moonshot/kimi-k3 | افتراضي onboarding، سياق 1M |
| Moonshot بالاستهلاك، وكتابة كود بأفضل قيمة مقابل السعر | moonshot/kimi-k2.7-code | $0.95 / $4 لكل M، أقل من K3 التي $3 / $15 |
| عضوية Kimi Code، كتابة كود يومية | kimi/kimi-for-coding | النموذج الافتراضي، لا يُحتسب بالتوكنات ضمن حصة الباقة |
| عضوية Kimi Code، وتريد استدلال K3 وسياقًا طويلًا | kimi/k3 (إن كانت الحصة ضيقة فـ kimi/k3-256k) | أوزان K3 + حصة العضوية |
تغيير النموذج الافتراضي:
openclaw models set moonshot/kimi-k3 # 路线 A
openclaw models set kimi/kimi-for-coding # 路线 Bيمكن أيضًا التبديل مؤقتًا داخل المحادثة: /model moonshot/kimi-k3.1-pro يؤثر على الجلسة الحالية فقط، وتفاصيل عائلة الأوامر في دليل سريع لأوامر المحادثة.
أخيرًا التحقق. يستخدم مسار Moonshot اختبار الدخان المعزول المقدم رسميًا (دون المساس بجلساتك اليومية):
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 max \
--jsonينبغي أن ترى: في استجابة JSON provider: "moonshot" وmodel: "kimi-k3"؛ وعندما يعيد Moonshot بيانات usage الوصفية، سيُخزَّن في المحفوظات أيضًا استهلاك التوكنات المُطبَّع والتكلفة المقدرة (usage.cost).
بالنسبة لمسار Kimi Coding، يكفي إرسال رسالة اختبار عادية:
openclaw agent --agent main --model kimi/kimi-for-coding --message "用一句话介绍你自己"(openclaw agent يتطلب تحديد مُحدد جلسة واحد على الأقل، و--agent main يشير إلى الـ agent الافتراضي — وهو main افتراضيًا في التثبيتات التي أكملت onboarding؛ أو استخدم openclaw dashboard لفتح Control UI وأرسل مباشرة في مربع المحادثة.)
ينبغي أن ترى: النموذج يرد بشكل طبيعي، دون أخطاء بشأن بيانات اعتماد مفقودة أو نموذج غير موجود. إلى هنا، يكون OpenClaw قد اتصل بـ Kimi بنجاح.
الأسعار في جملة واحدة، بحسب المسار:
- مسار Moonshot يُحتسب بالاستهلاك، مع تقديرات مدمجة في الدليل: K3 بسعر $3 إدخال / $15 إخراج / $0.30 قراءة ذاكرة التخزين المؤقت / $3 كتابة ذاكرة التخزين المؤقت (لكل مليون توكن)؛ وK2.7 Code بسعر $0.95 / $4 / $0.19 / 0؛ ونسخ highspeed مضاعفة
- مسار Kimi Coding يستهلك حصة باقة العضوية (cost في دليل
kimi-for-codingهو 0)؛ وتقديرات الدليل لسلسلة K3 وهي $3 / $15 / $0.30 / 0 تُستخدم لتقدير التكلفة فقط، كما أنالحد الأقصى الفعلي للسياق المفعّل للعضوية قد يكون أقل من المعلن في الدليل
قبل اتخاذ القرار، اعتمد على صفحة الأسعار الرسمية: أسعار Kimi K3، أسعار Kimi K2.7 Code، أسعار عضوية Kimi.
- وصل رد لرسالة الاختبار، والـ provider والنموذج متطابقان
نقطة تحقق ✅
- الإضافة المثبتة تتوافق مع الـ Key: Moonshot Key ←
@openclaw/moonshot-provider؛ Kimi Code Key ←@openclaw/kimi-provider - في نظرة عامة بيانات الاعتماد لـ
openclaw models status، يمكنك رؤية مصدر متغير البيئة المقابل (MOONSHOT_API_KEY/KIMI_API_KEY) openclaw models list --provider moonshot(أو--provider kimi) يعرض الدليل المقابل- النموذج الافتراضي يتوافق مع المسار:
moonshot/kimi-k3أوkimi/kimi-for-coding - وصل رد لرسالة الاختبار، ولم يُربط مرجع
moonshot/بإضافة kimi (أو العكس)
تنبيه من العثرات الشائعة
❌ الخلط بين مفتاحي Key
الأعراض: يُرفض مفتاح Key أثناء الإعداد (onboarding)، أو تظهر أخطاء مصادقة أثناء التشغيل.
السبب: التحذير الرسمي واضح تمامًا — Moonshot و Kimi Coding هما موفران منفصلان، فمفتاح Key غير قابل للتبادل بينهما، والنقاط (endpoints) مختلفة، ومراجع النماذج مختلفة. مفتاح Key بالاستخدام حسب الكمية من منصة Moonshot المفتوحة لا يعمل مع نقاط Kimi Coding، ومفتاح Key لعضوية Kimi Code لا يفتح مجلد moonshot/ أيضًا.
الإجراء الصحيح: ضع كلًا في مكانه المناسب —
| مفتاح Key الخاص بك | ثبّت هذه الإضافة | استخدم هذا auth-choice |
|---|---|---|
| منصة Moonshot المفتوحة (بالاستخدام حسب الكمية) | @openclaw/moonshot-provider | moonshot-api-key / moonshot-api-key-cn |
| لوحة تحكم Kimi Code (عضوية) | @openclaw/kimi-provider | kimi-code-api-key |
❌ يعرض Kimi Coding خطأ HTTP 403 فتظن أن مفتاح Key معطّل
السبب: يعيد Kimi خطأ HTTP 403 عند استنفاد الحصة الأسبوعية. يتعامل OpenClaw مع أخطاء weekly / seven-day / quota-reset الصريحة على أنها أخطاء تحديد المعدل — وهذه مشكلة حصة، وليست مشكلة مصادقة. ويذكّر README الرسمي أيضًا بشكل خاص: استبدال مفتاح Key صالح آخر لن يستعيد الحصة.
الإجراء الصحيح: انتظر إعادة تعيين نافذة الحصة، أو بدّل مؤقتًا إلى موفر آخر مُهيأ مسبقًا. أما أخطاء مفتاح Key غير الصالح أو الوصول المقيّد فتُعالج كأخطاء مصادقة — طريق «انتظار النافذة» يُسلك فقط عندما يكون الخطأ المتعلق بالحصة.
❌ /think off لا يُطفئ التفكير في سلسلة K3
السبب (حسب المسار):
- مسار Moonshot: تُجري نماذج K3 و K3.1 Pro و K3.1 Pro Highspeed الاستدلال دائمًا بأقصى شدة — OpenClaw يكشف فقط عن
/think maxويرسل دائمًاreasoning_effort: "max"، وتُتجاهل إعدادات الدرجات المنخفضة / off القديمة مباشرة؛ ونموذج K2.7 Code أيضًا يفكر تفكيرًا أصليًا دائمًا (يطلب Moonshot من العميل حذف حقلthinking، وOpenClaw يكشف فقط عن on) - مسار Kimi Coding: نموذجا
kimi/k3.1-proوkimi/k3.1-pro-highspeedلا يمكن إيقاف التفكير فيهما (يرفض Kimi Code خيار disabled thinking)، ولا يوفران off، والافتراضي high؛ بينماkimi/k3وkimi/k3-256kهما فقط ما يدعمان/think off(بإرسالthinking.type: "disabled")
الإجراء الصحيح: إذا احتجت نموذجًا يمكن إيقاف تفكيره، فاختر سلسلة kimi/k3 في مسار Kimi Coding. أما في مسار Moonshot فجميع النماذج الخمسة المدمجة في الدليل لا يمكن إيقاف تفكيرها (سلسلة K3 مثبتة على max، وسلسلة K2.7 مثبتة على on) — المثال القابل للإيقاف في الوثائق هو moonshot/kimi-k2.6 خارج الدليل (درجة تفكير ثانية، يتطلب ضبط params يدويًا، انظر القدرات الخاصة أدناه).
❌ بعد إيقاف التفكير في kimi/kimi-for-coding، تتسرب «نصوص الاستدلال الخام» إلى الردود
السبب: هذا سلوك الواجهة الخلفية لـ K2 — فعند تعطيل thinking، قد يتسرب الاستدلال الخام مباشرة إلى الرد المرئي. لذلك يكشف OpenClaw عن /think on فقط (درجة low) لـ kimi/kimi-for-coding (بما في ذلك صيغة highspeed) مع تمكينه افتراضيًا، وميزانية التفكير 1024 token؛ كما أن الإعدادات القديمة التي خزّنت تفضيل off ستُفسَّر إلى on، ولن تُفشل هذه الجلسة.
الإجراء الصحيح: لا تصارعه، وأبقِ on الافتراضي. التجاوز الصريح عبر params.thinking سيُحترم (بما في ذلك الإيقاف)، لكن الإيقاف قد يُظهر نصوص الاستدلال المتسربة.
❌ ما زلت تستخدم المراجع القديمة kimi/kimi-code و kimi/k2p5 و kimi/k3[1m]
السبب: هذه المراجع الثلاثة هي مراجع تاريخية قديمة، وستُطبّعها الإضافة تلقائيًا: kimi/kimi-code و kimi/k2p5 → kimi/kimi-for-coding؛ kimi/k3[1m] → kimi/k3 (إذ إن k3[1m] أُحيل إلى التقاعد في المشروع الأصلي).
الإجراء الصحيح: اكتب المرجع الجديد مباشرة في الإعدادات ولا تعتمد على التطبيع — kimi/kimi-for-coding أو kimi/k3.
❌ بعد تثبيت Gateway كعملية خفية (daemon)، يبدو أن مفتاح Key المُصدَّر بـ export «لا يسري»
السبب: خدمات launchd / systemd لا ترى متغيرات البيئة الخاصة بالصدفة التفاعلية (interactive shell) — وهو ما تؤكد عليه وثائق كل موفر مرارًا.
الإجراء الصحيح: اكتب MOONSHOT_API_KEY / KIMI_API_KEY في ~/.openclaw/.env، أو قدّمهما عبر env.shellEnv في الإعدادات؛ وأعد تشغيل خدمة Gateway بعد تغيير مفتاح Key.
🔧 قدرات Kimi الخاصة (اختيارية)
بعد تثبيت الإضافة، تأتي معها ثلاث قدرات خاصة بـ Kimi.
بحث Kimi على الويب: اجعل web_search يمر عبر Kimi
تسجّل إضافة Moonshot نموذج Kimi كموفر web_search (عبر POST /tools/search، ويعيد نتائج منظمة، ولا يحتاج إلى نموذج محادثة). لجعل Claw يستخدم Kimi عند البحث على الإنترنت:
openclaw configure --section webاختر Kimi في قسم web-search، وستُحفظ الإعدادات في 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",
},
},
},
}ثلاثة تفاصيل:
- المصادقة تعمل بـ
KIMI_API_KEYأوMOONSHOT_API_KEY؛ المنطقة الافتراضية هي الموقع الدولي (https://api.moonshot.ai/v1)، ويمكن ضبطها على منطقة الصين - قيمة
model: "kimi-k2.6"في المثال مُهملة ومتجاهَلة — البحث لا يعتمد على نموذج المحادثة، وإبقاؤها غير ضار، وحذفها أنظف - هذه القدرة يسجّلها موفر Moonshot — فمن يستخدم Kimi Coding فقط ويريد البحث على الويب، يجب أن تكون
@openclaw/moonshot-providerمثبتة أيضًا
لاستخدام web_search مع أدوات الويب الأخرى، انظر التحكم في المتصفح: اجعل Claw يتصرف على الإنترنت نيابة عنك.
مرجع سريع لخريطة درجات /think
| المسار | النموذج | سلوك /think |
|---|---|---|
| Moonshot | K3 / K3.1 Pro / Highspeed | يكشف فقط عن /think max، مثبت على reasoning_effort: "max" |
| Moonshot | K2.7 Code (بما في ذلك Highspeed) | يكشف فقط عن on؛ يجب حذف حقل thinking، ومعاملات أخذ العينات (temperature و top_p وغيرها) مثبتة بواسطة K2.7، وتُتجاهل التجاوزات المضبوطة |
| Kimi Coding | k3 / k3-256k | off يرسل thinking.type: "disabled"؛ minimal / low → low؛ medium / high / adaptive → high؛ xhigh / max → max (تفكير تكيفي، الافتراضي high) |
| Kimi Coding | k3.1-pro / k3.1-pro-highspeed | لا يمكن ضبطه على off، والافتراضي هو high؛ أما بقية المستويات فتُطبَّق عليها المطابقة المذكورة أعلاه |
| Kimi Coding | kimi-for-coding (يشمل highspeed) | يُعرِّض فقط /think on (low) وهو مفعَّل افتراضيًا؛ إيقافه سيؤدي إلى تسريب نص الاستدلال (انظر تنبيه المزالق) |
التخزين المؤقت، تقدير التكلفة وتفاصيل التوافق
- التخزين المؤقت للبادئة: يقوم Moonshot تلقائيًا بتخزين بادئة الـ prompt المطابقة مؤقتًا؛ بينما يستخدم K3 افتراضيًا تخزينًا مؤقتًا مدته خمس دقائق، ويتم قياس cache write و cache read بشكل منفصل (المرجع الرسمي: Kimi context caching)
- تقدير التكلفة: يتم تمرير أسعار الكتالوج إلى
/statusو/usage costومحاسبة الجلسات؛ ونقاط النهاية الأصلية لـ Moonshot (.ai/.cn) تدعم الـ usage المتدفق، ويتم التعرف عليها عبر مضيف نقطة النهاية — وإذا أشار معرِّف provider مخصص إلى نفس المضيف فسيسري ذلك أيضًا - توافق مخطط الأدوات (tool schema): تُضيف مسارات Moonshot المتوافقة مع OpenAI الحقل
typeالمفقود لفروعanyOf/oneOfالتي يمكن استنتاج نوع واحد منها، مما يمنع رفض مخططات MCP الشائعة - تنظيف معرِّف tool_call: يأخذ معرِّف استدعاء الأدوات الأصلي لدى Kimi الشكل
functions.<name>:<index>، ويحتفظ OpenClaw بأول ظهور لكل معرِّف أصلي، ثم يُعيد كتابة التكرارات اللاحقة بأسلوب OpenAIcall_*، بحيث يظل التشغيل التفريغي (replay) فريدًا
::: تفاصيل متقدمة: تهيئة مستويين من thinking لنماذج Kimi خارج الكتالوج مثال من التوثيق (كما هو) — بالنسبة للنماذج مثل moonshot/kimi-k2.6 التي تدعم التفكير بمستويين enabled / disabled، يتم تهيئة params لكل نموذج:
{
agents: {
defaults: {
models: {
"moonshot/kimi-k2.6": {
params: {
thinking: { type: "disabled" },
},
},
},
},
},
}/think off → thinking.type=disabled، وأي مستوى آخر → thinking.type=enabled. كما يقبل K2.6 الحقل الاختياري thinking.keep: "all" (الاحتفاظ بـ reasoning_content الكامل عبر الجولات). ملاحظة: عند تفعيل التفكير في K2 لا يمكن لـ tool_choice أن يكون إلا auto / none — تثبيت الأدوات سيفرض إعادة التفكير قسرًا إلى disabled، وسيتم توحيد required إلى auto. :::
الخطوة التالية
OpenClaw بهذا تكون قد أكملت ربط Kimi. تابع في صفحات النماذج المحلية:
- الدرس التالي ربط MiniMax: سلسلة M3 و Coding Plan: الـ OAuth المزدوج لـ MiniMax مع Coding Plan الرسمي
- صفحات النماذج الأخرى (Doubao، Hunyuan / Qianfan، النماذج الوسيطة والمحلية) تبدأ من جدول الدروس في نظرة عامة على ربط النماذج
- هل اكتملت تهيئة النموذج؟ الاستخدام اليومي يبدأ من الاستخدام اليومي: التعامل بكفاءة مع Claw الخاص بك — واجهة Control UI، وأوامر الدردشة، ونظام الذاكرة كلها في ذلك الفصل