OpenClaw Codex harness：工作階段、憑證與計費

OpenClaw Codex harness 是官方的 @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 日從 registry 讀取。另有三個無關的專案共用這些名稱，它們的版本號都與本文無關：pjasicek/OpenClaw自稱是 1997 年平台遊戲 Captain Claw 的重新實作；純 npm 套件 codex 是「靜態網站與程式碼文件產生器」，最後發布於 2012 年；而 OpenAI 的 CLI 是 @openai/codex（同日為 0.155.1）。

五個 OpenClaw 表面共用「Codex」這個名稱

OpenClaw 的 agent-runtimes 文件稱這些項目「刻意彼此獨立」。選錯項目，是設定看似正確卻毫無作用的最常見原因。

第六個名稱根本不屬於 OpenClaw。openclaw-code-agent 是第三方外掛程式，會在背景執行具備計畫核准和工作樹隔離的編碼工作階段；其 README 明確表示，它與 OpenClaw 內建的 acpx 執行環境外掛程式和內建核心 codex 外掛程式彼此獨立。如果你來到這裡是想要委派工作，而不是替換執行環境，那是另一個產品，也使用不同的設定金鑰。

啟用 harness，並證明它已啟用

文件記載的路徑需要執行兩個命令——先安裝外掛程式，再登入。

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",
    },
  },
}

harness 文件明確說明了兩點。外掛程式設定變更會在混合重新載入模式中自動套用，但現有聊天必須先執行 /new 或 /reset，下一個回合才會依據目前設定解析 harness。此外，有效的工具設定檔必須允許原生 shell 和檔案系統功能：coding 和 full 會允許，而 messaging 和 minimal 會停用原生介面。相同文件中的一般 OpenClaw 沙箱或受限工具政策是更窄的限制——除非你選擇實驗性的 sandbox exec-server 路徑，否則會停用原生程式碼模式；而當沙箱確實停用原生介面時，允許的 shell 命令仍可透過 sandbox_exec 使用。

版本需求已於 2026 年 9 月 21 日依據app-server 傳輸參考資料檢查：外掛程式管理穩定版 Codex app-server 0.154.0，而明確指定的自訂可執行檔、遠端 app-server 和 macOS 桌面二進位檔必須回報可解析的語意版本 0.149.0 或更新版本。npm 的最新 @openai/codex 同日為 0.155.1，因此受管理的固定版本落後一個修補版本——這就是為什麼未標日期、宣稱「Codex latest」的教學幾天內就會過時。遷移舊設定也很重要：agent-runtimes 頁面指出，OpenClaw 內建的 Codex CLI 後端已在 v2026.5.14 移除，而舊版 codex-cli/* 參照會修正為相同的 openai/<model> Codex app-server 路徑，且由 openclaw doctor --fix 一般負責舊版 Codex 路由修復。

驗證方式：Codex 支援的回合會在 /status 下回報 Runtime: OpenAI Codex，而 /codex status、/codex models 和 /codex binding 可檢查 app-server 狀態。lint——openclaw doctor --lint --only codex/managed-app-server --json——會檢查受管理的二進位檔，但文件說明它是唯讀的，且選定的 Codex Desktop 二進位檔、明確指定的自訂命令和遠端 app-server 不在該套件檢查範圍內。

在建置於此之上前，有一項值得了解的矛盾。OpenAI 自身的 app-server 文件指出：「app-server 命令和 WebSocket 傳輸是實驗性功能，不支援生產工作負載」——請注意，警告同時指向命令和傳輸。OpenClaw 在該命令之上建置了已發布的功能，而其 transport 欄位預設為 stdio，只有在設定 url 時才使用 websocket。兩項陳述可以同時成立；請在同時考量兩者的情況下做決定。

委派產物、權限、取消與恢復

harness 文件坦率說明了原生子代理程式狀態能證明的範圍：執行、工作結果和結果傳遞是彼此獨立的事實；閒置、中斷或卸載的原生執行緒不能證明工作成功；當無法取得明確的關閉確認時，工作會要求你重試關閉。原生 Codex 子代理程式是 Codex 自身的機制——明確的 OpenClaw 或 ACP 委派仍會透過 sessions_spawn 執行。

依據外掛程式設定欄位表，除非本機 Codex 需求不允許該設定，否則 app-server 所啟動的 OpenClaw 執行權限預設為模式 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 伺服器和原生 hook 中繼。OpenClaw 的 runtime v1 支援契約也列出不支援的項目：原生工具引數變更（事前工具 hook 可以阻擋，但 OpenClaw 不會重寫引數）、可編輯的 Codex 原生轉錄歷史、壓縮介入，以及逐位元模型 API 請求擷取。因此，如果你的稽核要求是取得確切的輸出請求，此執行環境無法提供。

授權、方案資格與 Token 用量是三件不同的事

內容取自OpenClaw 的 Codex app-server 政策頁面，日期為 2026 年 9 月 21 日。這裡還有一個命名陷阱：OpenAI 的 API 定價頁面指出，Priority processing 已於 2026 年 7 月 30 日更名為 Fast mode，且你可以傳送 service_tier，其值為 "priority" 或 "fast"；但 OpenClaw 的 appServer.serviceTier 記載 "priority" 和 "flex"，並將舊版 "fast" 正規化為 "priority"——方向正好相反。在兩個系統中，「開啟快速模式」代表不同含義。

第三方端點為何會離開 harness

這是大多數第三方文章最容易寫反的單一事實。對於未設定或為 auto 的供應商或模型執行環境，OpenClaw 的隱含代理程式執行環境表如下：

因此，將 OpenClaw 指向任何第三方 base URL——包括 Kunavo——會依設計使該回合使用 OpenClaw 內建的執行環境。單獨使用 openai/* 前綴永遠不會選取 harness，強制設定 agentRuntime.id: "codex" 也無法挽救它。執行環境頁面指出，該設定「要求已註冊的 Codex harness；不支援的路由／驗證會安全失敗，但已撰寫的請求覆寫可在執行前使用 Codex 宣告的精確請求 OpenClaw 後備方案」——因此結果只有兩種：回合失敗，或執行 OpenClaw 回合；兩者都不是在自訂端點上執行 Codex。外掛程式的已記載設定欄位也沒有模型 base-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、沒有 prompt-cache 提示、沒有 OpenAI 推理相容的 payload 重塑，也沒有隱藏的歸因標頭。線上沒有 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，並將 model_provider 和 model_providers 列為 Codex 在專案層級 .codex/config.toml 中會忽略的金鑰，因此供應商金鑰應放在使用者層級設定中。Kunavo 在 /v1/responses 提供原生 Responses 介面，這正是Codex CLI 設定可行的原因——但那是獨立的 Codex CLI，不是 OpenClaw harness，而且 Kunavo 尚未對任一用戶端進行執行環境測試。

軟體費用與 Token 費用

OpenClaw 本身是 $0。其文件索引將專案描述為採用 MIT 授權、由社群驅動、由獨立的 501(c)(3) 基金會開發，並標示「無付費方案」；@openclaw/codex 會免費發布在公開 npm registry 上。所有實際成本都是執行 Gateway 的機器加上模型用量，而模型用量會依三種合約之一產生。

取自 OpenAI 的Codex 定價頁面，檢查日期為 2026 年 9 月 21 日。該表格還有三項注意事項。定價卡只公布 Pro「$100 起」；OpenAI 另一篇關於 ChatGPT Pro 方案的文章列出較高的 $200 方案，但截至 2026 年 9 月 10 日，新註冊與升級已暫停，因此請在結帳時確認，不要以本頁未在定價卡上看到的數字編列預算。包含的用量只以每五小時期間的本機訊息估計範圍發布，而非固定訊息數量。此外，超過包含額度後的點數費率以每百萬 Token 的點數發布，而該定價頁面未提供點數的美元價值，因此無法為該列提供美元換算。另一方面，GPT-5.5 將於 2026 年 10 月 14 日從所有方案的 ChatGPT、ChatGPT Work 和 Codex 退役，但 OpenAI API 不受影響。

第三種合約是 OpenClaw 內建執行環境上的 Gateway。假設一個委派回合傳送 180,000 個未快取輸入 Token，並接收 9,000 個輸出 Token；費率是即時的Kunavo 目錄每百萬 Token 價格。

這些是示意性的 Token 算術，不是經測量的工作成本，也不是帳單上限——回合形狀是個假設，而真實的代理程式回合會在每次工具往返時重新傳送內容。Kunavo 的目錄金額是計費下限而非上限：上游回報費用時，帳單金額取目錄成本與上游成本乘以適用加成兩者中較高者。快取費用和外部工具不包含在此範例中。最低儲值金額是預付額度 $10，用於增加餘額而非購買方案——請參閱 計費詳細資料。

Kunavo 不提供嵌入模型、文字轉語音模型或語音轉文字模型。這些步驟在任何路由上都不是由 Kunavo 提供，因此請交由提供這些功能的供應商處理。

這項界線在此很重要，因為上方的介面表格將非代理程式的 OpenAI Platform 路由與 harness 分開，而 Gateway 金鑰只涵蓋 Kunavo 目錄中的聊天模型。

哪條路由勝出，取決於

如果答案是 Gateway 那一列，請先從Codex CLI 整合了解 Responses API 形式，再在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 registry 項目取得。每項聲明都連結至其來源頁面；文件未能確定的問題，文字會明確說明，而不是填補空白。Kunavo 未對 OpenClaw 或 Codex harness 執行任何執行環境測試，因此這裡的所有設定都是依據來源文件檢查，而非在 Kunavo 端點上實際展示。Kunavo 的 Token 費率來自即時目錄，每個美元數字都是示意性算術。