Tools

جست‌وجوی Kimi

OpenClaw از Kimi به‌عنوان provider web_search پشتیبانی می‌کند و از جست‌وجوی وب Moonshot برای تولید پاسخ‌های ترکیب‌شده با هوش مصنوعی همراه با استنادها استفاده می‌کند.

دریافت کلید API

  • ایجاد کلید

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

  • ذخیره کلید

    KIMI_API_KEY یا MOONSHOT_API_KEY را در محیط Gateway تنظیم کنید، یا از طریق این فرمان پیکربندی کنید:

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

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

    پیکربندی

    {
      plugins: {
        entries: {
          moonshot: {
            config: {
              webSearch: {
                apiKey: "sk-...", // optional if KIMI_API_KEY or MOONSHOT_API_KEY is set
                baseUrl: "https://api.moonshot.ai/v1",
                model: "kimi-k2.6",
              },
            },
          },
        },
      },
      tools: {
        web: {
          search: {
            provider: "kimi",
          },
        },
      },
    }
    

    اگر برای چت از میزبان API چین استفاده می‌کنید (models.providers.moonshot.baseUrl: https://api.moonshot.cn/v1)، وقتی tools.web.search.kimi.baseUrl حذف شده باشد، OpenClaw همان میزبان را برای web_search مربوط به Kimi دوباره استفاده می‌کند؛ بنابراین کلیدهای platform.moonshot.cn به‌اشتباه به endpoint بین‌المللی ارسال نمی‌شوند (که اغلب HTTP 401 برمی‌گرداند). وقتی به URL پایه جست‌وجوی متفاوتی نیاز دارید، با tools.web.search.kimi.baseUrl آن را override کنید.

    جایگزین محیطی: KIMI_API_KEY یا MOONSHOT_API_KEY را در محیط Gateway تنظیم کنید. برای نصب gateway، آن را در ~/.openclaw/.env قرار دهید.

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

    نحوه کار

    Kimi از جست‌وجوی وب Moonshot برای ترکیب پاسخ‌ها همراه با استنادهای درون‌خطی استفاده می‌کند، مشابه رویکرد پاسخ grounded در Gemini و Grok.

    OpenClaw جست‌وجوی web_search در Kimi را فقط زمانی موفق در نظر می‌گیرد که Moonshot شواهد native مربوط به grounding جست‌وجوی وب را برگرداند، مانند payload ابزار $web_search قابل replay، search_results، یا URLهای استناد. اگر Kimi بلافاصله با یک پاسخ چت ساده مثل «نمی‌توانم اینترنت را مرور کنم» متوقف شود و هیچ شاهد grounding نداشته باشد، OpenClaw به‌جای اینکه آن متن را به‌عنوان نتیجه جست‌وجو wrap کند، یک خطای ساختاریافته kimi_web_search_ungrounded برمی‌گرداند. query را دوباره امتحان کنید، به یک provider ساختاریافته مثل Brave تغییر دهید، یا وقتی از قبل URL هدف دارید از web_fetch / ابزار مرورگر استفاده کنید.

    پارامترهای پشتیبانی‌شده

    جست‌وجوی Kimi از query پشتیبانی می‌کند.

    count برای سازگاری مشترک با web_search پذیرفته می‌شود، اما Kimi همچنان به‌جای فهرست Nتایی نتایج، یک پاسخ ترکیب‌شده همراه با استنادها برمی‌گرداند.

    فیلترهای ویژه provider در حال حاضر پشتیبانی نمی‌شوند.

    مرتبط