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

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

# أين تظهر التكاليف (الدردشة + CLI)

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

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

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

• يضيف /usage full تذييل استخدام إلى كل رد، بما في ذلك التكلفة التقديرية (لمفاتيح API فقط).
• يعرض /usage tokens الرموز فقط؛ وتخفي تدفقات OAuth/الرموز ذات نمط الاشتراك وCLI التكلفة بالدولار.
• ملاحظة Gemini CLI: عندما يعيد CLI مخرجات JSON، يقرأ OpenClaw الاستخدام من stats، ويحوّل stats.cached إلى cacheRead، ويشتق رموز الإدخال من stats.input_tokens - stats.cached عند الحاجة.

ملاحظة Anthropic: أخبرنا موظفو Anthropic أن استخدام Claude CLI بنمط OpenClaw مسموح به مجددًا، لذلك يتعامل OpenClaw مع إعادة استخدام Claude CLI واستخدام claude -p على أنهما معتمدان لهذا التكامل ما لم تنشر Anthropic سياسة جديدة. ما زالت Anthropic لا توفّر تقديرًا بالدولار لكل رسالة يمكن لـ OpenClaw عرضه في /usage full.

نوافذ استخدام CLI (حصص المزوّدين)

• يعرض openclaw status --usage وopenclaw channels list نوافذ استخدام المزوّدين (لقطات للحصة، وليست تكاليف لكل رسالة).
• يتم توحيد المخرجات البشرية إلى X% left عبر المزوّدين.
• مزوّدو نوافذ الاستخدام الحاليون: Anthropic، وGitHub Copilot، وGemini CLI، وOpenAI Codex، وMiniMax، وXiaomi، وz.ai.
• ملاحظة MiniMax: تعني حقولا usage_percent / usagePercent الخامان الحصة المتبقية، لذلك يعكسهما OpenClaw قبل العرض. تظل الحقول المعتمدة على العدد ذات أولوية عند وجودها. إذا أعاد المزوّد model_remains، يفضّل OpenClaw إدخال نموذج الدردشة، ويشتق تسمية النافذة من الطوابع الزمنية عند الحاجة، و يضمّن اسم النموذج في تسمية الخطة.
• تأتي مصادقة الاستخدام لتلك النوافذ الحصصية من خطافات خاصة بالمزوّد عند توفرها؛ وإلا فيرجع OpenClaw إلى مطابقة بيانات اعتماد OAuth/مفتاح API من ملفات تعريف المصادقة، أو البيئة، أو الإعدادات.

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

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

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

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

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

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

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

ويشمل ذلك أيضًا المزوّدين المستضافين بنمط الاشتراك الذين يظلون يفرضون الرسوم خارج واجهة OpenClaw المحلية، مثل OpenAI Codex، وAlibaba Cloud Model Studio Coding Plan، وMiniMax Coding Plan، وZ.AI / GLM Coding Plan، ومسار تسجيل دخول Anthropic Claude في OpenClaw مع تمكين Extra Usage.

راجع النماذج لإعدادات التسعير واستخدام الرموز والتكاليف للعرض.

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

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

• الصوت: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
• الصورة: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
• الفيديو: Google / Qwen / Moonshot.

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

# 3) توليد الصور والفيديو

يمكن لإمكانات التوليد المشتركة أن تنفق مفاتيح المزوّدين أيضًا:

• توليد الصور: OpenAI / Google / DeepInfra / fal / MiniMax
• توليد الفيديو: DeepInfra / Qwen

يمكن لتوليد الصور استنتاج مزوّد افتراضي مدعوم بالمصادقة عندما يكون agents.defaults.imageGenerationModel غير معيّن. يتطلب توليد الفيديو حاليًا agents.defaults.videoGenerationModel صريحًا مثل qwen/wan2.6-t2v.

راجع توليد الصور، وQwen Cloud، والنماذج.

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

يستخدم بحث الذاكرة الدلالي APIs التضمين عند إعداده لمزوّدين بعيدين:

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

يمكنك إبقاؤه محليًا باستخدام memorySearch.provider = "local" (بلا استخدام API).

راجع الذاكرة.

# 5) أداة بحث الويب

قد يتسبب web_search في رسوم استخدام حسب مزوّدك:

• Brave Search API: BRAVE_API_KEY أو plugins.entries.brave.config.webSearch.apiKey
• Exa: EXA_API_KEY أو plugins.entries.exa.config.webSearch.apiKey
• Firecrawl: FIRECRAWL_API_KEY أو plugins.entries.firecrawl.config.webSearch.apiKey
• Gemini (Google Search): GEMINI_API_KEY أو plugins.entries.google.config.webSearch.apiKey
• Grok (xAI): XAI_API_KEY أو plugins.entries.xai.config.webSearch.apiKey
• Kimi (Moonshot): KIMI_API_KEY، أو MOONSHOT_API_KEY، أو plugins.entries.moonshot.config.webSearch.apiKey
• MiniMax Search: MINIMAX_CODE_PLAN_KEY، أو MINIMAX_CODING_API_KEY، أو MINIMAX_API_KEY، أو plugins.entries.minimax.config.webSearch.apiKey
• Ollama Web Search: بلا مفتاح لمضيف Ollama محلي يمكن الوصول إليه ومُسجّل الدخول؛ يستخدم البحث المباشر عبر https://ollama.com المفتاح OLLAMA_API_KEY، ويمكن للمضيفين المحميين بالمصادقة إعادة استخدام مصادقة حامل مزوّد Ollama العادية
• Perplexity Search API: PERPLEXITY_API_KEY، أو OPENROUTER_API_KEY، أو plugins.entries.perplexity.config.webSearch.apiKey
• Tavily: TAVILY_API_KEY أو plugins.entries.tavily.config.webSearch.apiKey
• DuckDuckGo: بديل بلا مفتاح (بلا فوترة API، لكنه غير رسمي ومعتمد على HTML)
• SearXNG: SEARXNG_BASE_URL أو plugins.entries.searxng.config.webSearch.baseUrl (بلا مفتاح/مستضاف ذاتيًا؛ بلا فوترة API مستضافة)

ما زالت مسارات مزوّد tools.web.search.* القديمة تُحمّل عبر طبقة التوافق المؤقتة، لكنها لم تعد سطح الإعدادات الموصى به.

رصيد Brave Search المجاني: تتضمن كل خطة Brave رصيدًا مجانيًا متجددًا بقيمة $5 شهريًا. تبلغ تكلفة خطة Search $5 لكل 1,000 طلب، لذلك يغطي الرصيد 1,000 طلب شهريًا بلا رسوم. اضبط حد الاستخدام في لوحة تحكم Brave لتجنب الرسوم غير المتوقعة.

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

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

يمكن لـ web_fetch استدعاء Firecrawl عند وجود مفتاح API:

• FIRECRAWL_API_KEY أو plugins.entries.firecrawl.config.webFetch.apiKey

إذا لم يتم إعداد Firecrawl، ترجع الأداة إلى الجلب المباشر مع Plugin web-readability المضمّن (بلا API مدفوعة). عطّل plugins.entries.web-readability.enabled لتخطي استخراج Readability المحلي.

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

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

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

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

راجع CLI النماذج.

# 7) تلخيص حماية Compaction

يمكن لحماية Compaction تلخيص سجل الجلسة باستخدام النموذج الحالي، مما يستدعي APIs المزوّدين عند تشغيلها.

راجع إدارة الجلسات + Compaction.

# 8) فحص / اختبار النموذج

يمكن لـ openclaw models scan اختبار نماذج OpenRouter ويستخدم OPENROUTER_API_KEY عند تمكين الاختبار.

راجع CLI النماذج.

# 9) التحدث (الكلام)

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

• ELEVENLABS_API_KEY أو talk.providers.elevenlabs.apiKey

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

# 10) Skills (APIs جهات خارجية)

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

راجع Skills.

# ذات صلة

• استخدام الرموز والتكاليف
• تخزين الموجهات مؤقتًا
• تتبع الاستخدام