الانتقال إلى المحتوى الرئيسي
هذا الدليل مخصّص لمستخدمي OpenClaw المستضاف محليًا (self-hosted) الذين يرغبون في ربط TokenLab كمزوِّد AI خاص بهم.

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

لتشغيل وكلاء OpenClaw بالطريقة القياسية، ثبّت إضافة موفر TokenLab: 
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
تجلب الإضافة دليل نماذج المحادثة المباشر من TokenLab، وتحتفظ بـ 18 نموذجًا احتياطيًا للاكتشاف دون اتصال. تستخدم النماذج التنسيق tokenlab/<model-id>. حزمة npm · صفحة ClawHub · الشيفرة المصدرية

​
تكوين الموفر يدويًا

استخدم إدخالات models.providers اليدوية أدناه فقط عندما تحتاج صراحةً إلى مسارات منفصلة لـ Responses API أو Claude native أو Gemini native أو MiniMax native. إذا اخترت التكوين اليدوي، فيكفي تكوين tokenlab بمفرده. أضف الموفرين الآخرين فقط عندما تحتاج صراحةً إلى سلوك Responses API أو Claude native أو Gemini native أو MiniMax native.
المزوّدOpenClaw apiالأفضل لـbaseUrl
tokenlabopenai-completionsGPT وDeepSeek وQwen ومعظم الاستدعاءات المتوافقة مع OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesتدفقات عمل OpenAI Responses التي تتوقع دلالات /v1/responseshttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesواجهة Claude Messages الأصليةhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiصيغة Gemini الأصليةhttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesتوجيه MiniMax الأصليhttps://api.tokenlab.sh
استخدم اللاحقة /v1 فقط مع openai-completions وopenai-responses.يجب أن تستخدم الموفرات الأصلية مثل anthropic-messages وgoogle-generative-ai https://api.tokenlab.sh بدون /v1، وإلا فقد ينشئ OpenClaw مسارًا علويًا غير صحيح.

​
المتطلبات المسبقة

  • مثيل OpenClaw مستضاف محليًا (self-hosted)
  • مفتاح API من TokenLab — Get one here

​
التكوين

حرّر تهيئة OpenClaw الخاصة بك:
  • مستضاف ذاتيًا: ~/.openclaw/openclaw.json
أضف موفري TokenLab تحت models.providers: 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-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: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}
جميع الموفرين الخمسة يستخدمون نفس مفتاح API. تحتاج لحساب TokenLab واحد فقط.
قوائم models أعلاه تعرض أمثلة شائعة فقط. أضف المزيد من معرفات النماذج لكل موفر حسب الحاجة.

​
استخدام النماذج

لا يزال OpenClaw يشير إلى النماذج بصيغة provider/model: 
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-3.5-flash"
      }
    }
  }
}

​
أمثلة على النماذج

المزوّدمرجع النموذجالوصف
tokenlabtokenlab/gpt-4oمسار متوافق مع OpenAI
tokenlabtokenlab/deepseek-r1نموذج استدلال DeepSeek
tokenlab-responsestokenlab-responses/gpt-4oمسار Responses API
tokenlab-claudetokenlab-claude/claude-sonnet-4-6مسار Claude Messages الأصلي
tokenlab-geminitokenlab-gemini/gemini-3.5-flashمسار Gemini الأصلي
tokenlab-minimaxtokenlab-minimax/minimax-m3مسار MiniMax الأصلي
تصفّح جميع النماذج المتاحة على tokenlab.sh/models.

​
متى تستخدم أي موفر

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

​
الأخطاء الشائعة

تستخدم وثائق OpenClaw الحالية models.providers. إذا احتفظت بالتنسيق القديم لمصفوفة providers على المستوى العلوي، فقد يتجاهل OpenClaw التهيئة أو يفشل في حل بادئات الموفر كما هو متوقع.
تقوم openai-responses بالتوجيه إلى مسار /v1/responses الخاص بـ TokenLab، لذلك يجب أن يستخدم tokenlab-responses https://api.tokenlab.sh/v1.
يجب أن تستخدم anthropic-messages وgoogle-generative-ai https://api.tokenlab.sh بدون /v1. إضافة /v1 يمكن أن تُنتج مسارات طلب غير صحيحة.
نعم. لا تزال وثائق OpenClaw الحالية تتضمن الموفر المدمج google وتدعم أيضًا الموفرات المخصصة باستخدام api: "google-generative-ai". لذا يظل tokenlab-gemini مسار Gemini أصليًا صالحًا لمستخدمي OpenClaw.

​
التحقق من الإعداد

بعد حفظ التهيئة، أعد تشغيل مثيل OpenClaw الخاص بك واختبر برسالة بسيطة. إذا رأيت استجابة، فالمزوّد مكوّن بشكل صحيح. 
# مستضاف ذاتيًا: أعد تشغيل الخدمة
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS

​
الخطوات التالية

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