التوثيق ‹ تكاملات الوكلاء ‹ OpenClaw

OpenClaw

يتصل OpenClaw بـCloudZIR عبر إعداد مزوّده المتوافق مع OpenAI، أو مباشرة عبر متغيرات بيئة صيغة Anthropic حسب البوابة التي تستخدمونها.

الخيار أ: مزوّد متوافق مع OpenAI#

في ملف إعداد OpenClaw (~/.openclaw/config.yml) :

providers:
  cloudzir:
    type: openai-compatible
    base_url: https://api.cloudzir.com/v1
    api_key_env: CLOUDZIR_API_KEY
    models:
      - mina-full
      - mina-low
      - mina-flash

model: cloudzir/mina-full
export CLOUDZIR_API_KEY="zir_ai_..."
openclaw

الخيار ب: واجهة Anthropic#

إن كان إصدار OpenClaw لديكم يشغّل محركًا بصيغة Anthropic، تكفي نفس المتغيرات المستخدمة لـClaude Code :

export ANTHROPIC_BASE_URL="https://api.cloudzir.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="zir_ai_..."
export ANTHROPIC_MODEL="mina-full"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="mina-flash"
أي خيار تختارون

تعرض كلتا الواجهتين نفس النماذج، ونفس الفوترة، ونفس المفتاح. اختاروا ما يدعمه إصدار OpenClaw لديكم بشكل أفضل ؛ عند الشك، الخيار أ (متوافق مع OpenAI) هو الأكثر انتشارًا.

التحقق#

بعد أول أمر، تظهر الطلبات في Usage مع نقطة النهاية المستخدَمة (/v1/chat/completions أو /anthropic/v1/messages)؛ هذه أبسط طريقة للتأكد من الواجهة المستخدَمة فعليًا.

نصائح#

  • قد يدخل وكيل مستقل في حلقة : حدّدوا سقفًا لعدد الجولات وراقبوا رصيدكم في البداية.
  • خصّصوا mina-flash للمهام الفرعية (القراءة، البحث) وmina-full للاستدلال الرئيسي.
  • استخدموا معرّف مستخدم نهائي (user) إن كان عدة أشخاص يشاركون نفس المفتاح : ستُحتسب حدود المعدل بشكل منفصل (التفاصيل).

الإعدادات

التخصيص

استجابة API