OpenClawを使っていると、

• デフォルトモデルを変更したい
• 現在どのモデルが設定されているか確認したい
• メインモデルが使えないときだけ別モデルへ切り替えたい
• OAuthとAPIキーを使い分けたい
• 一時的に別モデルを使いたい
• 認証エラーやレート制限の状態を確認したい

といった操作が頻繁に発生します。

OpenClawでは、主に、

openclaw models

コマンドを使ってモデルを管理します。

この記事では、OpenClawのモデル変更でよく使うコマンドを早見表形式でまとめます。

---

まず覚えておきたい3つ

最もよく使うのは次の3つです。

現在のモデル設定を確認：

openclaw models status

利用可能なモデル一覧：

openclaw models list

デフォルトモデル変更：

openclaw models set provider/model

例えば、

openclaw models set openai/gpt-5.6-sol

のように指定します。

OpenClaw公式でも、モデルは原則として、

provider/model

という形式で明示的に指定することが推奨されています。

---

OpenClawモデル操作 早見表

やりたいこと	コマンド
現在のモデル設定確認	openclaw models status
モデル一覧表示	openclaw models list
デフォルトモデル変更	openclaw models set provider/model
フォールバック一覧	openclaw models fallbacks list
フォールバック追加	openclaw models fallbacks add provider/model
フォールバック削除	openclaw models fallbacks remove provider/model
フォールバック全削除	openclaw models fallbacks clear
認証状態確認	openclaw models status
認証を実際にテスト	openclaw models status --probe
認証プロファイル一覧	openclaw models auth list
OpenAI OAuthログイン	openclaw models auth login --provider openai
設定診断	openclaw doctor
セッション中だけモデル変更	/model provider/model
セッションモデルを既定値へ戻す	/model default
現在のセッションモデル確認	/model status

---

1. 現在のモデル設定を確認する

まず何か変更する前に、

openclaw models status

を実行します。

このコマンドでは、

• デフォルトモデル
• フォールバックモデル
• 認証状態
• 利用できない認証プロファイル
• クールダウン状態

などを確認できます。

openclaw models だけでも、現在は models status と同じ動作になります。

例えば、

Default:
openai/gpt-5.6-sol

Fallbacks:
1. google/gemini-2.5-flash

のように確認できます。

---

2. 利用可能なモデル一覧を表示

openclaw models list

これでOpenClawが認識しているモデル一覧を確認します。

例えば、

openai/gpt-5.6-sol
openai/gpt-5.6-luna
google/gemini-2.5-flash
anthropic/claude-sonnet-4-6

などが表示されます。

モデル変更前には、

openclaw models list

で正確なモデルIDを確認してから設定するのがおすすめです。

---

3. デフォルトモデルを変更する

基本形：

openclaw models set provider/model

例えば、

openclaw models set openai/gpt-5.6-sol

です。

設定後、

openclaw models status

で確認します。

OpenClaw内部では、主モデルは、

agents.defaults.model.primary

として管理されます。

---

4. Geminiをデフォルトにする例

例えば、

openclaw models set google/gemini-2.5-flash

とします。

確認：

openclaw models status

これで通常の実行ではGeminiが優先されます。

---

5. フォールバックモデルとは

フォールバックとは、

メインモデルが利用できない場合に次のモデルへ切り替える仕組み

です。

例えば、

GPT
↓
レート制限
↓
Gemini

という構成です。

OpenClawでは、

Primary
↓
Fallback 1
↓
Fallback 2
↓
Fallback 3

という順序で設定できます。

公式仕様ではフォールバックモデルは、

agents.defaults.model.fallbacks

に保存され、上から順番に試行されます。

---

6. フォールバックを追加

基本形：

openclaw models fallbacks add provider/model

例えば、

openclaw models fallbacks add google/gemini-2.5-flash

これで、

Default
openai/gpt-5.6-sol

Fallback #1
google/gemini-2.5-flash

という構成になります。

---

7. フォールバック一覧を確認

openclaw models fallbacks list

例えば、

google/gemini-2.5-flash
openai/gpt-5.6-luna

と表示されます。

この場合、

Primary
↓
Gemini
↓
Luna

という順番です。

---

8. フォールバックを削除

特定モデルだけ削除：

openclaw models fallbacks remove google/gemini-2.5-flash

全部削除：

openclaw models fallbacks clear

その後、

openclaw models fallbacks list

で確認します。

---

9. デフォルトGPT＋Geminiフォールバック

例えば、

通常
→ GPT

GPTが使えない
→ Gemini

にしたいなら、

openclaw models set openai/gpt-5.6-sol

続けて、

openclaw models fallbacks clear

そして、

openclaw models fallbacks add google/gemini-2.5-flash

確認：

openclaw models status

という流れが分かりやすいです。

---

10. GPT Lunaをフォールバックにする例

例えば、

Default
GPT-5.6 Sol

Fallback
GPT-5.6 Luna

なら、

openclaw models set openai/gpt-5.6-sol

openclaw models fallbacks clear

openclaw models fallbacks add openai/gpt-5.6-luna

です。

---

11. フォールバックを2段にする

例えば、

GPT Sol
↓
GPT Luna
↓
Gemini

なら、

openclaw models set openai/gpt-5.6-sol

openclaw models fallbacks clear

openclaw models fallbacks add openai/gpt-5.6-luna

openclaw models fallbacks add google/gemini-2.5-flash

確認：

openclaw models fallbacks list

です。

---

12. OpenAI OAuth認証を設定する

OpenAIをOAuthで利用する場合は、

openclaw models auth login --provider openai

を使用します。

ブラウザーなどを使って認証を完了します。

認証状態は、

openclaw models status

または、

openclaw models auth list --provider openai

で確認できます。

---

13. 認証プロファイルを確認

OpenAIのみ：

openclaw models auth list --provider openai

全体：

openclaw models auth list

複数のOAuthアカウントやAPI認証を利用している場合は、ここを確認します。

---

14. 認証が本当に使えるかテスト

通常の、

openclaw models status

は設定状態の確認です。

実際にAPIアクセスまで試す場合は、

openclaw models status --probe

を使用します。

例えば、

ok
rate_limit
auth
billing
timeout

などの状態が確認できます。

ただし --probe は実際のモデル呼び出しを行うため、トークンを消費したりレート制限に影響したりする可能性があります。

---

15. Gateway稼働中に–probeできない場合

models status --probe は、エージェントの状態ディレクトリを排他的に使用するため、Gatewayが動作していると実行できないことがあります。

公式ドキュメントでも、必要に応じてGatewayを停止してからprobeするよう案内されています。

停止：

openclaw gateway stop

Probe：

openclaw models status --probe

確認後：

openclaw gateway start

です。

---

16. 特定プロバイダーだけprobe

例えばOpenAIだけなら、

openclaw models status --probe --probe-provider openai

これなら他のプロバイダーを試さず、OpenAIだけ確認できます。

---

17. 認証異常だけ確認したい

スクリプトなどでは、

openclaw models status --check

も便利です。

公式仕様では、

0
→ 問題なし

1
→ 認証切れ・不足・利用不能

2
→ 有効期限が近い

という終了コードを返します。

---

18. モデル設定がおかしい場合はdoctor

openclaw doctor

を使います。

設定修復まで試すなら、

openclaw doctor --fix

があります。

ただし --fix は設定を書き換える可能性があるので、まず通常の、

openclaw doctor

を実行して内容を確認する方が安全です。

---

19. チャット中だけモデルを変更する

デフォルト設定そのものを変えずに、

現在のセッションだけ別モデルへ変更

することもできます。

例えば、

/model openai/gpt-5.6-luna

です。

モデル選択画面を出すなら、

/model

または、

/model list

です。

---

20. セッションのモデルをデフォルトへ戻す

/model default

これで、そのセッション固有のモデル指定を解除して、OpenClawのデフォルトモデルへ戻します。

---

21. セッションで実際に使っているモデルを確認

/model status

を使用します。

これは重要です。

CLIで、

openclaw models status

を確認しても、現在のチャットセッション側で /model による上書きが入っている場合があります。

公式ドキュメントでも、

openclaw models status
＝設定上のデフォルト確認

/model status
＝現在のセッション確認

という違いがあります。

---

22. 「デフォルトを変えたのにモデルが変わらない」場合

例えば、

openclaw models set openai/gpt-5.6-sol

を実行したのに、チャットでは別モデルが使われ続ける場合があります。

その場合、

/model status

で確認してください。

セッションにモデルが固定されていたら、

/model default

で解除します。

---

23. モデルエイリアス

長いモデル名を短縮できます。

例えば、

openclaw models aliases add sol openai/gpt-5.6-sol

とすると、

sol

という別名で指定できます。

一覧：

openclaw models aliases list

削除：

openclaw models aliases remove sol

です。

---

24. モデル設定の基本構造

OpenClawのモデル選択は概念的には、

Primary
   ↓
Fallback #1
   ↓
Fallback #2
   ↓
Fallback #3

です。

さらに同じプロバイダーに複数の認証プロファイルがある場合は、

Primaryモデル
   ↓
認証Profile A
   ↓
認証Profile B
   ↓
それでも利用不可
   ↓
Fallbackモデル

のように、モデルフォールバック前に認証プロファイルのローテーションが行われます。

---

25. レート制限時のイメージ

例えば、

Primary:
openai/gpt-5.6-sol

Fallback:
google/gemini-2.5-flash

の場合、

GPT-5.6 Sol
↓
OpenAIレート制限
↓
利用できるOpenAI認証Profileを確認
↓
それでも利用不可
↓
Geminiへfallback

という流れになります。

openclaw models status では、クールダウン中の認証プロファイルも確認できます。

---

26. APIキーとOAuthは同じものではない

OpenAIの場合でも、

OAuth

と、

API Key

は別の認証方法です。

例えば、

OpenAI OAuth
→ ChatGPT/Codex系の認証ルート

OpenAI API Key
→ API課金の認証

という違いがあります。

OpenClawでは認証プロファイル単位で管理されます。

認証状況を確認する場合は、

openclaw models auth list --provider openai

が便利です。

---

27. よく使う構成例

構成A：GPTだけ

Primary
openai/gpt-5.6-sol

Fallback
なし

設定：

openclaw models set openai/gpt-5.6-sol
openclaw models fallbacks clear

---

構成B：GPT → Gemini

Primary
openai/gpt-5.6-sol

Fallback #1
google/gemini-2.5-flash

設定：

openclaw models set openai/gpt-5.6-sol
openclaw models fallbacks clear
openclaw models fallbacks add google/gemini-2.5-flash

---

構成C：GPT Sol → GPT Luna → Gemini

Primary
openai/gpt-5.6-sol

Fallback #1
openai/gpt-5.6-luna

Fallback #2
google/gemini-2.5-flash

設定：

openclaw models set openai/gpt-5.6-sol
openclaw models fallbacks clear
openclaw models fallbacks add openai/gpt-5.6-luna
openclaw models fallbacks add google/gemini-2.5-flash

---

28. 設定変更後の確認セット

モデル設定を変更したら、最低限この3つを実行すると分かりやすいです。

openclaw models list

openclaw models fallbacks list

openclaw models status

問題がありそうなら、

openclaw doctor

まで実行します。

---

コピペ用・モデル再設定基本セット

例えば、

GPT-5.6 Solをデフォルト、Geminiをフォールバック

に設定し直したい場合：

openclaw models set openai/gpt-5.6-sol
openclaw models fallbacks clear
openclaw models fallbacks add google/gemini-2.5-flash
openclaw models status

GPT Lunaも挟むなら、

openclaw models set openai/gpt-5.6-sol
openclaw models fallbacks clear
openclaw models fallbacks add openai/gpt-5.6-luna
openclaw models fallbacks add google/gemini-2.5-flash
openclaw models status

---

トラブル時の確認セット

まず、

openclaw models status

次に、

openclaw models auth list

OpenAIだけなら、

openclaw models auth list --provider openai

診断：

openclaw doctor

実通信確認が必要なら、

openclaw gateway stop
openclaw models status --probe
openclaw gateway start

です。

---

モデル変更時の注意点

1. モデル名はprovider/modelで指定する

例えば、

gpt-5.6-sol

だけではなく、

openai/gpt-5.6-sol

と指定した方が安全です。

---

2. listに出ないモデルは確認する

新しいモデルや独自プロバイダーでは、ローカルカタログに存在しないモデルを設定できる場合があります。

OpenClawは、既知のプロバイダーでモデルだけカタログにない場合、警告を出しつつ保存することがあります。

そのため、

openclaw models status
openclaw doctor

で確認します。

---

3. フォールバックは順番が重要

例えば、

openclaw models fallbacks add A
openclaw models fallbacks add B

なら、

Primary
↓
A
↓
B

の順です。

---

4. セッション固定に注意

CLIでデフォルトモデルを変更しても、

/model xxx

でセッションモデルを固定していると、そのセッションではデフォルト変更が見えないことがあります。

その場合、

/model default

で戻します。

---

最終早見表

現在設定
openclaw models status

モデル一覧
openclaw models list

デフォルト変更
openclaw models set provider/model

Fallback確認
openclaw models fallbacks list

Fallback追加
openclaw models fallbacks add provider/model

Fallback削除
openclaw models fallbacks remove provider/model

Fallback全削除
openclaw models fallbacks clear

OpenAI OAuth
openclaw models auth login --provider openai

OpenAI認証確認
openclaw models auth list --provider openai

認証・モデル診断
openclaw doctor

実通信テスト
openclaw models status --probe

チャット中のモデル変更
/model provider/model

チャット中のモデル確認
/model status

デフォルトへ戻す
/model default

---

まとめ

OpenClawのモデル変更で最も重要なのは、

openclaw models status
openclaw models list
openclaw models set
openclaw models fallbacks

の4系統です。

基本的には、

現在状態を確認
↓
デフォルトモデル設定
↓
フォールバック設定
↓
認証状態確認

という順序で作業すると分かりやすくなります。

例えば、

GPTを普段使う
↓
GPTが使えない
↓
Geminiへ切り替える

なら、

openclaw models set openai/gpt-5.6-sol
openclaw models fallbacks clear
openclaw models fallbacks add google/gemini-2.5-flash

です。

設定後は、

openclaw models status

で、

PrimaryとFallbackが意図した順番になっていること

を確認します。

また、モデル設定が正しいのに動かない場合は、

openclaw models auth list
openclaw doctor

で認証状態まで確認するのが基本です。

OpenClawでは「モデル設定」と「認証設定」は別なので、

モデル名だけ変えて終わりではなく、そのモデルを利用できる認証プロファイルが存在するかまで確認する

ことが安定運用のポイントです。