快速开始
Featherless AI
Featherless AI 通过兼容 OpenAI 的 API 提供开放模型。OpenClaw 将 Featherless 安装为官方外部提供商插件，在保持内置目录精简的同时，允许运行时使用 Featherless 的准确模型 ID。
| 属性 | 值 |
|---|---|
| 提供商 ID | 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 |
设置
安装插件并重启 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默认模型
该插件使用 Qwen/Qwen3-32B 作为设置时的默认模型，因为 Featherless 文档说明 Qwen 3 系列支持原生工具调用。OpenClaw 为其配置 32,768 个 token 的上下文窗口、保守的 4,096 个 token 输出上限，以及 Qwen 聊天模板的思考控制项。
目录中的成本字段为零，因为 Featherless 支持多种计费模式，而 OpenClaw 不会嵌入特定于账户的套餐费率或按请求计价费率。
其他 Featherless 模型
在 featherless/ 提供商前缀后使用准确的 Featherless 模型 ID：
{ agents: { defaults: { model: { primary: "featherless/moonshotai/Kimi-K2-Instruct", }, }, },}OpenClaw 有意不将 Featherless 的完整公共模型索引复制到选择器中。该索引规模庞大，并且未提供足够的结构化能力元数据，无法安全地对每个文本、视觉、嵌入和推理模型进行分类。因此，未知 ID 会使用保守的纯文本、非推理默认配置：4,096 个 token 的上下文窗口和 1,024 个 token 的输出上限。
当模型需要不同的元数据时，请添加明确的提供商模型条目：
{ 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：确认 Gateway 网关进程可以访问FEATHERLESS_API_KEY，或重新运行新手引导。- 未知模型：在
featherless/前缀后使用 Featherless 提供的准确且区分大小写的 ID。 - 工具调用以文本形式返回：选择 Featherless 文档中说明支持原生函数调用的模型系列，例如 Qwen 3。
- 托管式 Gateway 网关无法访问密钥：将其放入
~/.openclaw/.env或该服务加载的其他环境来源中，然后重启 Gateway 网关。
相关内容
Was this useful?
