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

# Featherless AI

[Featherless AI](https://featherless.ai) يوفّر النماذج المفتوحة عبر واجهة API
متوافقة مع OpenAI. يثبّت OpenClaw ‏Featherless بوصفه Plugin موفّر خارجيًا رسميًا،
ويبقي الكتالوج المضمّن صغيرًا مع قبول معرّفات النماذج الدقيقة من Featherless في وقت التشغيل.

| الخاصية              | القيمة                                   |
| -------------------- | ---------------------------------------- |
| معرّف الموفّر        | `featherless`                            |
| الحزمة               | `@openclaw/featherless-provider`         |
| متغير بيئة المصادقة  | `FEATHERLESS_API_KEY`                    |
| علامة الإعداد الأولي | `--auth-choice featherless-api-key`      |
| علامة CLI المباشرة   | `--featherless-api-key <key>`            |
| واجهة API            | متوافقة مع OpenAI (`openai-completions`) |
| عنوان URL الأساسي    | `https://api.featherless.ai/v1`          |
| النموذج الافتراضي    | `featherless/Qwen/Qwen3-32B`             |

## الإعداد

ثبّت Plugin وأعد تشغيل Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/featherless-provider
openclaw gateway restart
```

شغّل الإعداد الأولي:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice featherless-api-key
```

للإعداد غير التفاعلي:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice featherless-api-key \
  --featherless-api-key "$FEATHERLESS_API_KEY"
```

أو أتح المفتاح لعملية Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export FEATHERLESS_API_KEY="<your-featherless-api-key>" # pragma: allowlist secret
```

تحقّق من الموفّر:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider featherless
```

## النموذج الافتراضي

يستخدم Plugin النموذج `Qwen/Qwen3-32B` بوصفه الإعداد الافتراضي لأن Featherless
يوثّق الاستدعاء الأصلي للأدوات لعائلة Qwen 3. يضبط OpenClaw نافذة السياق الخاصة به
على 32,768 رمزًا، وحدًا متحفظًا للإخراج يبلغ 4,096 رمزًا، وعناصر التحكم في التفكير
الخاصة بقالب محادثة Qwen.

حقول التكلفة في الكتالوج تساوي صفرًا لأن Featherless يدعم أوضاع فوترة متعددة،
ولأن OpenClaw لا يضمّن أسعار الخطط الخاصة بالحساب أو أسعار الطلبات.

## نماذج Featherless الأخرى

استخدم معرّف نموذج Featherless الدقيق بعد بادئة الموفّر `featherless/`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: {
        primary: "featherless/moonshotai/Kimi-K2-Instruct",
      },
    },
  },
}
```

يتعمّد OpenClaw عدم نسخ فهرس نماذج Featherless العام بالكامل إلى أداة الاختيار.
الفهرس كبير ولا يوفّر بيانات وصفية منظّمة كافية للقدرات لتصنيف كل نموذج نصوص
ورؤية وتضمين واستدلال بأمان. لذلك تُحلّ المعرّفات غير المعروفة باستخدام إعدادات
افتراضية متحفظة للنصوص فقط ومن دون استدلال: نافذة سياق بسعة 4,096 رمزًا وحد إخراج
بسعة 1,024 رمزًا.

أضف إدخالًا صريحًا لنموذج الموفّر عندما يحتاج النموذج إلى بيانات وصفية مختلفة:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  models: {
    mode: "merge",
    providers: {
      featherless: {
        baseUrl: "https://api.featherless.ai/v1",
        apiKey: "${FEATHERLESS_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "google/gemma-3-27b-it",
            name: "Gemma 3 27B",
            input: ["text", "image"],
            reasoning: false,
            contextWindow: 32768,
            maxTokens: 4096,
          },
        ],
      },
    },
  },
}
```

راجع كتالوج نماذج Featherless لمعرفة مدى توفّر النماذج الحالي ووسوم القدرات
قبل إضافة بيانات وصفية مخصّصة.

## استكشاف الأخطاء وإصلاحها

* `401` أو `403`: تأكّد من أن `FEATHERLESS_API_KEY` مرئي لعملية Gateway،
  أو شغّل الإعداد الأولي مجددًا.
* نموذج غير معروف: استخدم المعرّف الدقيق الحساس لحالة الأحرف من Featherless بعد
  البادئة `featherless/`.
* عودة استدعاءات الأدوات كنص: اختر عائلة نماذج يوثّق Featherless دعمها للاستدعاء
  الأصلي للدوال، مثل Qwen 3.
* يتعذّر على Gateway المُدار رؤية المفتاح: ضعه في `~/.openclaw/.env` أو مصدر بيئة
  آخر تحمّله الخدمة، ثم أعد تشغيل Gateway.

## ذو صلة

* [موفّرو النماذج](/ar/concepts/model-providers)
* [جميع الموفّرين](/ar/providers/index)
* [أوضاع التفكير](/ar/tools/thinking)