مرجع تقني

استخدام واجهة برمجة التطبيقات والتكاليف

يسرد هذا المستند الميزات التي يمكنها استدعاء مفاتيح واجهة برمجة التطبيقات وأين تظهر تكاليفها. يركز على ميزات OpenClaw التي يمكنها توليد استخدام للمزود أو استدعاءات واجهة برمجة تطبيقات مدفوعة.

أين تظهر التكاليف (الدردشة + سطر الأوامر)

لقطة تكلفة لكل جلسة

  • /status تعرض نموذج الجلسة الحالي، واستخدام السياق، وآخر الرموز المميزة للرد.
  • إذا كان النموذج يستخدم مصادقة بمفتاح واجهة برمجة تطبيقات، فإن /status تعرض أيضًا التكلفة المقدرة للرد الأخير.

تذييل التكلفة لكل رسالة

  • /usage full تُلحق تذييل استخدام بكل رد، بما في ذلك التكلفة المقدرة (لمفاتيح واجهة برمجة التطبيقات فقط).
  • /usage tokens تعرض الرموز المميزة فقط؛ تدفقات OAuth تخفي تكلفة الدولار.

نوافذ الاستخدام في سطر الأوامر (حصص المزود)

  • openclaw status --usage و openclaw channels list تعرضان نوافذ الاستخدام للمزود (لقطات الحصة، وليست تكاليف لكل رسالة).

راجع استخدام الرموز المميزة والتكاليف للحصول على التفاصيل والأمثلة.

كيف يتم اكتشاف المفاتيح

يمكن لـ OpenClaw التقاط بيانات الاعتماد من:

  • ملفات تعريف المصادقة (لكل وكيل، مخزنة في auth-profiles.json).
  • متغيرات البيئة (مثل OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
  • التكوين (models.providers.*.apiKey, tools.web.search.*, tools.web.fetch.firecrawl.*, memorySearch.*, talk.apiKey).
  • المهارات (skills.entries.<name>.apiKey) والتي قد تصدر المفاتيح إلى بيئة عملية المهارة.

الميزات التي يمكنها إنفاق المفاتيح

١) ردود النموذج الأساسية (الدردشة + الأدوات)

كل رد أو استدعاء أداة يستخدم مزود النموذج الحالي (OpenAI, Anthropic، إلخ). هذا هو المصدر الأساسي للاستخدام والتكلفة. راجع النماذج لتكوين التسعير و استخدام الرموز المميزة والتكاليف للعرض.

٢) فهم الوسائط (الصوت/الصورة/الفيديو)

يمكن تلخيص/نسخ الوسائط الواردة قبل تشغيل الرد. يستخدم هذا واجهات برمجة تطبيقات النموذج/المزود.

  • الصوت: OpenAI / Groq / Deepgram (مفعلة تلقائيًا الآن عند وجود المفاتيح).
  • الصورة: OpenAI / Anthropic / Google.
  • الفيديو: Google.

راجع فهم الوسائط.

٣) تضمينات الذاكرة + البحث الدلالي

يستخدم البحث الدلالي للذاكرة واجهات برمجة تطبيقات التضمين عند التكوين لمزودين بعيدين:

  • memorySearch.provider = "openai" → تضمينات OpenAI
  • memorySearch.provider = "gemini" → تضمينات Gemini
  • memorySearch.provider = "voyage" → تضمينات Voyage
  • memorySearch.provider = "mistral" → تضمينات Mistral
  • memorySearch.provider = "ollama" → تضمينات Ollama (محلية/مستضافة ذاتيًا؛ عادةً لا توجد فوترة لواجهة برمجة تطبيقات مستضافة)
  • تراجع اختياري إلى مزود بعيد إذا فشلت التضمينات المحلية

يمكنك إبقاء الأمر محليًا باستخدام memorySearch.provider = "local" (بدون استخدام لواجهة برمجة التطبيقات). راجع الذاكرة.

٤) أداة بحث الويب

web_search تستخدم مفاتيح واجهة برمجة التطبيقات وقد تتكبد رسوم استخدام حسب مزودك:

  • Perplexity Search API: PERPLEXITY_API_KEY
  • Brave Search API: BRAVE_API_KEY أو tools.web.search.apiKey
  • Gemini (Google Search): GEMINI_API_KEY
  • Grok (xAI): XAI_API_KEY
  • Kimi (Moonshot): KIMI_API_KEY أو MOONSHOT_API_KEY

راجع أدوات الويب.

٥) أداة جلب الويب (Firecrawl)

web_fetch يمكنها استدعاء Firecrawl عند وجود مفتاح واجهة برمجة تطبيقات:

  • FIRECRAWL_API_KEY أو tools.web.fetch.firecrawl.apiKey

إذا لم يكن Firecrawl مُكونًا، تتراجع الأداة إلى الجلب المباشر + إمكانية القراءة (بدون واجهة برمجة تطبيقات مدفوعة). راجع أدوات الويب.

٦) لقطات استخدام المزود (الحالة/الصحة)

بعض أوامر الحالة تستدعي نقاط نهاية استخدام المزود لعرض نوافذ الحصة أو صحة المصادقة. هذه عادةً استدعاءات منخفضة الحجم ولكنها لا تزال تصل إلى واجهات برمجة تطبيقات المزود:

  • openclaw status --usage
  • openclaw models status --json

راجع سطر أوامر النماذج.

٧) تلخيص ضمان الضغط

يمكن لضمان الضغط تلخيص تاريخ الجلسة باستخدام النموذج الحالي، مما يستدعي واجهات برمجة تطبيقات المزود عند تشغيله. راجع إدارة الجلسة + الضغط.

٨) مسح/فحص النموذج

openclaw models scan يمكنه فحص نماذج OpenRouter ويستخدم OPENROUTER_API_KEY عند تمكين الفحص. راجع سطر أوامر النماذج.

٩) التحدث (الكلام)

وضع التحدث يمكنه استدعاء ElevenLabs عند التكوين:

  • ELEVENLABS_API_KEY أو talk.apiKey

راجع وضع التحدث.

١٠) المهارات (واجهات برمجة تطبيقات الطرف الثالث)

يمكن للمهارات تخزين apiKey في skills.entries.<name>.apiKey. إذا استخدمت المهارة هذا المفتاح لواجهات برمجة تطبيقات خارجية، فيمكنها تكبد تكاليف وفقًا لمزود المهارة. راجع المهارات.

التخزين المؤقت للمطالبةنظافة النص