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 را بازراهاندازی کنید:
openclaw plugins install @openclaw/featherless-provideropenclaw gateway restartراهاندازی اولیه را اجرا کنید:
openclaw onboard --auth-choice featherless-api-keyبرای راهاندازی غیرتعاملی:
openclaw onboard --non-interactive \ --mode local \ --auth-choice featherless-api-key \ --featherless-api-key "$FEATHERLESS_API_KEY"یا کلید را در دسترس فرایند Gateway قرار دهید:
export FEATHERLESS_API_KEY="<your-featherless-api-key>" # pragma: allowlist secretارائهدهنده را تأیید کنید:
openclaw models list --provider featherlessمدل پیشفرض
Plugin از Qwen/Qwen3-32B بهعنوان پیشفرض راهاندازی استفاده میکند، زیرا Featherless
فراخوانی بومی ابزار را برای خانواده Qwen 3 مستند کرده است. OpenClaw پنجره زمینه
32,768 توکنی، محدودیت محافظهکارانه خروجی 4,096 توکنی و
کنترلهای تفکر الگوی گفتوگوی Qwen را پیکربندی میکند.
فیلدهای هزینه کاتالوگ صفر هستند، زیرا Featherless از چندین حالت صورتحساب پشتیبانی میکند و OpenClaw نرخهای مختص طرح حساب یا قیمتگذاری هر درخواست را درون خود جای نمیدهد.
سایر مدلهای Featherless
پس از پیشوند ارائهدهنده featherless/، از شناسه دقیق مدل Featherless استفاده کنید:
{ agents: { defaults: { model: { primary: "featherless/moonshotai/Kimi-K2-Instruct", }, }, },}OpenClaw عمداً فهرست عمومی کامل مدلهای Featherless را در انتخابگر کپی نمیکند. این فهرست بزرگ است و فراداده قابلیت ساختاریافته کافی برای دستهبندی ایمن همه مدلهای متنی، بینایی، تعبیهسازی و استدلالی ارائه نمیدهد. بنابراین، شناسههای ناشناخته با پیشفرضهای محافظهکارانه صرفاً متنی و غیراستدلالی تفکیک میشوند: پنجره زمینه 4,096 توکنی و محدودیت خروجی 1,024 توکنی.
وقتی مدلی به فراداده متفاوتی نیاز دارد، یک ورودی صریح مدل ارائهدهنده اضافه کنید:
{ 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 را بازراهاندازی کنید.