Providers
LiteLLM
LiteLLM هو Gateway مفتوح المصدر لنماذج LLM، ويوفّر واجهة API موحّدة لأكثر من 100 مزوّد للنماذج. وجّه OpenClaw عبر LiteLLM لتتبّع التكاليف وتسجيل السجلات مركزيًا، واستخدام مفاتيح افتراضية ذات حدود للإنفاق، والتبديل الاحتياطي بين الواجهات الخلفية دون تغيير إعدادات OpenClaw.
البدء السريع
Onboarding (recommended)
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"Manual setup
Start LiteLLM Proxy
pip install 'litellm[proxy]'litellm --model claude-opus-4-6Point 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 infocurl "http://localhost:4000/key/info" \ -H "Authorization: Bearer sk-litellm-key" # Spend logscurl "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.
