الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

LiteLLM هي بوابة LLM مفتوحة المصدر توفر API موحدًا لأكثر من 100 موفر نماذج. مرّر OpenClaw عبر LiteLLM للحصول على تتبع مركزي للتكلفة، وتسجيل السجلات، ومرونة تبديل الخلفيات دون تغيير إعدادات OpenClaw.
لماذا تستخدم LiteLLM مع OpenClaw؟
  • تتبع التكلفة — اعرف بدقة ما ينفقه OpenClaw عبر جميع النماذج
  • توجيه النماذج — بدّل بين Claude وGPT-4 وGemini وBedrock دون تغييرات في الإعدادات
  • مفاتيح افتراضية — أنشئ مفاتيح بحدود إنفاق لـ OpenClaw
  • تسجيل السجلات — سجلات كاملة للطلبات/الاستجابات من أجل التصحيح
  • البدائل الاحتياطية — تحويل تلقائي عند تعطل الموفر الأساسي

​
البدء السريع

​
الإعدادات

​
متغيرات البيئة

export LITELLM_API_KEY="sk-litellm-key"

​
ملف الإعدادات

{
  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 أيضًا دعم أداة image_generate من خلال مسارات متوافقة مع OpenAI مثل /images/generations و/images/edits. اضبط نموذج صور LiteLLM ضمن agents.defaults.imageGenerationModel: 
{
  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 دون تجاوز عام للشبكة الخاصة. بالنسبة إلى وكيل مستضاف على شبكة LAN، اضبط models.providers.litellm.request.allowPrivateNetwork: true لأن مفتاح API سيُرسل إلى مضيف الوكيل المضبوط.
أنشئ مفتاحًا مخصصًا لـ OpenClaw مع حدود إنفاق:
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:
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 التوجيه.
تحقق من لوحة معلومات LiteLLM أو API:
# Key info
curl "http://localhost:4000/key/info" \
  -H "Authorization: Bearer sk-litellm-key"

# Spend logs
curl "http://localhost:4000/spend/logs" \
  -H "Authorization: Bearer $LITELLM_MASTER_KEY"
  • يعمل LiteLLM على http://localhost:4000 افتراضيًا
  • يتصل OpenClaw عبر نقطة نهاية /v1 المتوافقة مع OpenAI وبنمط الوكيل في LiteLLM
  • لا ينطبق تشكيل الطلبات الأصلي الخاص بـ OpenAI فقط عبر LiteLLM: لا service_tier، ولا store في Responses، ولا تلميحات لذاكرة التخزين المؤقت للمطالبات، ولا تشكيل حمولات متوافق مع استدلال OpenAI
  • لا تُحقن ترويسات الإسناد المخفية الخاصة بـ OpenClaw (originator وversion وUser-Agent) على عناوين URL الأساسية المخصصة لـ LiteLLM
لإعدادات الموفر العامة وسلوك التحويل الاحتياطي، راجع موفرو النماذج.

​
ذات صلة

LiteLLM Docs

وثائق LiteLLM الرسمية ومرجع API.

Model selection

نظرة عامة على جميع الموفرين، ومراجع النماذج، وسلوك التحويل الاحتياطي.

Configuration

مرجع الإعدادات الكامل.

Model selection

كيفية اختيار النماذج وضبطها.