Tools

جست‌وجوی Kimi

Kimi یک ارائه‌دهندهٔ web_search است که از جست‌وجوی وب بومی Moonshot پشتیبانی می‌کند. Moonshot به‌جای بازگرداندن فهرستی رتبه‌بندی‌شده از نتایج، مشابه ارائه‌دهندگان پاسخ مبتنی بر منابع Gemini و Grok، یک پاسخ واحد همراه با ارجاعات درون‌متنی تولید می‌کند.

راه‌اندازی

  • ایجاد کلید

    یک کلید API از Moonshot AI دریافت کنید.

  • ذخیره کلید

    KIMI_API_KEY یا MOONSHOT_API_KEY را در محیط Gateway تنظیم کنید (برای نصب Gateway، آن را به ~/.openclaw/.env اضافه کنید)، یا از طریق دستور زیر پیکربندی کنید:

    bash
    openclaw configure --section web
  • انتخاب Kimi هنگام اجرای openclaw onboard یا openclaw configure --section web همچنین موارد زیر را درخواست می‌کند:

    • منطقهٔ API مربوط به Moonshot: https://api.moonshot.ai/v1 یا https://api.moonshot.cn/v1
    • مدل جست‌وجوی وب (مقدار پیش‌فرض kimi-k2.6 است)

    پیکربندی

    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",      },    },  },}

    اگر tools.web.search.provider حذف شده باشد، مقدار آن به‌طور خودکار بر اساس کلیدهای API موجود تشخیص داده می‌شود؛ اگر چند اعتبارنامهٔ جست‌وجو پیکربندی شده‌اند، آن را صراحتاً روی kimi تنظیم کنید.

    شکل محدوده‌بندی‌شدهٔ معادل در tools.web.search.kimi شامل (apiKey، baseUrl، model) نیز کار می‌کند؛ هر دو ساختار در یک پیکربندی نهایی یکسان ادغام می‌شوند.

    مقادیر پیش‌فرض: اگر baseUrl حذف شود، مقدار پیش‌فرض آن https://api.moonshot.ai/v1 است و مقدار پیش‌فرض model برابر با kimi-k2.6 است.

    اگر ترافیک گفت‌وگو از میزبان چین (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1) استفاده کند، وقتی baseUrl اختصاصی Kimi تنظیم نشده باشد، web_search مربوط به Kimi به‌طور خودکار از همان میزبان استفاده می‌کند تا کلیدهای .cn به‌اشتباه به نقطهٔ پایانی بین‌المللی ارسال نشوند (که برای آن کلیدها HTTP 401 برمی‌گرداند). برای نادیده گرفتن این وراثت، یک baseUrl صریح برای Kimi تنظیم کنید.

    الزام استناد به منابع

    OpenClaw تنها زمانی نتیجهٔ web_search مربوط به Kimi را بازمی‌گرداند که پاسخ Moonshot شامل شواهد بومی جست‌وجوی وب، مانند بازپخش فراخوانی ابزار $web_search، search_results یا نشانی‌های استناد باشد. اگر Kimi مستقیماً و بدون استناد به منابع پاسخ دهد (برای مثال «نمی‌توانم اینترنت را مرور کنم»)، OpenClaw به‌جای در نظر گرفتن آن متن به‌عنوان نتیجهٔ جست‌وجو، خطای kimi_web_search_ungrounded را بازمی‌گرداند. پرس‌وجو را دوباره امتحان کنید، به یک ارائه‌دهندهٔ ساخت‌یافته مانند Brave تغییر دهید، یا اگر از قبل نشانی مقصد را دارید، از web_fetch یا ابزار مرورگر استفاده کنید.

    پارامترهای ابزار

    پارامتر پشتیبانی
    query بله
    count برای سازگاری میان ارائه‌دهندگان پذیرفته می‌شود، اما نادیده گرفته می‌شود: Kimi همیشه یک پاسخ ترکیبی بازمی‌گرداند، نه فهرستی شامل N نتیجه
    country، language، freshness، date_after، date_before خیر

    مرتبط

    Was this useful?
    On this page

    On this page