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`

设置¶

安装插件：

openclaw plugins install @openclaw/featherless-provider

安装会自动应用于正在运行的 Gateway；否则，它将在下次启动时生效。参见应用更改并检查。

运行引导：

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

对于非交互式设置：

openclaw onboard --non-interactive --accept-risk --skip-health \
  --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 公布的请求定价费率：每百万输入 token 0.102 美元，每百万输出 token 0.493 美元。固定订阅计划仍为固定费率；缓存成本字段保持为零，因为 Featherless 未为此模型公布单独的缓存读取或缓存写入费率。

其他 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：确认 FEATHERLESS_API_KEY 对 Gateway 进程可见，或重新运行引导。
未知模型：在 featherless/ 前缀后使用来自 Featherless 的精确区分大小写的 ID。
工具调用以文本返回：选择 Featherless 文档中支持原生函数调用的模型系列，例如 Qwen 3。
托管 Gateway 无法看到密钥：将其放入 ~/.openclaw/.env 或服务加载的其他环境源中，然后重启 Gateway。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw

Featherless AI

设置¶

默认模型¶

其他 Featherless 模型¶

故障排查¶

相关¶