LiteLLM

LiteLLM هو Gateway مفتوح المصدر لنماذج LLM، ويوفّر واجهة API موحّدة لأكثر من 100 مزوّد للنماذج. وجّه OpenClaw عبر LiteLLM لتتبّع التكاليف وتسجيل السجلات مركزيًا، واستخدام مفاتيح افتراضية ذات حدود للإنفاق، والتبديل الاحتياطي بين الواجهات الخلفية دون تغيير إعدادات OpenClaw.

البدء السريع

Onboarding (recommended)
Manual setup

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

للإعداد غير التفاعلي باستخدام وكيل بعيد، مرّر عنوان URL للوكيل صراحةً:

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

Start LiteLLM Proxy

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

Point OpenClaw to LiteLLM

export LITELLM_API_KEY="your-litellm-key"
openclaw

الإعداد

{
  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 عبر مساري /images/generations و /images/edits المتوافقين مع OpenAI. نموذج الصور الافتراضي هو gpt-image-2؛ ويمكن إعداد نموذج مختلف ضمن 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 على local loopback (http://localhost:4000 و127.0.0.1 و::1 وhost.docker.internal) من دون تجاوز عام لإعدادات الشبكة الخاصة. بالنسبة إلى وكيل مستضاف على شبكة LAN، عيّن models.providers.litellm.request.allowPrivateNetwork: true لأن مفتاح API يُرسل إلى ذلك المضيف.

خيارات متقدمة

Virtual keys

أنشئ مفتاحًا مخصصًا لـ 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.

Model routing

يمكن لـ 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 عملية التوجيه.

Viewing usage

# 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"

Proxy behavior notes

يعمل LiteLLM افتراضيًا على http://localhost:4000.
يتصل OpenClaw عبر نقطة النهاية /v1 المتوافقة مع OpenAI، بنمط الوكيل الخاص بـ LiteLLM.
لا تنطبق تهيئة الطلبات المخصصة لنقاط نهاية OpenAI الأصلية فقط عند استخدام عنوان URL أساسي مُعدّ لـ LiteLLM: فلا يُستخدم service_tier، ولا store في Responses، ولا تلميحات ذاكرة التخزين المؤقت للموجّهات، ولا تهيئة حمولة مستوى جهد الاستدلال في OpenAI.
لا تُرسل ترويسات الإسناد المخفية الخاصة بـ OpenClaw (originator وversion وUser-Agent) إلا إلى نقاط نهاية OpenAI الأصلية التي تم التحقق منها، ولذلك لا تُضاف إلى عنوان URL أساسي مخصص لـ LiteLLM.

للتعرّف على الإعداد العام للمزوّد وسلوك التبديل الاحتياطي، راجع مزوّدي النماذج.

ذو صلة

LiteLLM Docs

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

Model selection

نظرة عامة على جميع المزوّدين ومراجع النماذج وسلوك التبديل الاحتياطي.

Configuration

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

Models

كيفية اختيار النماذج وإعدادها.

Overview

Concepts and configuration

Providers

البدء السريع

الإعداد

إنشاء الصور

خيارات متقدمة

ذو صلة

LiteLLM Docs

Model selection

Configuration

Models

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

​الإعداد

​إنشاء الصور

​خيارات متقدمة

​ذو صلة

LiteLLM Docs

Model selection

Configuration

Models

البدء السريع

الإعداد

إنشاء الصور

خيارات متقدمة

ذو صلة