OpenClaw 部署避坑指南（坑，我替你踩完了）
整理版優先睇
OpenClaw 部署最大卡點係終端代理，用 AI 智能體幫手搞掂最穩陣
豆福係一個 AI 實踐者，分享實用 AI 技巧。呢篇文章講佢由零部署 OpenClaw 嘅踩坑經驗，原本諗住一個鐘搞掂，點知連環出事：環境依賴、OAuth 授權同 Bot 設置都卡住。最後佢用 Codex 自動回溯日誌解決問題。整體結論係：部署 OpenClaw 時，優先叫 Codex 或 Claude Code 幫手，而最大問題係國內用戶嘅終端代理同瀏覽器代理唔一致。
豆福發現，即使瀏覽器可以登入 Codex，終端唔行代理都會導致 API/OAuth 授權失敗。佢建議開 TUN 模式，或者直接 set 環境變數例如 export HTTP_PROXY=http://127.0.0.1:7890。另外，Bot 配對失敗多數係因為未配好配對碼，可以直接畀 Codex 處理。
最後佢提醒，玩 OpenClaw 養龍蝦（指 Claude）唔使買貴會員，用幾蚊月嘅 OpenAI Codex Business Team 車位就得，授權時揀 Team。終極竅門係直接叫 AI 智能體幫你部署，唔使自己搞。
- 部署 OpenClaw 卡住時，優先檢查 Homebrew/Node/npm 依賴、終端代理同 Bot 配對；其中代理係國內用戶最大卡點。
- 用 Codex 或 Claude Code 呢類 AI 智能體直接問錯誤訊息，可以最快解決環境依賴同設定問題。
- 瀏覽器代理同終端代理必須一致，建議開 TUN 模式或者 set HTTP_PROXY 等環境變數。
- Bot 冇回應多數係配對碼未成功，將配對碼直接畀 AI 智能體處理就得。
- 玩 OpenClaw 養龍蝦可以用平價 OpenAI Codex Business Team 帳號，授權時揀 Team 唔好揀個人。
OpenClaw 官方網站
部署 OpenClaw 嘅官方網址
Codex 客戶端下載
OpenAI 推出嘅 AI 智能體，用嚟幫手部署同除錯
代理環境變數設定指令
set 代理環境變數，解決終端代理問題。端口按本機代理設定調整。
OpenClaw 部署，坑我踩曬，你睇呢篇就夠
豆福係個 AI 實踐者，分享實用技巧。佢由零部署 OpenClaw，以為好快搞掂，點知連環中伏。
部署 OpenClaw 最大嘅教訓係：環境問題可以直接叫 AI 智能體幫手，唔使自己慢慢查。
呢篇文主要針對 macOS 本地部署，用 OpenAI Codex OAuth 做龍蝦大腦。Windows/Linux 都差唔多，細節可以自己搜。
第一坑：環境依賴亂曬龍
命令行出錯，好多時係 Homebrew/Node/npm 版本唔啱，或者環境變數未 set。
第二坑：API/OAuth 授權失敗（最大卡點）
OpenClaw 後台 chat 報錯，終端出 TypeError: fetch failed。根因係瀏覽器代理同終端代理唔一致。
瀏覽器登到 Codex 唔代表終端都得，API/OAuth 授權成敗取決於統一網絡環境。
解決方法：開代理嘅 TUN 模式，或者直接 set 環境變數，例如：
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7890第三坑：Bot 配對失敗
Bot 冇反應，通常係未同 OpenClaw 配對成功。
直接將 Bot 嘅配對碼 send 畀 Codex，等佢幫你搞掂配對程序。
點解揀 OpenAI Codex OAuth 嚟養龍蝦？
平價大碗。大部分朋友只係想試下 OpenClaw，唔值得買 Mac 或者訂幾百蚊嘅 Claude 會員。
氪金玩家可以直接上 Claude 頂級會員，唔使煩呢啲。
結語：終極竅門
記住一句話：叫 AI 智能體幫你部署 OpenClaw，你只要畀佢設定要求就得。
下載好 Codex 或者 Claude Code 會員，叫佢諗辦法部署，佢會一邊做一邊同你交互。如果你真係想手動，再參考網上教程。
大家好，我係仲學緊 AI 嘅豆福！AI 生成文字、圖像、影片、音樂，Roll！
（跨領域複合背景AIGC實踐者和創作者。分享實用嘅 AI 技巧，旨在幫大家用 AI 避開不必要嘅彎路。）
講起嚟，好耐冇更新喇。
今日嚟分享嚇實戰經驗—— OpenClaw 部署避坑指南。
官方網址🔗：https://openclaw.ai
（呢度就唔講 OpenClaw 係咩喇，科普文已經好多）
琴晚，我從零開始部署 OpenClaw，以為自己係個「行家」，一個鐘搞得掂嘅事，點知一路連環炒車：環境依賴、OAuth 授權同 Bot 設置，甚至一度懷疑係系統本身有問題。
後來我叫 Codex （OpenAI 推出嘅、面向軟件工程嘅 AI 智能體）自己將日誌完整回溯同解決問題。
劃重點
安裝 OpenClaw 嘅過程中，好多問題都可以叫 Codex 或者 Claude Code 這類 AI 智能體 自帶大模型（GPT-5.3 或者 Opus 4.6）解決，通俗啲講就係，直接問佢出現呢個問題，點樣解決。
OpenClaw 部署避坑指南（Mac 版）
適用場景：macOS 本地部署 OpenClaw ，用 OpenAI Codex OAuth 做龍蝦大腦🧠，Windows/Linux 玩家一樣（細微差別，可以自己揾下部署教程）。
前期準備
• ✅ OpenAI Business 團隊權限（請拉到最尾嘅温馨提示）；
• ✅ 下載並啟動 Codex 客戶端[1]
先講結論
如果你部署 OpenClaw 卡住，按呢個優先級排查：
1. Homebrew/Node/npm 依賴是否完整； 2. API/OAuth 授權登錄時，終端係咪行緊代理（唔係淨係睇瀏覽器）； 3. Bot 設置是否配對成功。
其中第 2 個坑，係國內用戶最大嘅問題！！！明嘅自然明。
第一坑：環境依賴
現象
• 命令行報錯，各種睇得明、睇唔明嘅錯誤
根因
• Homebrew/Node/npm 版本混用，變量未設置，安裝目錄唔啱。
解決
• （推薦）直接問 Codex 點解決，然後自己解決。
• 重新安裝 Homebrew/Node/npm 並設置環境變量
第二坑：API/OAuth 授權失敗（最大卡點）
現象
• OpenClaw 後台對話報錯
• 終端排查報 TypeError: fetch failed
關鍵根因（今次實證）
• 瀏覽器代理 和 終端代理 唔一致；
• 終端冇行代理，用國內網絡，被限制或者唔穩定
瀏覽器登錄到 Codex，唔代表終端登錄到，API/OAuth 授權成敗取決於統一嘅網絡環境。
解決
• （推薦）代理開啟 TUN 模式；
• 直接叫 Codex 設置代理環境變量，例如：
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7890端口按本機代理設置調整。
第三坑：Bot 配對
現象
• Bot 對話冇回應
根因
• Bot 未同 OpenClaw 配對成功
解決
• （推薦）直接將 Bot 嘅配對碼 send 畀 Codex。
點解揀 OpenAI Codex OAuth 養龍蝦
平靚正，考慮到絕大多數朋友玩 OpenClaw 養龍蝦，只係想試下，唔建議買 Mac 電腦或者訂閲幾百蚊嘅 Claude 會員。
💡温馨提示
閒魚淘寶幾蚊一個月嘅 OpenAI Codex Business Team 車位就得窮養龍蝦。跳轉瀏覽器授權時請揀 Team 而唔係個人。
課金玩家請忽略，請直接揀 Claude 頂級會員。
結語（終極秘訣）
講咗咁多，有咗 AI，反而大道至簡，回頭睇，其實記住一句話就夠喇：
我要用 Claude API 或 OpenAI Codex OAuth 方式配置 OpenClaw
下載並訂閲好 Claude Code 或者 OpenAI Codex 會員，send 畀佢諗辦法幫你部署，喺你同佢嘅互動過程中就部署咗，😄。
如果你真係想手動操作部署，參考下網上五花八門嘅教程都得，再見！
多謝睇到呢度，如果呢篇文章對你有用，不妨順便讚好♡｜轉發📪｜留言📣，呢個會鼓勵我分享更多內容……
如果有進一步探討嘅地方，可以掃下面👇二維碼加豆福，免費送你 AI 知識禮包🎁。
引用連結
[1] Codex 客戶端: https://openai.com/zh-Hans-CN/codex
大家好，我是還在學習 AI 的豆福！AI 生文、圖、視頻、音樂，Roll！
(跨域複合背景AIGC實踐者和創作者。分享實用的 AI 技巧，旨在幫助大家用 AI 避開不必要的彎路。)
說起來，斷更很久了。
今天來點實操經驗分享下—— OpenClaw 部署避坑指南。
官方網址🔗：https://openclaw.ai
（這裏就不扯什麼是 OpenClaw 了，科普文已經很多了）
昨晚，我從零部署 OpenClaw，本以為是個“行家”，一個小時就搞定的事情，結果一路連環翻車：環境依賴、OAuth 授權和 Bot設置，甚至一度懷疑是系統本身有問題。
後來我讓 Codex （OpenAI 推出的、面向軟件工程的 AI 智能體）自己把日誌完整回溯並解決問題。
敲黑板重點
安裝 OpenClaw 過程中，很多問題都可以讓 Codex 或者 Claude Code 這類 AI 智能體 自帶大模型（GPT-5.3 或者Opus 4.6）解決，通俗點就是，直接問它出現這個問題，怎麼解決。
OpenClaw 部署避坑指南（Mac 版）
適用場景：macOS 本地部署 OpenClaw ，使用 OpenAI Codex OAuth 作為龍蝦大腦🧠，Windows/Linux 玩家同理（細微差別，可自行搜一下部署教程）。
前期準備
• ✅ OpenAI Business 團隊權限（請拉到最後温馨提示）；
• ✅ 下載並啓動 Codex 客戶端[1]
先說結論
如果你部署 OpenClaw 卡住，按這個優先級排查：
1. Homebrew/Node/npm 依賴是否完整； 2. API/OAuth 授權登錄時，終端是否走代理（不是隻看瀏覽器）； 3. Bot 設置是否配對成功。
其中第 2 個坑，是國內用戶最大的問題！！！懂得都懂。
第一坑：環境依賴
現象
• 命令行報錯，各種看懂的，看不懂的錯誤
根因
• Homebrew/Node/npm 版本混用，變量未設置，安裝目錄不對。
解決
• （推薦） 直接問 Codex 怎麼解決，並自行解決。
• 重裝 Homebrew/Node/npm 並設置環境變量
第二坑： API/OAuth 授權失敗（最大卡點）
現象
• OpenClaw 後台聊天報錯
• 終端排查報 TypeError: fetch failed
關鍵根因（本次實錘）
• 瀏覽器代理 和 終端代理 不一致；
• 終端沒走代理，使用國內網絡，被限制或不穩定
瀏覽器能登錄Codex，不代表終端能登錄，API/OAuth 授權成敗取決於統一的網絡環境。
解決
• （推薦） 代理開啓 TUN模式；
• 直接讓 Codex 設置代理環境變量，比如：
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7890端口按本機代理設置調整。
第三坑：Bot 配對
現象
• Bot 交流無回應
根因
• Bot 未跟 OpenClaw 配對成功
解決
• （推薦） 直接把 Bot 的配對碼發給 Codex。
為什麼選 OpenAI Codex OAuth 養龍蝦
便宜大碗，鑑於絕大多數朋友玩 OpenClaw 養龍蝦，僅僅是嚐鮮，不建議買 Mac 電腦或訂閲幾百塊的 Claude 會員。
💡温馨提示
某魚某寶幾元/月的 OpenAI Codex Business Team 車位即可窮養龍蝦。跳轉瀏覽器授權時請選 Team 而非個人。
氪金玩家請忽略，請直接選擇 Claude 頂級會員。
結語（終極竅門）
說了這麼多，有了 AI，反而大道至簡了，回頭看，其實記住一句話就夠了：
我要用 Claude API 或 OpenAI Codex OAuth 方式配置 OpenClaw
下載並訂閲好 Claude Code 或者 OpenAI Codex 會員，發給它想辦法給你部署，在你跟它的交互過程中就部署了，😄。
如果你真想手動操作部署，參考下網上五花八門的教程也是可以的，再見！
感謝看到這裏，如果這篇文章對你有用，不妨順便點贊♡｜轉發📪｜評論📣，這將會激勵我分享更多內容……
如有進一步探討的地方，可掃下方👇二維碼添加豆福，免費送你 AI 知識禮包🎁。
引用連結
[1] Codex 客戶端: https://openai.com/zh-Hans-CN/codex