Providers

Featherless AI

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-provideropenclaw 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 پنجره زمینه 32,768 توکنی، محدودیت محافظه‌کارانه خروجی 4,096 توکنی و کنترل‌های تفکر الگوی گفت‌وگوی Qwen را پیکربندی می‌کند.

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

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

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

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

OpenClaw عمداً فهرست عمومی کامل مدل‌های Featherless را در انتخاب‌گر کپی نمی‌کند. این فهرست بزرگ است و فراداده قابلیت ساختاریافته کافی برای دسته‌بندی ایمن همه مدل‌های متنی، بینایی، تعبیه‌سازی و استدلالی ارائه نمی‌دهد. بنابراین، شناسه‌های ناشناخته با پیش‌فرض‌های محافظه‌کارانه صرفاً متنی و غیراستدلالی تفکیک می‌شوند: پنجره زمینه 4,096 توکنی و محدودیت خروجی 1,024 توکنی.

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

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

مرتبط

Was this useful?
On this page

On this page