> ## 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) は、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 を再起動します。

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

オンボーディングを実行します。

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

非対話型セットアップの場合：

```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"
```

または、キーを Gateway プロセスに公開します。

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

プロバイダーを確認します。

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

## デフォルトモデル

Featherless が Qwen 3 ファミリーのネイティブなツール呼び出しを文書化しているため、この Plugin はセットアップ時のデフォルトとして `Qwen/Qwen3-32B` を使用します。OpenClaw は、32,768 トークンのコンテキストウィンドウ、控えめな 4,096 トークンの出力上限、および Qwen チャットテンプレートの思考制御を設定します。

Featherless は複数の課金方式をサポートしており、OpenClaw はアカウント固有のプラン料金やリクエスト料金を組み込まないため、カタログのコストフィールドはゼロです。

## その他の Featherless モデル

`featherless/` プロバイダープレフィックスの後に、正確な Featherless モデル ID を指定します。

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

OpenClaw は、Featherless の完全な公開モデルインデックスを意図的にピッカーへコピーしません。このインデックスは規模が大きく、すべてのテキスト、ビジョン、埋め込み、推論モデルを安全に分類するために十分な構造化された機能メタデータを公開していません。そのため、不明な ID は保守的なテキスト専用・非推論のデフォルト設定、つまり 4,096 トークンのコンテキストウィンドウと 1,024 トークンの出力上限で解決されます。

モデルに異なるメタデータが必要な場合は、明示的なプロバイダーモデルエントリを追加します。

```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,
          },
        ],
      },
    },
  },
}
```

カスタムメタデータを追加する前に、Featherless のモデルカタログで現在のモデルの提供状況と機能タグを確認してください。

## トラブルシューティング

* `401` または `403`：`FEATHERLESS_API_KEY` が Gateway プロセスから参照可能であることを確認するか、オンボーディングを再実行してください。
* 不明なモデル：Featherless の ID を、大文字と小文字を正確に区別して `featherless/` プレフィックスの後に指定してください。
* ツール呼び出しがテキストとして返される：Qwen 3 など、Featherless がネイティブ関数呼び出し対応として文書化しているモデルファミリーを選択してください。
* 管理対象 Gateway からキーを参照できない：キーを `~/.openclaw/.env` またはサービスが読み込む別の環境ソースに配置し、Gateway を再起動してください。

## 関連項目

* [モデルプロバイダー](/ja-JP/concepts/model-providers)
* [すべてのプロバイダー](/ja-JP/providers/index)
* [思考モード](/ja-JP/tools/thinking)