---
read_when:
    - Sie möchten Featherless AI mit OpenClaw verwenden
    - Sie benötigen die Umgebungsvariable für den Featherless-API-Schlüssel oder das Modellreferenzformat
summary: Einrichtung von Featherless AI, Modellauswahl und Tool-Aufrufe
title: Featherless AI
x-i18n:
    generated_at: "2026-07-26T18:01:24Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 9112f7e65b4089bf96933c632d0b62f7fb87d42998d985ca85eb92dc392636b6
    source_path: providers/featherless.md
    workflow: 16
---

[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
openclaw plugins install @openclaw/featherless-provider
openclaw gateway restart
```

Führen Sie das Onboarding aus:

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

Für eine nicht interaktive Einrichtung:

```bash
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
export FEATHERLESS_API_KEY="<your-featherless-api-key>" # pragma: allowlist secret
```

Überprüfen Sie den Provider:

```bash
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
{
  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
{
  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)