OpenClawDocs
در این صفحه

در این صفحه

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

LiteLLM

LiteLLM یک Gateway متن‌باز برای LLM است که API یکپارچه‌ای برای بیش از 100 ارائه‌دهندهٔ مدل فراهم می‌کند. OpenClaw را از طریق LiteLLM مسیریابی کنید تا بدون تغییر پیکربندی OpenClaw، ردیابی متمرکز هزینه، ثبت رویدادها، کلیدهای مجازی با محدودیت هزینه و جایگزینی خودکار بک‌اند را در اختیار داشته باشید.

شروع سریع

راه‌اندازی اولیه (توصیه‌شده)

bash
openclaw onboard --auth-choice litellm-api-key

برای راه‌اندازی غیرتعاملی در برابر یک پراکسی راه دور، URL پراکسی را به‌صراحت وارد کنید:

bash
openclaw onboard --non-interactive --accept-risk --auth-choice litellm-api-key \  --litellm-api-key "$LITELLM_API_KEY" --custom-base-url "https://litellm.example/v1"

راه‌اندازی دستی

  • راه‌اندازی پراکسی LiteLLM

    bash
    pip install 'litellm[proxy]'litellm --model claude-opus-4-6

  • اتصال OpenClaw به LiteLLM

    bash
    export LITELLM_API_KEY="your-litellm-key"openclaw

    • پیکربندی

    json5
    {  models: {    providers: {      litellm: {        baseUrl: "http://localhost:4000",        apiKey: "${LITELLM_API_KEY}",        api: "openai-completions",        models: [          {            id: "claude-opus-4-6",            name: "Claude Opus 4.6",            reasoning: true,            input: ["text", "image"],            contextWindow: 200000,            maxTokens: 64000,          },          {            id: "gpt-4o",            name: "GPT-4o",            reasoning: false,            input: ["text", "image"],            contextWindow: 128000,            maxTokens: 8192,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "litellm/claude-opus-4-6" },    },  },}

    مدل پیش‌فرضی که راه‌اندازی اولیه می‌نویسد، litellm/claude-opus-4-6 است.

    تولید تصویر

    LiteLLM می‌تواند ابزار image_generate را از طریق مسیرهای سازگار با OpenAI یعنی /images/generations و /images/edits پشتیبانی کند. مدل پیش‌فرض تصویر gpt-image-2 است؛ مدل دیگری را در agents.defaults.mediaModels.image پیکربندی کنید:

    json5
    {  models: {    providers: {      litellm: {        baseUrl: "http://localhost:4000",        apiKey: "${LITELLM_API_KEY}",      },    },  },  agents: {    defaults: {      imageGenerationModel: {        primary: "litellm/gpt-image-2",        timeoutMs: 180_000,      },    },  },}

    URLهای حلقهٔ بازگشتی LiteLLM ‏(http://localhost:4000، 127.0.0.1، ::1، host.docker.internal) بدون نادیده‌گیری سراسری شبکهٔ خصوصی کار می‌کنند. برای پراکسی میزبانی‌شده در LAN، models.providers.litellm.request.allowPrivateNetwork: true را تنظیم کنید، زیرا کلید API به آن میزبان ارسال می‌شود.

    پیشرفته

    کلیدهای مجازی

    برای OpenClaw یک کلید اختصاصی با محدودیت هزینه ایجاد کنید:

    bash
    curl -X POST "http://localhost:4000/key/generate" \  -H "Authorization: Bearer $LITELLM_MASTER_KEY" \  -H "Content-Type: application/json" \  -d '{    "key_alias": "openclaw",    "max_budget": 50.00,    "budget_duration": "monthly"  }'

    از کلید ایجادشده به‌عنوان LITELLM_API_KEY استفاده کنید.

    مسیریابی مدل

    LiteLLM می‌تواند درخواست‌های مدل را به بک‌اندهای مختلف مسیریابی کند. آن را در config.yaml مربوط به LiteLLM پیکربندی کنید:

    yaml
    model_list:  - model_name: claude-opus-4-6    litellm_params:      model: claude-opus-4-6      api_key: os.environ/ANTHROPIC_API_KEY   - model_name: gpt-4o    litellm_params:      model: gpt-4o      api_key: os.environ/OPENAI_API_KEY

    OpenClaw همچنان claude-opus-4-6 را درخواست می‌کند؛ LiteLLM مسیریابی را انجام می‌دهد.

    مشاهدهٔ میزان استفاده
    bash
    # اطلاعات کلیدcurl "http://localhost:4000/key/info" \  -H "Authorization: Bearer sk-litellm-key" # گزارش‌های هزینهcurl "http://localhost:4000/spend/logs" \  -H "Authorization: Bearer $LITELLM_MASTER_KEY"
    نکاتی دربارهٔ رفتار پراکسی
    • LiteLLM به‌طور پیش‌فرض روی http://localhost:4000 اجرا می‌شود.
    • OpenClaw از طریق نقطهٔ پایانی سازگار با OpenAI و به‌سبک پراکسی LiteLLM یعنی /v1 متصل می‌شود.
    • شکل‌دهی درخواست مختص OpenAI بومی، از طریق URL پایهٔ پیکربندی‌شدهٔ LiteLLM اعمال نمی‌شود: بدون service_tier، بدون Responses ‏store، بدون راهنمایی‌های کش پرامپت و بدون شکل‌دهی بار دادهٔ تلاش استدلال OpenAI.
    • هدرهای پنهان انتساب OpenClaw ‏(originator، version، User-Agent) فقط به نقاط پایانی تأییدشدهٔ بومی OpenAI ارسال می‌شوند؛ بنابراین به URL پایهٔ سفارشی LiteLLM تزریق نمی‌شوند.

    مرتبط

    مستندات LiteLLM

    مستندات رسمی LiteLLM و مرجع API.
    انتخاب مدل

    نمای کلی همهٔ ارائه‌دهندگان، ارجاع‌های مدل و رفتار جایگزینی خودکار.
    پیکربندی

    مرجع کامل پیکربندی.
    مدل‌ها

    نحوهٔ انتخاب و پیکربندی مدل‌ها.
    Was this useful?