Skip to content

ربط 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)moonshotkimi
متغير بيئة المصادقةMOONSHOT_API_KEYKIMI_API_KEY
نقطة نهاية APIhttps://api.moonshot.ai/v1 (دولي) / https://api.moonshot.cn/v1 (المنطقة الصينية)https://api.kimi.com/coding/ (متوافق مع Anthropic، تستخدم الإضافة Anthropic Messages)
بادئة مرجع الطرازmoonshot/...kimi/...
الافتراضي في onboarding الجديدmoonshot/kimi-k3kimi/kimi-for-coding
مدخل إدارة المفاتيحhttps://platform.moonshot.aihttps://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 (دفع حسب الاستخدام) ​

  1. افتح المتصفح على Moonshot Open Platform https://platform.moonshot.ai، وسجل / سجّل الدخول
  2. أنشئ Key واحدًا في صفحة إدارة API Key، وانسخه واحفظه في مكان آمن
  3. ملاحظة لمستخدمي الصين: تستخدم المنطقة الصينية moonshot-api-key-cn (نقطة النهاية https://api.moonshot.cn/v1)، ويُدار الـ Key عبر منصة Moonshot المحلية — الوثائق الرسمية تعطي رابطًا مباشرًا للوحة تحكم الموقع الدولي فقط، ومدخل الموقع المحلي يكون بحسب موقع Moonshot الرسمي

المسار B: Kimi Coding (عضوية Kimi Code) ​

  1. افتح المتصفح على لوحة تحكم Kimi Code https://www.kimi.com/code/console، وسجّل الدخول
  2. أنشئ membership key واحدًا، وانسخه واحفظه في مكان آمن
  3. لم تشترك بعد؟ أسعار العضوية في https://www.kimi.com/membership/pricing (الموقع الرسمي هو المرجع)

ينبغي أن ترى: API Key قابل للنسخ، مع علمك أي مسار ينتمي إليه — فإضافة الخطوة 2 وأوامرها يجب أن تتطابق معه.

الخطوة 2: ربط OpenClaw بـ Kimi — تثبيت الإضافة وتشغيل onboarding ​

لماذا: كلا من Moonshot وKimi Coding عبارة عنإضافات رسمية خارجية (لا تُضمَّن مع النواة)، وتتطلب خطوة «تثبيت» إضافية عن الإضافات المدمجة؛ ولكل مسار حزمة إضافة وauth-choice خاصة به، وإن خلطت بينهما لن يتطابق الـ Key.

المسار A: واجهة Moonshot API ​

bash
# 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.

تحقق من الدليل على سبيل الفائدة:

bash
openclaw models list --provider moonshot

ينبغي أن ترى: عائلة نماذج kimi-k3 وkimi-k3.1-pro وkimi-k2.7-code مدرجة في القائمة.

المسار B: Kimi Coding ​

bash
# 1. 装插件
openclaw plugins install @openclaw/kimi-provider

# 2. 跑 onboarding
openclaw onboard --auth-choice kimi-code-api-key

ينبغي أن ترى: نجاح التحقق من الـ Key وحفظه؛ والنموذج الافتراضي هو kimi/kimi-for-coding.

تحقق من الدليل على سبيل الفائدة:

bash
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، مثال رسمي كما هو):

json5
{
  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، مثال رسمي كما هو):

json5
{
  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-k3low / high / maxنص، صور، فيديو1,048,5761,048,576
moonshot/kimi-k3.1-prolow / high / maxنص، صور، فيديو1,048,5761,048,576
moonshot/kimi-k3.1-pro-highspeedlow / high / maxنص، صور، فيديو1,048,5761,048,576
moonshot/kimi-k2.7-codeمفعّل دائمًانص، صور، فيديو262,144262,144
moonshot/kimi-k2.7-code-highspeedمفعّل دائمًانصوص وصور وفيديو262,144262,144

الآن نلقي نظرة على دليل Kimi Coding (جدول الوثائق الرسمية + قائمة الإضافات):

مرجع النموذجالاستدلالالإدخالالسياقالحد الأقصى للإخراجملاحظات
kimi/k3.1-proمفعّل دائمًا؛ low / high / maxنصوص وصور1,048,576131,072لا يمكن إيقاف التفكير
kimi/k3.1-pro-highspeedمفعّل دائمًا؛ low / high / maxنصوص وصور1,048,576131,072نسخة K3.1 Pro عالية السرعة
kimi/k3adaptive؛ low / high / maxنصوص وصور1,048,576131,072سياق 1M متاح حسب مستوى العضوية (tier-gated)
kimi/k3-256kadaptive؛ low / high / maxنصوص وصور262,144131,072نفس الأوزان، نسخة باستهلاك حصة أقل
kimi/kimi-for-codingفقط /think on (low)نصوص وصور262,14432,768النموذج الافتراضي، يستهلك حصة الباقة
kimi/kimi-for-coding-highspeedفقط /think on (low)نصوص وصور262,14432,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 + حصة العضوية

تغيير النموذج الافتراضي:

bash
openclaw models set moonshot/kimi-k3      # 路线 A
openclaw models set kimi/kimi-for-coding  # 路线 B

يمكن أيضًا التبديل مؤقتًا داخل المحادثة: /model moonshot/kimi-k3.1-pro يؤثر على الجلسة الحالية فقط، وتفاصيل عائلة الأوامر في دليل سريع لأوامر المحادثة.

أخيرًا التحقق. يستخدم مسار Moonshot اختبار الدخان المعزول المقدم رسميًا (دون المساس بجلساتك اليومية):

bash
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، يكفي إرسال رسالة اختبار عادية:

bash
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-providermoonshot-api-key / moonshot-api-key-cn
لوحة تحكم Kimi Code (عضوية)@openclaw/kimi-providerkimi-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 عند البحث على الإنترنت:

bash
openclaw configure --section web

اختر Kimi في قسم web-search، وستُحفظ الإعدادات في plugins.entries.moonshot.config.webSearch.* (المثال الرسمي، كما هو):

json5
{
  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
MoonshotK3 / K3.1 Pro / Highspeedيكشف فقط عن /think max، مثبت على reasoning_effort: "max"
MoonshotK2.7 Code (بما في ذلك Highspeed)يكشف فقط عن on؛ يجب حذف حقل thinking، ومعاملات أخذ العينات (temperature و top_p وغيرها) مثبتة بواسطة K2.7، وتُتجاهل التجاوزات المضبوطة
Kimi Codingk3 / k3-256koff يرسل thinking.type: "disabled"؛ minimal / low → low؛ medium / high / adaptive → high؛ xhigh / max → max (تفكير تكيفي، الافتراضي high)
Kimi Codingk3.1-pro / k3.1-pro-highspeedلا يمكن ضبطه على off، والافتراضي هو high؛ أما بقية المستويات فتُطبَّق عليها المطابقة المذكورة أعلاه
Kimi Codingkimi-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 بأول ظهور لكل معرِّف أصلي، ثم يُعيد كتابة التكرارات اللاحقة بأسلوب OpenAI call_*، بحيث يظل التشغيل التفريغي (replay) فريدًا

::: تفاصيل متقدمة: تهيئة مستويين من thinking لنماذج Kimi خارج الكتالوج مثال من التوثيق (كما هو) — بالنسبة للنماذج مثل moonshot/kimi-k2.6 التي تدعم التفكير بمستويين enabled / disabled، يتم تهيئة params لكل نموذج:

json5
{
  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. تابع في صفحات النماذج المحلية:

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.