Providers
Hugging Face（推論）
Hugging Face Inference Providers は、1つのトークンで多数のホスト型モデル（DeepSeek、Llama など）を利用できる、OpenAI 互換のチャット補完ルーターを提供します。OpenClaw が使用するのはチャット補完エンドポイントのみです。テキストからの画像生成、埋め込み、音声には、HF 推論クライアントを直接使用してください。
| プロパティ | 値 |
|---|---|
| プロバイダー ID | huggingface |
| Plugin | 同梱（デフォルトで有効、インストール手順なし） |
| 認証環境変数 | HUGGINGFACE_HUB_TOKEN または HF_TOKEN（きめ細かなトークン） |
| API | OpenAI 互換（https://router.huggingface.co/v1） |
| 課金 | 1つの HF トークンを使用。料金は無料枠付きでプロバイダーの料金に準拠 |
はじめに
きめ細かなトークンを作成する
Hugging Face Settings Tokens に移動し、新しいきめ細かなトークンを作成します。
オンボーディングを実行する
プロバイダーのドロップダウンで Hugging Face を選択し、プロンプトが表示されたら API キーを入力します。
openclaw onboard --auth-choice huggingface-api-keyデフォルトモデルを選択する
デフォルトの Hugging Face モデルドロップダウンでモデルを選択します。トークンが有効な場合、リストは 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 |
| Llama 3.3 70B Instruct Turbo | meta-llama/Llama-3.3-70B-Instruct-Turbo |
高度な設定
モデル検出とオンボーディングのドロップダウン
OpenClaw は次のリクエストでモデルを検出します。
GET https://router.huggingface.co/v1/modelsAuthorization: Bearer $HUGGINGFACE_HUB_TOKEN # or $HF_TOKENレスポンスは OpenAI 形式です：{ "object": "list", "data": [ { "id": "Qwen/Qwen3-8B", "owned_by": "Qwen", ... }, ... ] }。
キー（オンボーディング、HUGGINGFACE_HUB_TOKEN、または HF_TOKEN）が設定されている場合、対話型セットアップ中のデフォルトの Hugging Face モデルドロップダウンには、このエンドポイントから取得したモデルが表示されます。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 + Llama + GPT-OSS
{ agents: { defaults: { model: { primary: "huggingface/deepseek-ai/DeepSeek-V3.1", fallbacks: [ "huggingface/meta-llama/Llama-3.3-70B-Instruct-Turbo", "huggingface/openai/gpt-oss-120b", ], }, models: { "huggingface/deepseek-ai/DeepSeek-V3.1": { alias: "DeepSeek V3.1" }, "huggingface/meta-llama/Llama-3.3-70B-Instruct-Turbo": { alias: "Llama 3.3 70B Turbo" }, "huggingface/openai/gpt-oss-120b": { alias: "GPT-OSS 120B" }, }, }, },}