~/blog/openclaw-chatgpt-oauth-gpt54-no-api-key

OpenClaw · part 11

[AI Agent] openclaw + ChatGPT OAuth:不買 API 額度也能用 GPT-5.4

2026-03-24更新於 2026-04-072 分鐘閱讀#openclaw#gpt-5.4#chatgpt#oauthEnglish
cat --toc

TL;DR

openclaw models auth login --provider openai-codex 讓你用 ChatGPT Plus 帳號把 GPT-5.4(100 萬 token context)加進 openclaw,不需要 OpenAI API key。三個地雷:需要互動式 terminal、auth 後要重啟 gateway、default model 要另外設定。

白話版:你的 ChatGPT Plus 訂閱其實能做更多

很多人每個月付 20 美金訂 ChatGPT Plus,用來聊天、寫文章、問問題。但很多人不知道,你其實可以把 ChatGPT Plus 裡那顆 GPT-5.4 拿來給其他工具接,不只是在 ChatGPT 網頁版用。

openclaw 是一個開源的 AI agent 框架,讓你在自己的電腦上跑 AI 助手。2026 年 3 月的更新加了一個功能:用你的 ChatGPT Plus 帳號登入,你的 agent 就能直接使用 GPT-5.4,不需要另外買 OpenAI 的 API 額度。

這代表什麼?如果你本來就在付 ChatGPT Plus,你現在可以讓自己的 AI agent 也用到同一個模型的能力——100 萬 token 的上下文視窗、最新的推理能力——而且不用多花一毛錢。就像你已經有健身房月費了,現在發現原來游泳池也包含在裡面。

設定大概五分鐘,但官方文件漏了三個關鍵點。下面把流程跑一遍。


2026.3.13 改了什麼

openai-codex provider 更早的版本就有,但 auth 流程有 bug——登入成功後會把 Codex OAuth token 拿去打 OpenAI Responses API 做驗證,然後被拒絕。2026.3.13 修掉了這個問題,現在登入流程可以正常完成,token 會寫進 ~/.openclaw/openclaw.json

跑 Auth 流程

一行指令:

openclaw models auth login --provider openai-codex

它會開瀏覽器到 https://auth.openai.com/oauth/authorize,用 ChatGPT 帳號登入,callback 回來後 token 就寫好了。

地雷一:需要互動式 terminal。 透過 SSH 跑會直接噴錯:

Error: models auth login requires an interactive TTY.

要在安裝 openclaw 的機器上直接執行——坐在那台電腦前,或用螢幕分享/遠端桌面。ssh -t 沒用,因為 OAuth callback 是跑在 localhost,不能被 proxy 過去。

登入成功後 terminal 會顯示:

◇  OpenAI OAuth complete
Config overwrite: /Users/coolthor/.openclaw/openclaw.json (sha256 b6289... -> d6fae...)
Updated ~/.openclaw/openclaw.json
Auth profile: openai-codex:default (openai-codex/oauth)
Default model available: openai-codex/gpt-5.4 (use --set-default to apply)

Config 已經寫進去,gateway 的 file watcher 也會偵測到變更。但這時候跑 openclaw models list 還看不到 GPT-5.4。

設定 Default Model

地雷二:model 不會自動設成 default。 auth 輸出說「use --set-default to apply」,但那個 flag 只在互動式 auth login session 裡有效,事後沒辦法用。

用 config 指令設定:

openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4

重啟 Gateway

地雷三:gateway 要重啟。 動態 config reload 對大部分設定變更都吃得到,但 model provider registration 不會跟著 reload。

# macOS launchd
launchctl stop ai.openclaw.gateway
launchctl start ai.openclaw.gateway

重啟後 openclaw models list 就會出現新的 model,agent 也會開始用 GPT-5.4 作為 primary。

GPT-5.4 帶來什麼

100 萬 token context window,128,000 token 最大輸出。對於要用 Telegram 跑長篇研究或吃大檔案的 agent,就不會像本地 120B 模型那樣很快撞到 128K 上限。

代價是:GPT-5.4 跑在 OpenAI 的 server,不是本機。agent 傳送的任何內容都會經過 ChatGPT 後端。如果 agent 在處理交易紀錄或其他私人資料,換 primary model 之前要想清楚。

整理一下學到什麼

最花時間的地方: TTY 那關。錯誤訊息寫得清楚,但「互動式 TTY」不會直接讓人想到「去開螢幕分享」。ssh -t 看起來應該能解決,試了才發現沒用。

下次遇到類似問題可以先想到的: openclaw config 改了但 models list 沒反應,幾乎都是少了重啟 gateway 這步。file-watcher reload 確實有,但它只 reload 憑證和路由;provider registration 還是要整個重啟才會生效。

記住這一件事: 只要 auth flow 的 callback 是 localhost(像這裡的 localhost:1455/auth/callback),就沒辦法透過 SSH 跑。瀏覽器、CLI、callback listener 三個要在同一台機器上,缺一不可。

操作清單

  1. 確認 openclaw 版本 ≥ 2026.3.13
  2. 在 gateway 機器上直接執行(不是透過 SSH):openclaw models auth login --provider openai-codex
  3. 在自動開啟的瀏覽器完成 ChatGPT 登入
  4. 執行 openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4
  5. 重啟 gateway:launchctl stop ai.openclaw.gateway && launchctl start ai.openclaw.gateway
  6. openclaw models list 確認

同系列其他文章:第 10 篇 — Telegram sendMessageDraft Streaming

常見問題

怎麼在 openclaw 裡用 GPT-5.4 又不買 OpenAI API 額度?
跑 `openclaw models auth login --provider openai-codex` 然後用 ChatGPT Plus 帳號登入。openclaw 會把 OAuth token 存到 `~/.openclaw/openclaw.json`,之後透過 Codex endpoint 呼叫 GPT-5.4,不需要另外開 OpenAI 帳單。
openclaw + ChatGPT OAuth 需要 ChatGPT Pro 還是 Plus 就夠?
Plus 就夠。OAuth 用的就是 ChatGPT 網站的同一組憑證,agent 拿到的是同一顆 GPT-5.4,context window 一樣 105 萬 token。
為什麼 `openclaw models auth login` 在 SSH 上會顯示 requires an interactive TTY?
OAuth callback 要在 localhost 開瀏覽器,`ssh -t` 沒辦法 forward。要直接在裝 openclaw 的機器上跑——坐在電腦前,或用螢幕分享、VNC。登入一次之後 token 會存下來,後續不需要 TTY。
OAuth 登入後為什麼 openclaw 還是用舊的模型?
auth 和預設模型是分開的設定。登入後必須重啟 gateway,然後另外指定預設模型:改 `~/.openclaw/openclaw.json` 把 active profile 指到 `openai-codex/gpt-5.4`,或跑 `openclaw models set-default`。release notes 沒寫清楚這一步。