Providers
Hugging Face（推論）
Hugging Face Inference Providers は、多数のホスト型モデル（DeepSeek、Llama など）の前段に、1 つのトークンで利用できる OpenAI 互換のチャット補完ルーターを提供します。OpenClaw が通信するのはチャット補完エンドポイントのみです。テキストから画像への変換、埋め込み、音声には、HF inference clients を直接使用してください。
| プロパティ | 値 |
|---|---|
| プロバイダー ID | huggingface |
| Plugin | バンドル済み（デフォルトで有効、インストール手順は不要） |
| 認証環境変数 | HUGGINGFACE_HUB_TOKEN または HF_TOKEN（きめ細かなトークン） |
| API | OpenAI 互換（https://router.huggingface.co/v1） |
| 課金 | 単一の HF トークン。料金は無料枠付きでプロバイダーの料金体系に従います |
はじめに
きめ細かなトークンを作成
Hugging Face Settings Tokens に移動し、新しいきめ細かなトークンを作成します。
オンボーディングを実行
プロバイダーのドロップダウンで Hugging Face を選択し、プロンプトが表示されたら API キーを入力します。
openclaw onboard --auth-choice huggingface-api-keyデフォルトモデルを選択
Default Hugging Face model ドロップダウンでモデルを選択します。トークンが有効な場合、リストは Inference API から読み込まれます。それ以外の場合、OpenClaw は以下の組み込みカタログを表示します。選択内容は agents.defaults.model.primary として保存されます。
{ agents: { defaults: { model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" }, }, },}モデルが利用可能か確認
openclaw models list --provider huggingface非対話型セットアップ
openclaw onboard --non-interactive \ --mode local \ --auth-choice huggingface-api-key \ --huggingface-api-key "$HF_TOKEN"huggingface/deepseek-ai/DeepSeek-R1 をデフォルトモデルとして設定します。
モデル ID
モデル参照は huggingface/<org>/<model> の形式（Hub 形式の ID）を使用します。OpenClaw の組み込みカタログは次のとおりです。
| モデル | 参照（先頭に huggingface/ を付加） |
|---|---|
| DeepSeek R1 | deepseek-ai/DeepSeek-R1 |
| DeepSeek V3.1 | deepseek-ai/DeepSeek-V3.1 |
| GPT-OSS 120B | openai/gpt-oss-120b |
高度な設定
モデル検出とオンボーディングのドロップダウン
OpenClaw は次のリクエストでモデルを検出します。
GET https://router.huggingface.co/v1/modelsAuthorization: Bearer $HUGGINGFACE_HUB_TOKEN # または $HF_TOKENレスポンスは OpenAI 形式の { "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] } です。
キーが設定されている場合（オンボーディング、HUGGINGFACE_HUB_TOKEN、または HF_TOKEN）、対話型セットアップ中の Default Hugging Face model ドロップダウンには、このエンドポイントから取得した内容が入力されます。Gateway の起動時にも同じ呼び出しを繰り返してカタログを更新します。検出されたモデルは上記の組み込みカタログとマージされます（ID が一致する場合、コンテキストウィンドウやコストなどのメタデータに使用されます）。リクエストが失敗する、データが返されない、またはキーが設定されていない場合、OpenClaw は組み込みカタログのみにフォールバックします。
プロバイダーを削除せずに検出を無効化するには、次を実行します。
openclaw config set plugins.entries.huggingface.config.discovery.enabled falseモデル名、エイリアス、ポリシーサフィックス
- API からの名前: 検出されたモデルでは、API の
name、title、またはdisplay_nameが存在する場合はそれを使用します。それ以外の場合、OpenClaw はモデル ID から名前を生成します（例:deepseek-ai/DeepSeek-R1は「DeepSeek R1」になります）。 - 表示名の上書き: 設定でモデルごとにカスタムラベルを設定します。
{ agents: { defaults: { models: { "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1 (fast)" }, "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheap)" }, }, }, },}- ポリシーサフィックス:
:fastestと:cheapestは HF ルーターの規則であり、OpenClaw が書き換えるものではありません。サフィックスはモデル ID の一部としてそのまま送信され、HF のルーターが一致する推論プロバイダーを選択します。サフィックスごとに異なるエイリアスを使用する場合は、各バリアントをmodels.providers.huggingface.models（またはmodel.primary）の下に個別のエントリとして追加してください。 - 設定のマージ:
models.providers.huggingface.models内の既存エントリ（例:models.json内）は設定のマージ時にも保持されるため、そこで設定したカスタムのname、alias、またはモデルオプションは再起動後も維持されます。
環境とデーモンのセットアップ
Gateway がデーモン（launchd/systemd）として実行される場合、そのプロセスで HUGGINGFACE_HUB_TOKEN または HF_TOKEN を利用できることを確認してください（たとえば、~/.openclaw/.env 内または env.shellEnv 経由）。
設定: フォールバック付き DeepSeek R1
{ agents: { defaults: { model: { primary: "huggingface/deepseek-ai/DeepSeek-R1", fallbacks: ["huggingface/openai/gpt-oss-120b"], }, models: { "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1" }, "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" }, }, }, },}設定: 最安および最速バリアントを使用する DeepSeek
{ agents: { defaults: { model: { primary: "huggingface/deepseek-ai/DeepSeek-R1" }, models: { "huggingface/deepseek-ai/DeepSeek-R1": { alias: "DeepSeek R1" }, "huggingface/deepseek-ai/DeepSeek-R1:cheapest": { alias: "DeepSeek R1 (cheapest)" }, "huggingface/deepseek-ai/DeepSeek-R1:fastest": { alias: "DeepSeek R1 (fastest)" }, }, }, },}設定: エイリアス付き DeepSeek + GPT-OSS
{ agents: { defaults: { model: { primary: "huggingface/deepseek-ai/DeepSeek-V3.1", fallbacks: ["huggingface/openai/gpt-oss-120b"], }, models: { "huggingface/deepseek-ai/DeepSeek-V3.1": { alias: "DeepSeek V3.1" }, "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" }, }, }, },}