> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# إعداد موفر TokenLab

> تكوين TokenLab كموفر مخصص في OpenClaw باستخدام مسارات متوافقة مع OpenAI وResponses وAnthropic وGemini

<Note>
  هذا الدليل مخصّص لمستخدمي **OpenClaw المستضاف محليًا (self-hosted)** الذين يرغبون في ربط TokenLab كمزوِّد AI خاص بهم.
</Note>

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

لتشغيل وكلاء OpenClaw بالطريقة القياسية، ثبّت إضافة موفر TokenLab:

```bash theme={null}
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
```

تجلب الإضافة دليل نماذج المحادثة المباشر من TokenLab، وتحتفظ بـ 18 نموذجًا احتياطيًا للاكتشاف دون اتصال. تستخدم النماذج التنسيق `tokenlab/<model-id>`.

[حزمة npm](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [صفحة ClawHub](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [الشيفرة المصدرية](https://github.com/hedging8563/tokenlab-openclaw-provider)

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

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

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

| المزوّد              | OpenClaw `api`         | الأفضل لـ                                                     | baseUrl                      |
| -------------------- | ---------------------- | ------------------------------------------------------------- | ---------------------------- |
| `tokenlab`           | `openai-completions`   | GPT وDeepSeek وQwen ومعظم الاستدعاءات المتوافقة مع OpenAI     | `https://api.tokenlab.sh/v1` |
| `tokenlab-responses` | `openai-responses`     | تدفقات عمل OpenAI Responses التي تتوقع دلالات `/v1/responses` | `https://api.tokenlab.sh/v1` |
| `tokenlab-claude`    | `anthropic-messages`   | واجهة Claude Messages الأصلية                                 | `https://api.tokenlab.sh`    |
| `tokenlab-gemini`    | `google-generative-ai` | صيغة Gemini الأصلية                                           | `https://api.tokenlab.sh`    |
| `tokenlab-minimax`   | `anthropic-messages`   | توجيه MiniMax الأصلي                                          | `https://api.tokenlab.sh`    |

<Warning>
  استخدم اللاحقة `/v1` فقط مع `openai-completions` و`openai-responses`.

  يجب أن تستخدم الموفرات الأصلية مثل `anthropic-messages` و`google-generative-ai` `https://api.tokenlab.sh` بدون `/v1`، وإلا فقد ينشئ OpenClaw مسارًا علويًا غير صحيح.
</Warning>

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

* مثيل OpenClaw مستضاف محليًا (self-hosted)
* مفتاح API من TokenLab — [Get one here](https://tokenlab.sh/dashboard)

## التكوين

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

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

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

```json5 theme={null}
{
  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" }
        ]
      }
    }
  }
}
```

<Info>
  جميع الموفرين الخمسة يستخدمون **نفس مفتاح API**. تحتاج لحساب TokenLab واحد فقط.
</Info>

<Info>
  قوائم `models` أعلاه تعرض أمثلة شائعة فقط. أضف المزيد من معرفات النماذج لكل موفر حسب الحاجة.
</Info>

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

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

```json5 theme={null}
{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-3.5-flash"
      }
    }
  }
}
```

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

| المزوّد              | مرجع النموذج                        | الوصف                       |
| -------------------- | ----------------------------------- | --------------------------- |
| `tokenlab`           | `tokenlab/gpt-4o`                   | مسار متوافق مع OpenAI       |
| `tokenlab`           | `tokenlab/deepseek-r1`              | نموذج استدلال DeepSeek      |
| `tokenlab-responses` | `tokenlab-responses/gpt-4o`         | مسار Responses API          |
| `tokenlab-claude`    | `tokenlab-claude/claude-sonnet-4-6` | مسار Claude Messages الأصلي |
| `tokenlab-gemini`    | `tokenlab-gemini/gemini-3.5-flash`  | مسار Gemini الأصلي          |
| `tokenlab-minimax`   | `tokenlab-minimax/minimax-m3`       | مسار MiniMax الأصلي         |

تصفّح جميع النماذج المتاحة على [tokenlab.sh/models](https://tokenlab.sh/ar/models).

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

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

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

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

<AccordionGroup>
  <Accordion title="لا تزال تستخدم مصفوفة الموفرين القديمة على المستوى العلوي">
    تستخدم وثائق OpenClaw الحالية `models.providers`. إذا احتفظت بالتنسيق القديم لمصفوفة `providers` على المستوى العلوي، فقد يتجاهل OpenClaw التهيئة أو يفشل في حل بادئات الموفر كما هو متوقع.
  </Accordion>

  <Accordion title="نسيان /v1 على tokenlab-responses">
    تقوم `openai-responses` بالتوجيه إلى مسار `/v1/responses` الخاص بـ TokenLab، لذلك يجب أن يستخدم `tokenlab-responses` `https://api.tokenlab.sh/v1`.
  </Accordion>

  <Accordion title="إضافة /v1 إلى tokenlab-claude أو tokenlab-gemini أو tokenlab-minimax">
    يجب أن تستخدم `anthropic-messages` و`google-generative-ai` `https://api.tokenlab.sh` بدون `/v1`. إضافة `/v1` يمكن أن تُنتج مسارات طلب غير صحيحة.
  </Accordion>

  <Accordion title="هل لا يزال OpenClaw يدعم Gemini الأصلي؟">
    نعم. لا تزال وثائق OpenClaw الحالية تتضمن الموفر المدمج `google` وتدعم أيضًا الموفرات المخصصة باستخدام `api: "google-generative-ai"`. لذا يظل `tokenlab-gemini` مسار Gemini أصليًا صالحًا لمستخدمي OpenClaw.
  </Accordion>
</AccordionGroup>

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

بعد حفظ التهيئة، أعد تشغيل مثيل OpenClaw الخاص بك واختبر برسالة بسيطة. إذا رأيت استجابة، فالمزوّد مكوّن بشكل صحيح.

```bash theme={null}
# مستضاف ذاتيًا: أعد تشغيل الخدمة
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS
```

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

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

* [تنسيقات API](/guides/api-formats) — فهم الفروقات بين مسارات OpenAI وResponses وAnthropic وGemini
* [IDE / SDK Compatibility](/guides/ide-sdk-compatibility) — متى يكون `/v1/responses` الخيار الأنسب
* [معالجة الأخطاء](/guides/error-handling) — تعرّف على أنماط الفشل الشائعة واستراتيجيات التعافي
* [نظرة عامة على النماذج](https://tokenlab.sh/ar/models) — تصفّح معرفات النماذج قبل توصيلها بالوكلاء