OpenClawのモデルをOpenAI Codexに切り替える — ToS混乱後の実践ガイド
Claude・GeminiのToS変更後、OpenClawユーザー向けのOpenAI Codex移行ガイド。バックアップからモデル設定、エージェント別構成まで一気に解説します。
発端:ClaudeとGeminiのToS変更
2026年初頭、Anthropic(Claude)とGoogle(Gemini)が利用規約を更新しました。問題の核心は、サブスクリプション(Pro/Max等)のOAuth認証をサードパーティツールで使えるのかという点です。
これまで多くのOpenClawユーザーがClaude ProやGemini AdvancedをOAuthで接続し、エージェントを動かしていました。ToS変更を受けて「このまま使い続けて大丈夫か?」という不安が広がり、コミュニティで代替策の議論が始まりました。
結論から言えば、OpenAIのChatGPT Plus/Proサブスクリプションに含まれるCodex OAuthは、サードパーティ連携を明示的に許可しています。この記事では、実際の切り替え手順と注意点を整理します。
切り替え前に確認すること
すぐに移行する前に、3つのポイントを押さえておきましょう。
- プロンプトの互換性:ClaudeとGPT-5.x-Codexは同じプロンプトでも異なる応答をします。
SOUL.mdやAGENTS.mdを数日かけて調整する必要があります - モデルごとの強み:Codexはコードとツール呼び出し(Tool Use)に強い一方、エッセイやSNS投稿のような自然な文章ではClaudeの評価が高いです
- APIキーという選択肢:Claudeを使い続けたい場合、サブスクOAuthではなくAPIキー方式(
console.anthropic.com)が使えます。ただし、Opusでエージェントループを回すと月$100を超えやすいので注意が必要です
切り替え手順(4ステップ)
コミュニティで検証済みの手順です。所要時間は約15分です。
ステップ1:バックアップ
まず現在の設定をまるごとバックアップします。
cd ~
tar -czf openclaw-backup.tgz .openclaw
チャネル設定、メモリ、cronジョブ、認証情報がすべてこの中に入ります。
ステップ2:オンボーディングウィザードの実行
openclaw onboard --auth-choice openai-codex
ウィザードが始まるといくつか質問が表示されます。下表の通り選択してください。
| 画面 | 選択 | 理由 |
|---|---|---|
| ”This is risky” 警告 | そのまま進む | プロバイダー変更に伴う動作差異の案内です |
| Setup mode | Quickstart | デフォルト値で素早く設定します |
| 既存値の扱い | ⚠️ 必ず “Use existing values" | "Reset”を選ぶとチャネル・メモリ・cron設定がすべて消えます |
ブラウザが開いたら、ChatGPTアカウントでログインして権限を承認します。
🔴 注意:承認が終わったら、ターミナルのウィザードをすぐ閉じてください。既存の設定がある状態でウィザードを最後まで進めると、設定が上書きされる可能性があります。
ステップ3:デフォルトモデルの変更
openclaw models set openai-codex/gpt-5.3-codex
ステップ4:確認
openclaw models status --plain
primaryにopenai-codex/gpt-5.3-codexと表示されれば完了です。
Anthropic認証の完全削除(任意)
既存の認証をきれいに整理したい場合は以下を実行します。
# フォールバックモデルの削除
openclaw models fallbacks clear
# 認証順序の削除
openclaw models auth order clear --provider anthropic
# 環境変数の整理(~/.openclaw/.env)
# ANTHROPIC_API_KEY=... の行を削除
# ゲートウェイ再起動と状態確認
openclaw gateway restart
openclaw doctor
エージェント別のモデル設定 — 見落としがちなポイント
切り替え後に最もよくあるミスがここです。openclaw models setはグローバルデフォルトしか変更しません。エージェントに個別にモデルが指定されている場合、そのエージェントは以前のモデルをそのまま使います。
openclaw.jsonのagents.listを確認しましょう。
{
"agents": {
"defaults": {
"model": {
"primary": "openai-codex/gpt-5.3-codex" // ← グローバル(変更済み)
}
},
"list": [
{
"id": "branding",
"model": {
"primary": "anthropic/claude-opus-4-6" // ← まだClaude
}
}
]
}
}
エージェント別にモデルを変える方法は2つあります。
# 方法1:cronジョブ単位でモデルを指定
openclaw cron edit <cron-id> --model "openai-codex/gpt-5.3-codex"
# 方法2:エージェントのmodelブロックを削除 → グローバルデフォルトに従う
一括で切り替えるなら、エージェント別のmodelブロックを削除するのが簡単です。
レイヤー戦略 — コミュニティ推奨アーキテクチャ
一つのプロバイダーに頼り切るのではなく、用途ごとにモデルを分けるレイヤー戦略がコミュニティで定着しつつあります。
graph TD
A[Layer 1<br/>バルク作業] --> D[ローカルOSSモデル<br/>Ollama + LLaMA等]
B[Layer 2<br/>主力] --> E[OpenAI Codexサブスク<br/>推論・計画・ユーザー対面]
C[Layer 3<br/>必要時のみ] --> F[Anthropic APIキー<br/>Claude固有の強み]
style A fill:#e8f5e9
style B fill:#e3f2fd
style C fill:#fff3e0
| Layer | 用途 | モデル | 課金 |
|---|---|---|---|
| Layer 1 | ファイル処理、探索的作業 | ローカルOSS(Ollama + LLaMA等) | 無料(電気代のみ) |
| Layer 2 | 推論、計画、ユーザー対面 | OpenAI Codexサブスク | 月額 |
| Layer 3 | Claudeの強みが必要なとき | Anthropic APIキー | トークン課金 |
この構成なら、プロバイダーがポリシーを変えても設定ファイルを1行修正するだけで対応できます。
切り替え後の体感
実際に移行したユーザーの共通した感想です。
- プロンプト調整は必須:
SOUL.md、AGENTS.mdを数日かけて調整しないと安定しません - コード・ツール呼び出しは確かに強い:コード生成とTool Useで体感できる違いがあります
- 自然な文章は惜しい:エッセイやSNS投稿ではClaudeの方が自然だという評価が多いです
- 安定性は高い:OAuth認証が安定しており、トークン消費を気にせずエージェントを回せます
Claudeを使い続けたい場合
APIキー方式はToSに関係なく利用できます。
openclaw onboard --auth-choice anthropic
console.anthropic.comでAPIキーを発行し、トークン課金で運用します。Opusのエージェントループでは月額が$100を超えやすいため、コスト管理が重要です。
比較まとめ
| 項目 | Claude サブスクOAuth | Codex サブスクOAuth | Claude APIキー |
|---|---|---|---|
| ToSリスク | ⚠️ 不確実 | ✅ 明示的に許可 | ✅ 合法 |
| 月額コスト | サブスク料 | サブスク料 | 使用量比例 |
| 文章品質 | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ |
| コード/ツール | ⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| 切り替え難度 | — | 簡単(15分) | 簡単 |
最も大切なのは、特定のプロバイダーに依存しない構成を作っておくことです。OpenClawの設定ベースのアーキテクチャを活かせば、どのプロバイダーがポリシーを変えても柔軟に対応できます。
参考資料
他の言語で読む
- 🇰🇷 한국어
- 🇯🇵 日本語(現在のページ)
- 🇺🇸 English
- 🇨🇳 中文
この記事は役に立ちましたか?
より良いコンテンツを作成するための力になります。コーヒー一杯で応援してください!☕