---
read_when:
    - می‌خواهید از Featherless AI با OpenClaw استفاده کنید
    - به متغیر محیطی کلید API سرویس Featherless یا قالب ارجاع مدل نیاز دارید
summary: راه‌اندازی Featherless AI، انتخاب مدل و فراخوانی ابزارها
title: Featherless AI
x-i18n:
    generated_at: "2026-07-12T10:40:45Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 9112f7e65b4089bf96933c632d0b62f7fb87d42998d985ca85eb92dc392636b6
    source_path: providers/featherless.md
    workflow: 16
---

[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`) |
| نشانی پایه               | `https://api.featherless.ai/v1`          |
| مدل پیش‌فرض              | `featherless/Qwen/Qwen3-32B`             |

## راه‌اندازی

Plugin را نصب و Gateway را بازراه‌اندازی کنید:

```bash
openclaw plugins install @openclaw/featherless-provider
openclaw gateway restart
```

راه‌اندازی اولیه را اجرا کنید:

```bash
openclaw onboard --auth-choice featherless-api-key
```

برای راه‌اندازی غیرتعاملی:

```bash
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice featherless-api-key \
  --featherless-api-key "$FEATHERLESS_API_KEY"
```

یا کلید را در دسترس فرایند Gateway قرار دهید:

```bash
export FEATHERLESS_API_KEY="<your-featherless-api-key>" # pragma: allowlist secret
```

ارائه‌دهنده را تأیید کنید:

```bash
openclaw models list --provider featherless
```

## مدل پیش‌فرض

این Plugin از `Qwen/Qwen3-32B` به‌عنوان مدل پیش‌فرض راه‌اندازی استفاده می‌کند، زیرا مستندات Featherless فراخوانی بومی ابزار را برای خانوادهٔ Qwen 3 ذکر می‌کنند. OpenClaw پنجرهٔ بافت ۳۲٬۷۶۸ توکنی، محدودیت محافظه‌کارانهٔ خروجی ۴٬۰۹۶ توکنی و کنترل‌های تفکر الگوی گفت‌وگوی Qwen را برای آن پیکربندی می‌کند.

فیلدهای هزینه در فهرست صفر هستند، زیرا Featherless از چندین شیوهٔ صورت‌حساب پشتیبانی می‌کند و OpenClaw نرخ‌های مختص طرح حساب یا قیمت‌گذاری هر درخواست را در خود جای نمی‌دهد.

## سایر مدل‌های Featherless

شناسهٔ دقیق مدل Featherless را پس از پیشوند ارائه‌دهندهٔ `featherless/` استفاده کنید:

```json5
{
  agents: {
    defaults: {
      model: {
        primary: "featherless/moonshotai/Kimi-K2-Instruct",
      },
    },
  },
}
```

OpenClaw عمداً نمایهٔ عمومی کامل مدل‌های Featherless را در انتخابگر کپی نمی‌کند. این نمایه بزرگ است و فرادادهٔ ساخت‌یافتهٔ کافی برای طبقه‌بندی ایمن همهٔ مدل‌های متن، بینایی، تعبیه‌سازی و استدلال ارائه نمی‌کند. بنابراین، شناسه‌های ناشناخته با پیش‌فرض‌های محافظه‌کارانهٔ فقط‌متنی و بدون استدلال تفکیک می‌شوند: پنجرهٔ بافت ۴٬۰۹۶ توکنی و محدودیت خروجی ۱٬۰۲۴ توکنی.

اگر مدلی به فرادادهٔ متفاوتی نیاز دارد، یک ورودی صریح برای مدل ارائه‌دهنده اضافه کنید:

```json5
{
  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 را بازراه‌اندازی کنید.

## مرتبط

- [ارائه‌دهندگان مدل](/fa/concepts/model-providers)
- [همهٔ ارائه‌دهندگان](/fa/providers/index)
- [حالت‌های تفکر](/fa/tools/thinking)