إعداد موفر TokenLab

دع وكيلي يتولى الإعدادCopy Anchor Link

انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهازك:

اقرأ هذا الدليل وساعدني في ربط OpenClaw بـ TokenLab:
https://tokenlab.sh/docs/ar/guides/tokenlab-provider
تحقق أولًا من الإصدار المثبت لديّ والإعدادات الفعّالة.
احتفظ بالحسابات ومزوّدي الخدمة والأذونات والإعدادات الأخرى الموجودة.
انسخ الملفات المحلية احتياطيًا واعرض التغييرات المقترحة.
دعني أُدخل أي مفتاح API مطلوب محليًا؛ لا تطلبه أو تعرضه أو تلصقه في المحادثة.
تحقق أولًا من إمكانية تحميل الإعدادات.
اشرح تكلفة أي اختبار يتضمن طلبًا مدفوعًا بشكل منفصل قبل تشغيله.

موصى به: تثبيت الإضافةCopy Anchor Link

اختياريًا، ثبّت إضافة المزوّد المنشورة 0.1.0. وفّر TOKENLAB_API_KEY في بيئة Gateway نفسها الموضحة أدناه واختر النموذج للجلسة فقط. يغيّر معالج الإعداد النموذج الافتراضي، لذا لا يشغّل هذا الدليل openclaw onboard. احتفظ بالإضافات والأذونات الحالية وتحقق من تحميل الإضافة وقائمة النماذج قبل أي طلب.

راجع الإمكانات التي يطلبها المثبّت واتبع رسائل التأكيد في العميل. لا تمنح أذونات غير مرتبطة ولا تغيّر أذونات الإضافات الموجودة.

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab

/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

تكوين الموفر يدويًاCopy Anchor Link

استخدم إدخالات models.providers اليدوية أدناه فقط عندما تحتاج صراحةً إلى مسارات منفصلة لـ Responses API أو Claude native أو Gemini native أو MiniMax native.

إذا اخترت التكوين اليدوي، فيكفي تكوين tokenlab بمفرده. أضف الموفرين الآخرين فقط عندما تحتاج صراحةً إلى سلوك Responses API أو Claude native أو Gemini native أو MiniMax native.

المتطلبات المسبقةCopy Anchor Link

• مثيل OpenClaw مستضاف محليًا (self-hosted)
• يتطلب OpenClaw 2026.9.4 إصدار Node.js ضمن النطاق >=24.16.0 <25 || >=26.1.0 (متطلبات الإصدار). عند استخدام إصدار آخر من OpenClaw، تحقّق من متطلباته الخاصة.
• مفتاح API من TokenLab — Get one here

التكوينCopy Anchor Link

حرّر تهيئة OpenClaw الخاصة بك:

• مستضاف ذاتيًا: ~/.openclaw/openclaw.json

أضف موفري TokenLab تحت models.providers:

استخدم ملف التعريف وOPENCLAW_STATE_DIR وOPENCLAW_CONFIG_PATH نفسها الخاصة بالبوابة العاملة، وانسخ الإعدادات احتياطيًا. ضع TOKENLAB_API_KEY في .env العام الموثوق أو بيئة الخدمة لهذه النسخة. قد لا تصل متغيرات الطرفية أو .env المشروع إلى عملية الخلفية. راجع البيئة.

أنشئ نسخة احتياطية من الإعداد النشط. أضف عنصر TokenLab فقط واحتفظ بالمزوّدين والحسابات والنموذج الافتراضي والأذونات الحالية. إذا كان الاسم مستخدمًا، فاختر اسمًا آخر وعدّل الأوامر. للتراجع، احذف العنصر الذي أضفته فقط أو استعد نسخته الاحتياطية.

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-reasoner", name: "DeepSeek Reasoner" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

استخدام النماذجCopy Anchor Link

لا يزال OpenClaw يشير إلى النماذج بصيغة provider/model:

في OpenClaw 2026.9.4، اختر النموذج للجلسة الحالية فقط باستخدام -s. احتفظ بـ agents.defaults.model وإعدادات الوكيل الافتراضية والأذونات. استخدم /model default -s لإعادة الجلسة إلى نموذجها الافتراضي.

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

أمثلة على النماذجCopy Anchor Link

تصفّح جميع النماذج المتاحة على tokenlab.sh/models.

متى تستخدم أي موفرCopy Anchor Link

• tokenlab: الخيار الافتراضي لمعظم حالات استخدام الوكلاء والدردشة العامة.
• tokenlab-responses: استخدمه عندما يعتمد سير عمل OpenClaw صراحةً على دلالات OpenAI Responses.
• tokenlab-claude: استخدمه عندما تريد سلوك Messages الأصلي الخاص بـ Claude.
• tokenlab-gemini: استخدمه عندما تريد تنسيق طلب/استجابة أصلي لـ Gemini أو تكاملات بصيغة Gemini الموجودة مسبقًا.
• tokenlab-minimax: استخدمه عندما تريد MiniMax عبر مساره الأصلي.

إذا لم تكن بحاجة إلى سلوك Gemini الأصلي، فلا يزال بإمكانك استدعاء نماذج Gemini عبر tokenlab/gemini-* على المسار المتوافق مع OpenAI.

الأخطاء الشائعةCopy Anchor Link

التحقق من الإعدادCopy Anchor Link

أعد تشغيل النسخة نفسها وافحص النموذج والمزود. models status دون --probe ليس اختبارًا لاستدعاء النموذج. الاختبارات الحية والرسائل قد تستهلك tokens. طابق الرد مع سجل TokenLab. للاستعادة اختر النموذج السابق واحذف العناصر المضافة فقط.

openclaw gateway restart
openclaw models status

الخطوات التاليةCopy Anchor Link

بمجرد اتصال OpenClaw، تساعدك هذه الأدلة على استخدام TokenLab بشكل أكثر فعالية:

• تنسيقات API — فهم الفروقات بين مسارات OpenAI وResponses وAnthropic وGemini
• IDE / SDK Compatibility — متى يكون /v1/responses الخيار الأنسب
• معالجة الأخطاء — تعرّف على أنماط الفشل الشائعة واستراتيجيات التعافي
• نظرة عامة على النماذج — تصفّح معرفات النماذج قبل توصيلها بالوكلاء