OpenClaw + OpenAI OAuth 完整攻略
兩條 OpenAI 認證路徑
OpenClaw 支援兩種 OpenAI 接入方式，這是最核心的區別：
路徑 A：API Key（按量計費） — 在 platform.openai.com 取得 API key，走標準 per-token 計費。適合需要精確控制成本或自動化重度使用的場景。
路徑 B：Codex OAuth（訂閱制） — OpenAI 明確支援在 OpenClaw 等外部工具中使用訂閱 OAuth。這讓你用現有的 ChatGPT Plus/Pro/Max 訂閱來驅動 OpenClaw，不額外產生 API 費用。這是目前社群公認最划算的方式。
設定步驟
-
安裝 OpenClaw（需 Node ≥22）：
npm install -g openclaw@latest -
啟動 onboarding wizard 選擇 Codex OAuth：
openclaw onboard --auth-choice openai-codex或直接登入：
openclaw models auth login --provider openai-codex -
瀏覽器會打開 OpenAI 授權頁面，登入你的 ChatGPT 帳號並授權連線。如果是遠端/headless 伺服器，需要手動把 redirect URL 貼回終端。
-
確認設定：
openclaw models status --plain應該會看到
openai-codex/gpt-5.3-codex作為 active model。 -
Config 結構（在
openclaw.json5中）：{ agents: { defaults: { model: { primary: "openai-codex/gpt-5.3-codex" } } } }
OAuth Token 機制
OpenClaw 會自動處理 token refresh — 當 access token 過期，系統會用 refresh token 自動更新。Credentials 存在 ~/.openclaw/credentials/oauth.json，首次使用後匯入 auth-profiles.json。
注意：如果你同時在 OpenClaw 和 Codex CLI 登入同一個帳號，OAuth provider 可能在發新 refresh token 時作廢舊的，導致其中一邊被「登出」。
重要限制：OAuth ≠ 完整 ChatGPT 功能
openai-codex provider 只提供模型存取權限，不會自動解鎖 web search 或語音功能。你還需要：
- Web search：另外設定 Brave Search API key（或 Perplexity/OpenRouter）
- 語音轉文字：需要本地 Whisper 或另外配置 transcription API（OpenAI Platform / Groq / Deepgram）
- Embeddings：Codex 訂閱不包含 embeddings，需另設 OpenAI API key 來用 text-embeddings-3（成本極低）
從 Claude 切換到 OpenAI 的方法（5 分鐘）
這是目前社群最熱門的操作。OpenClaw 創辦人在節目中確認 Anthropic 已正式封鎖 Claude 訂閱 OAuth 用於 OpenClaw。切換步驟：
# 先備份
cp -r ~/.openclaw ~/.openclaw-backup
# 執行切換
openclaw onboard --auth-choice openai-codex
# → 選 Quickstart
# → 選 "Use existing values"（千萬別選 Reset）
# → 瀏覽器授權
openclaw models set openai-codex/gpt-5.3-codex
選「Use existing values」會保留所有 channels、memory 設定和 cron jobs，只更換認證方式。
合規性現況
- OpenAI：明確支援訂閱 OAuth 在 OpenClaw 等外部工具中使用，但仍可能對超大量自動化使用進行 rate limit
- Anthropic：已封鎖 — 只能用 API key（按量計費），不能用 Pro/Max 訂閱 token
- Google：有人回報 Google 因 ToS 違規終止帳號，風險較高
社群討論重點（Discord / Reddit / GitHub / X）
Reddit 上直接搜到的 OpenClaw 帖子不多（主要討論集中在 Discord「Friends of the Crustacean 
」 和 GitHub Discussions），但從各社群綜合來看，幾個核心討論主題：
1. 成本是最大話題
Reddit 用戶估計用 API 方式運行 OpenClaw 的「個人助理」體驗每月要 $300-750，一個 Reddit thread 直接標題就是「Clawdbot/Moltbot Is Now An Unaffordable Novelty」。很多人發現只要用 ChatGPT 訂閱 OAuth 而非 API key，就能從數百美金降到 $20/月。
2. Claude → OpenAI 大遷移
社群共識已經很明確 — 大多數 OpenClaw 社群成員已經規劃切換到 ChatGPT Codex 訂閱，因為 OpenAI 不反對 OAuth token 在第三方工具中使用。Discord 上有人分享從 Anthropic API 每天 $100 直接歸零的經驗。
3. 「是否合法/安全？」的疑慮
Discord 社群裡反覆出現這個問題 — 社群版主的回答是：「沒有人能保證 OpenAI 認為 ChatGPT 訂閱的 fair use 是什麼」，但 OAuth flow 和 Codex CLI 用的是同一類認證，不是逆向工程，所以風險相對可控。
4. 常見技術問題
- OAuth 過程中出現
TypeError: fetch failed是最常見問題，通常是 Node 版本不對（需 22+）或 headless 環境下無法完成 callback - Headless 伺服器需要在有瀏覽器的本機完成 OAuth，再把
oauth.json複製過去 - Token refresh 衝突（同時跑 Codex CLI + OpenClaw）
5. 分層架構建議
進階用戶建議的架構是：Layer 1 用本地開源模型做大量工作，Layer 2 用 OpenAI 訂閱做推理/合成，Layer 3 只在需要 Claude 獨特能力時才用 Anthropic API key。
對 Tenten 的實務建議
考慮到你目前的 OpenClaw 架構和 OpenRouter 分層策略，OpenAI Codex OAuth 可以作為一個穩定的 $20/月 fallback 層，搭配你現有的 MiniMax M2.5 / Kimi K2.5 分流方案。主要注意 embeddings 需要另外設 API key，以及 web search / voice 等工具需要獨立配置。