跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

Featherless AI

Featherless AI 设置、模型选择和工具调用

Featherless AI 通过兼容 OpenAI 的 API 提供开放模型。OpenClaw 将 Featherless 安装为官方外部提供商插件，在保持内置目录精简的同时，支持在运行时接收 Featherless 的精确模型 ID。

属性值
提供商 IDfeatherless
软件包@openclaw/featherless-provider
身份验证环境变量FEATHERLESS_API_KEY
新手引导标志--auth-choice featherless-api-key
直接 CLI 标志--featherless-api-key <key>
API兼容 OpenAI（openai-completions）
基础 URLhttps://api.featherless.ai/v1
默认模型featherless/Qwen/Qwen3-32B

设置

安装插件并重启 Gateway 网关：

openclaw plugins install @openclaw/featherless-provider
openclaw 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 网关。

相关内容