---
read_when:
    - ClawHub の無料プロモーションモデル提供を試したい場合
    - オンボーディングではなくプロモーションを通じてプロバイダーを設定しています
summary: '`openclaw promos` のCLIリファレンス（プロモーションモデルのオファーを一覧表示して受け取る）'
title: プロモーション
x-i18n:
    generated_at: "2026-07-11T22:09:02Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    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` に変わります。
- 新しいオファーが初めて検出されたときは、`openclaw promos list` を案内する通知が一度だけ表示されます。既に一覧表示または取得したオファーが再度通知されることはありません。

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