> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Featherless AI

[Featherless AI](https://featherless.ai) stellt offene Modelle über eine
OpenAI-kompatible API bereit. OpenClaw installiert Featherless als offizielles externes
Provider-Plugin und hält den integrierten Katalog klein, akzeptiert jedoch zur Laufzeit exakte
Modell-IDs von Featherless.

| Eigenschaft                                 | Wert                                     |
| ------------------------------------------- | ---------------------------------------- |
| Provider-ID                                 | `featherless`                            |
| Paket                                       | `@openclaw/featherless-provider`         |
| Umgebungsvariable für die Authentifizierung | `FEATHERLESS_API_KEY`                    |
| Onboarding-Flag                             | `--auth-choice featherless-api-key`      |
| Direktes CLI-Flag                           | `--featherless-api-key <key>`            |
| API                                         | OpenAI-kompatibel (`openai-completions`) |
| Basis-URL                                   | `https://api.featherless.ai/v1`          |
| Standardmodell                              | `featherless/Qwen/Qwen3-32B`             |

## Einrichtung

Installieren Sie das Plugin und starten Sie den Gateway neu:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/featherless-provider
openclaw gateway restart
```

Führen Sie das Onboarding aus:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice featherless-api-key
```

Für eine nicht interaktive Einrichtung:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice featherless-api-key \
  --featherless-api-key "$FEATHERLESS_API_KEY"
```

Oder stellen Sie den Schlüssel dem Gateway-Prozess bereit:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export FEATHERLESS_API_KEY="<your-featherless-api-key>" # pragma: allowlist secret
```

Überprüfen Sie den Provider:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider featherless
```

## Standardmodell

Das Plugin verwendet `Qwen/Qwen3-32B` als Einrichtungsstandard, da Featherless
native Tool-Aufrufe für die Qwen-3-Familie dokumentiert. OpenClaw konfiguriert deren
Kontextfenster mit 32.768 Token, ein konservatives Ausgabelimit von 4.096 Token sowie
Thinking-Steuerelemente für die Qwen-Chatvorlage.

Die Kostenfelder des Katalogs sind auf null gesetzt, da Featherless mehrere Abrechnungsmodelle
unterstützt und OpenClaw keine kontospezifischen Tarife oder Preise pro Anfrage
einbettet.

## Weitere Featherless-Modelle

Verwenden Sie die exakte Featherless-Modell-ID nach dem Provider-Präfix `featherless/`:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: {
        primary: "featherless/moonshotai/Kimi-K2-Instruct",
      },
    },
  },
}
```

OpenClaw übernimmt den vollständigen öffentlichen Modellindex von Featherless bewusst nicht in
die Modellauswahl. Der Index ist umfangreich und stellt nicht genügend strukturierte Metadaten zu
Fähigkeiten bereit, um jedes Text-, Bildverarbeitungs-, Embedding- und Reasoning-Modell sicher zu klassifizieren.
Unbekannte IDs werden daher mit konservativen Standardwerten für reine Textverarbeitung ohne Reasoning
aufgelöst: einem Kontextfenster mit 4.096 Token und einem Ausgabelimit von 1.024 Token.

Fügen Sie einen expliziten Provider-Modelleintrag hinzu, wenn ein Modell andere Metadaten benötigt:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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,
          },
        ],
      },
    },
  },
}
```

Prüfen Sie vor dem Hinzufügen benutzerdefinierter Metadaten im Modellkatalog von Featherless
die aktuelle Modellverfügbarkeit und die Fähigkeits-Tags.

## Fehlerbehebung

* `401` oder `403`: Stellen Sie sicher, dass `FEATHERLESS_API_KEY` für den Gateway-
  Prozess sichtbar ist, oder führen Sie das Onboarding erneut aus.
* Unbekanntes Modell: Verwenden Sie nach dem Präfix
  `featherless/` die exakte, zwischen Groß- und Kleinschreibung unterscheidende ID von Featherless.
* Tool-Aufrufe werden als Text zurückgegeben: Wählen Sie eine Modellfamilie, für die Featherless
  native Funktionsaufrufe dokumentiert, beispielsweise Qwen 3.
* Der verwaltete Gateway kann nicht auf den Schlüssel zugreifen: Hinterlegen Sie ihn in `~/.openclaw/.env` oder einer anderen
  vom Dienst geladenen Umgebungsquelle und starten Sie anschließend den Gateway neu.

## Verwandte Themen

* [Modell-Provider](/de/concepts/model-providers)
* [Alle Provider](/de/providers/index)
* [Thinking-Modi](/de/tools/thinking)