---
read_when:
    - ClawHub の無料プロモーションモデルを試したい場合
    - オンボーディングではなく、プロモーションを通じてプロバイダーを設定しています
summary: '`openclaw promos`（プロモーションモデルオファーの一覧表示と取得）の CLI リファレンス'
title: プロモーション
x-i18n:
    generated_at: "2026-07-26T08:58:32Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 779eab2e9500b7376fabf9accb333e83ff5f84b085d51b7d551b5507b1e73adb
    source_path: cli/promos.md
    workflow: 16
---

# `openclaw promos`

ClawHub で公開されているモデルのプロモーションオファーを見つけて適用します。プロモーションを
適用すると、プロバイダー（必要に応じて認証と Plugin）が構成され、
プロモーションのモデルが登録されます。オンボーディングを再実行する必要はなく、
明示的に指定しない限りデフォルトモデルも変更されません。

関連項目:

- デフォルトモデルとフォールバック: [モデル](/ja-JP/cli/models)
- プロバイダー認証のセットアップ: [はじめに](/ja-JP/start/getting-started)

## コマンド

```bash
openclaw promos list
openclaw promos claim <slug>
openclaw promos claim <slug> --api-key <key> --set-default
```

## `openclaw promos list`

現在有効なプロモーションについて、そのモデル、推奨される
デフォルト、残り時間、正確な適用コマンドを一覧表示します。`--json` は生の
ペイロードを出力します。

## `openclaw promos claim <slug>`

有効なプロモーションを適用します:

1. ClawHub からプロモーションを取得し、有効期間内であることを確認します。
2. プロモーションのプロバイダー、認証方式、宣言された Plugin パッケージが、
   インストール済みの OpenClaw バージョンに適合することを検証します。不明な ID やパッケージの不一致は
   拒否されます。プロモーションによって、CLI が既に実行方法を認識していないものを
   実行することはありません。
3. 既存のプロバイダー認証情報がある場合は再利用します。ない場合は、
   プロバイダーの通常の認証フローを案内します（最初に無料キー用のプロモーション登録 URL を
   出力します）。`--api-key <key>` はプロンプトを表示せずに API キー認証を
   完了し、`openclaw onboard` の非対話型フラグと同様に動作します。キーを
   コマンドラインに含めないようにするには、代わりにプロバイダーの環境変数
   （例: `OPENROUTER_API_KEY`）をエクスポートします。既存の環境変数の認証情報は
   自動的に検出されるため、フラグは不要です。
4. プロモーションのモデルをエイリアスとともに登録します。既存のエイリアスが
   上書きされることはありません。
5. プロモーションの推奨モデルをデフォルトとして設定するか確認します。
   `--set-default` を指定すると確認を省略します。それ以外の場合、
   デフォルトに関する設定は変更されません。

プロモーションの有効期間が終了すると、プロバイダーは無料モデルの提供を停止しますが、
構成と認証情報は変更されません。`openclaw models set <model>` を使用すれば
いつでも元に戻せます。

## `models list` でのパッシブ検出

`openclaw models list` は、ClawHub に直接問い合わせなくても
プロモーションを表示します:

- モデルが未構成の有効なオファーは、表の下にある
  「プロモーションで利用可能」グループに表示され、それぞれに適用
  コマンドが示されます。
- `promos claim` を通じて登録したモデルには `promo` タグが付き、
  オファーの有効期間が終了すると `promo ended` に変わります。
- 新しいオファーが初めて検出されると、1 回限りの通知で
  `openclaw promos list` が案内されます。既に一覧表示または適用したオファーが
  再度通知されることはありません。

これは、ClawHub でホストされているプロモーションフィードのローカルキャッシュを読み取ります
（通常は条件付きリクエストによって 1 日に 1 回更新され、キャッシュされた
スナップショットの有効期限が切れた場合はそれより早く更新されます。更新に失敗した場合は何も表示せずスキップします）。
古くなったキャッシュの更新は最大 2.5 秒だけ待機し、一覧表示を妨げることはありません。`--json` と
`--plain` の出力は機械処理向けのクリーンな状態を維持し、プロモーションのセクションや通知は含まれません。
適用時には常に有効な ClawHub API に対して再検証されるため、オファーが
早期に取り下げられた場合、キャッシュにまだ表示されていても拒否されます。