Featherless AI

Featherless AI는 OpenAI 호환 API를 통해 오픈 모델을 제공합니다. OpenClaw는 Featherless를 공식 외부 제공자 Plugin으로 설치하며, 기본 제공 카탈로그는 작게 유지하는 동시에 런타임에 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`

설정

Plugin을 설치하고 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

기본 모델

Featherless가 Qwen 3 계열의 네이티브 도구 호출을 명시하고 있으므로, Plugin은 설정 기본값으로 Qwen/Qwen3-32B를 사용합니다. OpenClaw는 32,768토큰 컨텍스트 창, 보수적인 4,096토큰 출력 제한, Qwen 채팅 템플릿의 사고 제어 기능을 구성합니다. Featherless는 여러 결제 방식을 지원하며 OpenClaw는 계정별 요금제 또는 요청별 가격을 포함하지 않으므로, 카탈로그의 비용 필드는 0입니다.

기타 Featherless 모델

featherless/ 제공자 접두사 뒤에 정확한 Featherless 모델 ID를 사용합니다.

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

OpenClaw는 Featherless의 전체 공개 모델 인덱스를 선택기에 의도적으로 복사하지 않습니다. 인덱스가 크고 모든 텍스트, 비전, 임베딩 및 추론 모델을 안전하게 분류하기에 충분한 구조화된 기능 메타데이터를 제공하지 않기 때문입니다. 따라서 알 수 없는 ID는 보수적인 텍스트 전용 비추론 기본값인 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의 정확한 대소문자 구분 ID를 사용하세요.
도구 호출이 텍스트로 반환됨: Qwen 3처럼 Featherless가 네이티브 함수 호출을 명시한 모델 계열을 선택하세요.
관리형 Gateway에서 키를 인식하지 못함: ~/.openclaw/.env 또는 서비스가 로드하는 다른 환경 소스에 키를 넣은 다음 Gateway를 다시 시작하세요.

Overview

Concepts and configuration

Providers

설정

기본 모델

기타 Featherless 모델

문제 해결

관련 문서

​설정

​기본 모델

​기타 Featherless 모델

​문제 해결

​관련 문서

설정

기본 모델

기타 Featherless 모델

문제 해결

관련 문서