OpenClaw Codexハーネス：セッション、認証情報、請求

OpenClaw Codexハーネスは公式の@openclaw/codexプラグインであり、OpenClawのエージェントターンをOpenAIのCodex app-serverに渡すことで、モデルループ、スレッドの再開、ツールの継続、コンパクションをCodexが担います。これはコーディング委任製品でも請求レイヤーでもなく、そして、最も多くの設定で混乱を招く点ですが、CodexをサードパーティAPIエンドポイントに接続して実行する方法でもありません。このページは、実際に必要なのがどれなのかを判断するために存在します。

まず日付を示すので、ここに日付のない情報はない。npmパッケージopenclawは2026.9.5で、Node >=24.16.0 <25 || >=26.1.0が必要である。@openclaw/codexも2026.9.5で、2026年9月18日に公開された。いずれも2026年9月21日にレジストリから読み取った。3つの無関係なプロジェクトがこれらの名前を共有しており、どの番号もここには該当しない。pjasicek/OpenClawは1997年のプラットフォーマーゲームCaptain Clawの再実装を名乗り、単独のnpmパッケージcodexは「静的サイトおよびコードドキュメント生成器」で、最終公開は2012年である。OpenAIのCLIは@openai/codexであり、同日現在0.155.1である。

5つのOpenClawの領域が「Codex」という名前を共有する

OpenClawのエージェントランタイムのドキュメントでは、これらを「意図的に独立」と呼んでいる。間違ったものを選ぶことが、設定が正しそうに見えるのに何も起こらない最も一般的な理由である。

6つ目の名前はOpenClawのものではない。openclaw-code-agentは、計画の承認とworktreeの分離を伴うバックグラウンドのコーディングセッションを実行するサードパーティ製プラグインである。そのREADMEには、OpenClawに同梱されたacpxランタイムプラグインおよび同梱されたコアcodexプラグインとは別物だと記載されている。ランタイムの置き換えではなく委任を求めてここに来たのであれば、それは異なる設定キーを持つ別の製品である。

ハーネスを有効にし、有効であることを確認する

文書化された経路は2つのコマンド、つまりプラグインのインストール、続いてサインインである。

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

次に最小構成を設定する。plugins.allowリストを使用する場合は、"codex"もそのリストに追加する。

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      // The docs' own example ref. Legacy codex-cli/* refs are
      // repaired to the same openai/<model> route by doctor --fix.
      model: "openai/gpt-6-astra",
    },
  },
}

ハーネスのドキュメントが明示している詳細が2つある。プラグイン設定の変更はハイブリッド再読み込みモードで自動的に適用されるが、既存のチャットでは、次のターンが現在の設定からハーネスを解決できるように、まず/newまたは/resetが必要である。また、有効なツールプロファイルではネイティブのシェルおよびファイルシステム機能を許可する必要がある。codingとfullは許可し、messagingとminimalはネイティブ面を無効にする。通常のOpenClawサンドボックスまたは制限付きツールポリシーは、同じドキュメント内でさらに狭い構成であり、実験的なsandbox exec-server経路を選択しない限りネイティブコードモードを無効にする。サンドボックスによってネイティブ面が無効になった場合でも、許可されたシェルコマンドはsandbox_execを通じて到達可能である。

app-serverトランスポートのリファレンスに照らして2026年9月21日に確認したバージョン要件。プラグインは安定版のCodex app-server 0.154.0を管理する一方、明示的なカスタム実行ファイル、リモートapp-server、macOSデスクトップバイナリでは、解析可能なセマンティックバージョンとして0.149.0以降を報告する必要がある。npmの最新の@openai/codexは同日現在0.155.1であるため、管理対象の固定バージョンは1つのパッチ分だけ遅れている。これが、日付のない「Codex latest」と書かれたチュートリアルが数日で古くなる理由である。古い設定の移行も重要である。エージェントランタイムのページでは、OpenClawに同梱されたCodex CLIバックエンドがv2026.5.14で削除されたと説明している。また、従来のcodex-cli/*参照は、レガシーCodex経路の修復全般を担うopenclaw doctor --fixによって、同じopenai/<model> Codex app-server経路へ修復される。

確認方法：Codexをバックエンドにしたターンでは、/statusの下にRuntime: OpenAI Codexと表示され、/codex status、/codex models、/codex bindingでapp-serverの状態を確認できる。openclaw doctor --lint --only codex/managed-app-server --jsonというlintは管理対象バイナリを確認するが、ドキュメントではこれを読み取り専用と説明しており、選択したCodex Desktopバイナリ、明示的なカスタムコマンド、リモートapp-serverはこのパッケージチェックの対象外としている。

これを基盤に構築する前に知っておく価値のある緊張関係が1つある。OpenAI自身のapp-serverドキュメントには、「app-serverコマンドとWebSocketトランスポートは実験的であり、本番ワークロードには対応していない」と記載されている。この警告がトランスポートだけでなくコマンドも明示している点に注意すること。OpenClawはそのコマンドを基盤としてリリース済みの機能を構築しており、そのtransportフィールドのデフォルトはstdioで、urlを設定した場合にのみwebsocketが使用される。両方の記述は同時に真である。両方を踏まえて判断すること。

委任アーティファクト、権限、キャンセル、再開

ハーネスのドキュメントは、ネイティブサブエージェントのステータスが証明できる範囲の限界を正直に説明しています。実行、タスク結果、結果の配信は別々の事実であり、アイドル状態、割り込み状態、またはアンロードされたネイティブスレッドは、タスクが成功したことを証明しません。終了確認を取得できない場合、タスクは終了処理を再試行するよう求めます。ネイティブ Codex サブエージェントは Codex 自身の仕組みです。明示的な OpenClaw または ACP の委任は、引き続き sessions_spawn を経由します。

プラグインの設定フィールド表によると、app-server が起動する OpenClaw プロセスの実行権限は、ローカルの Codex 要件でその姿勢が許可されない場合を除き、デフォルトでモード yolo、承認ポリシー never、サンドボックス danger-full-access です。その場合、guardian のデフォルトではオンデマンド承認と workspace-write が優先され、それ以外では read-only が使用されます。requestTimeoutMs（app-server 制御プレーン呼び出しのタイムアウト）のデフォルトは 60000 です。これらは起動するプロセスに対する OpenClaw のデフォルトであり、Codex CLI 自身のデフォルトではありません。未知のリポジトリでは、最初の実行前に確認すべき設定はこの最初のデフォルトです。

ターン中の制御はネイティブです。/codex stop、/codex steer、/codex resume、/codex detach、/codex bind、/codex compact、/codex threads、/codex goal、/codex model、/codex fast、/codex permissions。制限付きターンはセッションモードではなくターン単位で適用され、そのターンに限ってネイティブ Code Mode、環境選択、設定済み MCP サーバー、ネイティブフックリレーを無効にします。OpenClaw の runtime v1 サポート契約には、サポート対象外として、ネイティブツール引数の変更（pre-tool フックはブロックできますが、OpenClaw は引数を書き換えません）、編集可能な Codex ネイティブのトランスクリプト履歴、コンパクションへの介入、バイト単位で完全に一致するモデル API リクエストの取得も記載されています。したがって、監査要件が正確な送信リクエストである場合、このランタイムでは提供できません。

認可、プランの利用資格、トークン消費は別々のものです

2026 年 9 月 21 日にOpenClaw の Codex app-server ポリシーページから読み取りました。ここには、まず命名上の注意点があります。OpenAI の API 料金ページには、Priority processing が 2026 年 7 月 30 日に Fast mode に改称され、service_tier に "priority" または "fast" のいずれかを送信できると記載されています。一方、OpenClaw の appServer.serviceTier では "priority" と "flex" が文書化され、従来の "fast" を "priority" に正規化しています。方向が逆です。2 つのシステムでは、「高速モードをオンにする」の意味が異なります。

サードパーティエンドポイントでハーネスを離れる理由

これは、ほとんどのサードパーティによる解説が逆に説明している、最も重要な事実です。プロバイダーまたはモデルランタイムが未設定または auto の場合、OpenClaw の暗黙的なエージェントランタイム表は次のようになります。

したがって、OpenClaw を任意のサードパーティのベース URL（Kunavo を含む）に向けると、設計上、そのターンは OpenClaw の組み込みランタイムで実行されます。openai/* プレフィックスだけではハーネスは選択されず、agentRuntime.id: "codex" を強制しても救済されません。ランタイムページには、その設定は「登録済みの Codex ハーネスを必要とし、サポートされていないルートまたは認証はフェイルクローズする。ただし、作成者によるリクエスト上書きは、実行前に Codex が宣言した正確なリクエスト用の OpenClaw フォールバックを使用できる」とあります。したがって結果は、失敗したターンか OpenClaw のターンのいずれかであり、カスタムエンドポイント上の Codex になることはありません。プラグインの文書化された設定フィールドにもモデルのベース URL 設定はありません。そこにある唯一の url フィールドは、app-server 自身の WebSocket または unix:// アドレスです。appServer.args が管理対象 app-server にプロバイダーの上書きを忍び込ませられるかどうかは文書化されておらず、テストもされていません。このページでは回避策として提示していません。

組み込みランタイムのルートではリクエストも再構成されます。OpenClaw のカスタムプロバイダーページは、各ルールの適用範囲を具体的に示しています。非ネイティブエンドポイント上の api: "openai-completions"（これは、空でない baseUrl のうちホストが api.openai.com でないものとして定義されています）では、OpenClaw は compat.supportsDeveloperRole を false に固定し、明示的な true を上書きします。これとは別に、プロキシ形式の OpenAI 互換ルートでは「ネイティブの OpenAI 専用リクエスト再構成をスキップ」します。service_tier なし、Responses の store なし、Completions の store なし、プロンプトキャッシュヒントなし、OpenAI 推論互換のペイロード再構成なし、非表示の帰属ヘッダーなしです。通信上に service_tier がないため、そのようなルートでは Fast mode と Flex は選択できません。同じページが代わりに提供するのは、OpenAI 互換 Completions プロキシ向けの params.extra_body パススルー、プロバイダーごとの headers、遅いホストまたはリモートホスト向けの models.providers.<id>.timeoutSeconds です。

もう一方の半分は Codex 自体で、こちらはより寛容です。Codex の高度な設定ページには、~/.codex/config.toml が [model_providers.<id>] とともに base_url および env_key をサポートすると記載されています。ただし、厳格な制約があります。設定リファレンスには、model_providers.<id>.wire_api について「responses がサポートされる唯一の値であり、省略時のデフォルトでもある」と記載されています。したがって、Chat Completions のみを提供するエンドポイントでは Codex を動かせません。同じ高度な設定ページでは、組み込み ID として openai、ollama、lmstudio を予約し、プロジェクトレベルの .codex/config.toml で Codex が無視するキーとして model_provider と model_providers を挙げています。したがって、プロバイダーキーはユーザーレベルの設定に置きます。Kunavo は /v1/responses にネイティブ Responses サーフェスを実装しており、これによってCodex CLI のセットアップが可能になります。ただし、これはスタンドアロンの Codex CLI であり、OpenClaw ハーネスではありません。また、Kunavo はどちらのクライアントもランタイムテストしていません。

ソフトウェアの料金とトークンの料金

OpenClaw 自体は $0 です。ドキュメントインデックスでは、このプロジェクトを MIT ライセンス、コミュニティ主導、独立した 501(c)(3) 財団による開発、「有料ティアなし」と説明しています。@openclaw/codex は公開 npm レジストリで無料公開されています。実際にかかる費用は、Gateway を実行するマシンとモデル利用量だけで、モデル利用量には 3 つの契約形態があります。

2026 年 9 月 21 日に確認した、OpenAI のCodex 料金ページによる情報です。この表には 3 つの注意点があります。料金カードで Pro について公開されているのは「From $100」だけです。OpenAI の別のChatGPT Pro ティアについての記事では、より高額な $200 ティアを挙げていますが、2026 年 9 月 10 日時点で新規登録とアップグレードが一時停止されています。そのため、このページが料金カードで確認していない金額を予算に組み込まず、チェックアウト時に確認してください。含まれる利用量は、固定メッセージ数ではなく、5 時間あたりのローカルメッセージ数の推定範囲としてのみ公開されています。また、含まれる上限を超えた後のクレジット料金は 100 万トークンあたりのクレジット数で公開されており、その料金ページにはクレジットのドル価値が記載されていません。したがって、その行についてドル換算は提供されていません。別途、GPT-5.5 は 2026 年 10 月 14 日に全プランの ChatGPT、ChatGPT Work、Codex から廃止されますが、OpenAI API は影響を受けません。

3 つ目の契約は、OpenClaw の組み込みランタイム上のゲートウェイです。キャッシュされていない入力トークン 180,000 個を送信し、出力トークン 9,000 個を受信する委任ターンを 1 回想定します。料金は、100 万トークンあたりのKunavo カタログの現在の価格です。

これらはトークン数に基づく計算例であり、実測したタスクのコストでも、請求額の上限でもありません。ターンの構成は仮定であり、実際のエージェントのターンでは、ツールとのやり取りのたびにコンテキストが再送信されます。Kunavoのカタログ料金は、請求額の上限ではなく下限です。上流プロバイダーが料金を報告した場合、請求額は、カタログ料金と、上流プロバイダーのコストに該当するマークアップ倍率を掛けた金額のうち、高い方になります。キャッシュ料金と外部ツールの料金は、この例には含まれていません。最低チャージ額は前払いクレジットで$10です。これはプランを購入するものではなく、残高を補充するものです。請求の詳細をご覧ください。

Kunavo は埋め込みモデル、音声合成モデル、音声認識モデルを提供していません。これらの処理はどのルートでも Kunavo が提供するものではないため、対応するプロバイダーへ移してください。

この境界はここで重要です。上記のサーフェス表では、エージェントではない OpenAI Platform ルートをハーネスとは別に扱っており、Gateway キーで利用できるのは Kunavo カタログ内のチャットモデルだけだからです。

どのような場合にどのルートを選ぶか

答えがゲートウェイの行にある場合は、Responses API の形式についてCodex CLI 統合から始め、OpenClaw に最適な APIとCodex に最適な APIで選択肢を比較し、キーへの入金準備ができたらKunavo アカウントを作成してください。セルフホスト型アシスタントの予算については、OpenClaw の料金でソフトウェア、ホスティング、モデル利用料を分けて説明しています。

よくある質問

上記のランタイム表、認証順序、app-server に関する警告、wire_api ゲート、バージョン固定、プラン料金は、2026 年 9 月 21 日に OpenClaw と OpenAI の公式ドキュメント、OpenAI のヘルプセンター、openclaw、@openclaw/codex、@openai/codex、codex、openclaw-code-agent の npm レジストリエントリから取得しました。各主張は出典ページにリンクしています。文書で確定できない事項については、空白を埋めず、その旨を記載しています。Kunavo は OpenClaw も Codex ハーネスもランタイムテストしていないため、ここにある各設定は Kunavo のエンドポイントで実演したものではなく、出典ドキュメントと照合したものです。Kunavo のトークン料金はライブカタログから取得しており、各ドル額は例示的な計算です。