OpenClawでCodexを使う方法。ChatGPTサブスク認証と設定手順

OpenClaw とは何か — Codex とどう関係するのか

OpenClaw は、WhatsApp・Telegram・Discord などのメッセージングアプリを入口として、ファイル操作やアプリケーション連携を自律的にこなすオープンソースの AI エージェントフレームワークだ。エディタやターミナルに常駐する Codex とは立ち位置が異なり、「チャットで話しかけるだけで手元のマシンのエージェントが動く」体験を提供する。開発はコミュニティ主導で進んでおり、リポジトリは GitHub で公開されている(出典: https://github.com/openclaw/openclaw )。

では「openclaw codex」で検索する人が知りたい両者の関係はどこにあるか。答えはモデルプロバイダ層にある。OpenClaw は OpenAI のモデルを使う際、独自の制御ループでモデルを叩くのではなく、Codex を支えるネイティブ実行系である app-server に処理を委ねる設計へ移行した。つまり OpenClaw のユーザーにとって Codex は「競合ツール」ではなく「OpenAI モデルを動かすときの実行エンジン」であり、ChatGPT/Codex のサブスクリプション契約をそのまま OpenClaw の動力源にできる(出典: https://docs.openclaw.ai/providers/openai )。

認証は 2 方式 — ChatGPT/Codex サブスクリプションと API キー

OpenClaw の OpenAI プロバイダは、認証の形が違っても単一のプロバイダ ID openai に統一されている。1 つ目の方式は ChatGPT/Codex サブスクリプションによるログイン認証で、公式ドキュメントはこちらをデフォルトのエージェント用セットアップとして案内している。ChatGPT Plus や Pro の契約枠でエージェントの応答が賄われるため、トークン従量課金を気にせず試せるのが利点だ(出典: https://docs.openclaw.ai/providers/openai )。

2 つ目は OpenAI API キーによる直接接続で、使った分だけ課金される従量制になる。エージェントの会話用途ではサブスクリプション認証が優先されるが、画像生成・埋め込み・音声・リアルタイム系といったエージェント以外の API 面では API キーが引き続き使われる。両方を登録して auth.order.openai で優先順位を決める併用構成も可能で、サブスクリプションを主・API キーを控えに置く形が公式の想定に沿う(出典: https://docs.openclaw.ai/providers/openai )。

どちらを選ぶかの目安は明快だ。すでに ChatGPT Plus/Pro を契約していて Codex も使っているならサブスクリプション認証一択でよい。組織で利用量を厳密に管理したい、あるいはエージェント以外の API も同じ請求にまとめたい場合に API キーを検討すればよい。

設定手順 — 認証からモデル指定、動作確認まで

ここからは実際のセットアップを 4 ステップで進める。前提として OpenClaw 本体の導入が済んでいること、サブスクリプション認証を使う場合は ChatGPT/Codex の契約があることを確認しておきたい。

Step 1: 認証方式を選んでログインする

サブスクリプション認証の場合は、初期セットアップなら openclaw onboard --auth-choice openai、導入済みの環境なら openclaw models auth login --provider openai を実行する。ブラウザが開き、ChatGPT アカウントでのログイン認証が走る。API キーの場合は openclaw onboard --openai-api-key "$OPENAI_API_KEY" のようにキーを渡す(出典: https://docs.openclaw.ai/providers/openai )。

Step 2: デフォルトモデルを標準参照で指定する

エージェントの既定モデルは設定ファイルで openai/gpt-5.5 のような「標準 OpenAI 参照」を指定する。設定例は次のとおり。

{
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" }
    }
  }
}

かつて使われたレガシーな Codex 系のモデル参照は新規設定では非推奨とされており、openai/gpt-5.5 や openai/gpt-5.4 といった表記に揃えるのが現行の作法だ(出典: https://docs.openclaw.ai/plugins/codex-harness )。

Step 3: ランタイム設定は基本的に触らない

サブスクリプション認証で OpenAI モデルを使う場合、ランタイムの明示指定は不要で、エージェントの応答は Codex 側の実行系が既定で選ばれる。ここで独自設定を足すより、まずは既定のまま動かして挙動を確かめるのが安全だ(出典: https://docs.openclaw.ai/providers/openai )。

Step 4: 接続状態を確認する

openclaw models status と openclaw models auth list --provider openai で認証と接続の状態を確認できる。利用可能なモデル一覧は openclaw models list --provider openai で取得できるほか、Codex 認証が機能していればチャット側から /codex status を打って状態を見ることもできる(出典: https://docs.openclaw.ai/providers/openai )。

Codex harness プラグイン — 実行を Codex app-server に委譲する仕組み

内部の仕組みも押さえておくと切り分けに役立つ。OpenClaw には Codex harness と呼ばれるプラグインがあり、これが OpenClaw 組み込みのエージェント実行を OpenAI の Codex app-server に委譲する。役割分担は「OpenClaw がチャットチャネルと会話履歴を管理し、Codex が低レベルのエージェント処理を実行する」という形で、スレッドの再開・ツール呼び出しの継続・コンテキストの圧縮は Codex 側がネイティブに制御する(出典: https://docs.openclaw.ai/plugins/codex-harness )。

2026 年 5 月 14 日付の公式ブログは、この移行の狙いを「OpenAI が積極的に開発しているエージェント向けネイティブランタイムに乗る」ことだと説明し、プロンプトの削減・重複したツール定義の排除・返信品質の改善を挙げている。OpenClaw が独自ループで OpenAI モデルを制御していた従来構成と比べ、Codex と同じ実行系を共有することでモデル本来の挙動を引き出しやすくなったというわけだ(出典: https://openclaw.ai/blog/openai-models-in-openclaw-done-right )。

プラグインを明示的に有効化する場合の最小設定は plugins.entries.codex.enabled: true を立て、デフォルトモデルに openai/gpt-5.5 を指定するだけでよい。Claude など別プロバイダのモデルと混在させるデプロイも可能なので、用途ごとにモデルを使い分ける構成も組める(出典: https://docs.openclaw.ai/plugins/codex-harness )。

運用上の注意点 — 利用上限・レガシー設定・バージョン要件

まず利用上限。サブスクリプション認証は ChatGPT/Codex 契約の利用枠を消費するため、Codex 側で使い込んでいる時期は OpenClaw の分も含めて上限に近づきやすい。直近のリリースでは、Codex サブスクリプションが利用上限に達した際に、失敗のまま止まらず設定済みのフォールバックモデルへ移行する挙動に改められている。フォールバック先を設定しておけば、上限到達でエージェントが沈黙する事態は避けられる(出典: https://github.com/openclaw/openclaw/releases )。Codex 本体側の上限の考え方はCodex の利用上限の記事も参考になる。

次にレガシー設定。過去のバージョンでは openai-codex という別プロバイダ ID が使われていた時期があり、古い openai-codex:* 形式のプロファイル ID や auth.order.openai-codex の設定が残っていると現行仕様と食い違う。これらはレガシー状態として openclaw doctor --fix の修復対象になっており、新しい設定では openai:* と auth.order.openai に統一するのが正しい(出典: https://docs.openclaw.ai/providers/openai )。

最後にバージョン要件と制約。Codex harness は Codex app-server 0.125.0 以上を要求する。また、OpenClaw 側のサンドボックスが有効な場合は Codex のネイティブコードモードが無効化される、コンテキスト圧縮は Codex が所有するため OpenClaw 側のサマライザーでは置き換えられない、といった制約も明記されている。エージェントが期待どおり動かないときは、この 3 点を順に確認するとよい(出典: https://docs.openclaw.ai/plugins/codex-harness )。

なお、OpenClaw はメッセージングアプリ経由でマシンを操作できる強力なツールでもある。Codex 単体との性格の違いや向き不向きはCodex とは何かの記事と読み比べると整理しやすい。

まとめ — サブスクリプション認証で始め、フォールバックを備える

OpenClaw と Codex の関係は「比較して選ぶ」ものではなく、OpenClaw が OpenAI モデルの実行を Codex app-server に委ねるという補完関係にある。ChatGPT/Codex サブスクリプションがあるなら openclaw models auth login --provider openai でログイン認証し、モデルは openai/gpt-5.5 の標準参照で指定する。これだけで Codex と同じネイティブ実行系の上でエージェントが動き出す。運用面では、利用上限に備えたフォールバックモデルの設定、レガシーな openai-codex 設定の修復、Codex app-server のバージョン要件の 3 点を押さえておけばよい。一次情報は OpenAI プロバイダのドキュメント( https://docs.openclaw.ai/providers/openai )と Codex harness の解説( https://docs.openclaw.ai/plugins/codex-harness )で随時確認できる。