OpenClaw 呼叫海外模型失敗，先別急著更換 API 金鑰
OpenClaw 連線海外模型時，常見的表面症狀包括請求逾時、回應停在等待狀態、TLS 錯誤，或模型供應商回傳連線失敗。這些現象不一定代表 API 金鑰失效，也可能是 OpenClaw 所在裝置沒有把模型請求送到合適的網路出口。尤其是瀏覽器能開啟模型服務的網站，並不等於 OpenClaw 的背景程序也會使用相同代理：瀏覽器可能遵循系統代理設定，終端工具、容器或服務程序卻可能直接連線。
排查時，先把整個請求流程拆開來看。OpenClaw 的模型請求通常會連到你所設定的 API 網址；登入、金鑰驗證、模型清單或管理介面則可能使用不同服務端點。若你透過相容 API、模型閘道或自架中介服務，實際目的地又會以該服務的設定為準。因此，不宜未經確認就把網路問題簡化成「某個固定網域必須代理」，也不要直接套用來路不明的網域清單。更可靠的做法是先確認請求目標，再用 Clash 的連線記錄驗證它實際命中了哪條規則。
Clash 在這裡負責的是代理連線與流量分流，不會替 OpenClaw 修正錯誤的 API 網址、模型名稱、認證格式或服務商限制。若供應商本身回傳無效金鑰、沒有模型權限或超出額度，切換代理通常無法解決。反過來說，若錯誤是連線逾時或 TLS 握手未完成，先核對代理模式、規則與節點，往往比反覆重新產生金鑰更有效率。
開始調整前：確認 OpenClaw 與 Clash 的實際環境
動手改設定前，先記下目前使用的模型供應商、API 基底網址、模型識別名稱，以及 OpenClaw 的執行方式。桌面程式、終端程序、Docker 容器、遠端主機上的服務，可能各自有不同的網路環境；同一份 API 設定在不同環境中，也不一定會走同一個代理。若 OpenClaw 執行在容器或另一台主機上，本機 Clash 的系統代理通常不會自動跨越到該環境，必須確認容器網路或遠端主機另有正確的代理路徑。
接著確認 Clash 客戶端已載入有效設定檔，核心正在運作，而且節點本身可以連線。Clash Verge、Clash Verge Rev、Mihomo Party 等圖形介面的選單名稱可能隨版本不同；不必拘泥於固定按鈕位置，重點是確認目前設定檔已啟用、代理模式清楚可辨，並能在代理頁選到可用策略組或節點。若核心尚未啟動、設定檔解析失敗，或節點已失效，OpenClaw 的錯誤只是後續結果，不是應先調整的根因。
也請檢查系統時間、網路狀態與其他 VPN 或代理程式。系統時間偏差可能造成 HTTPS 憑證驗證問題；另一個 VPN 可能接管預設路由；環境變數則可能讓終端中的 OpenClaw 指向不同代理。若你不確定目前有哪些環境變數，可在啟動 OpenClaw 的同一個終端中檢查 HTTP_PROXY、HTTPS_PROXY 與 NO_PROXY。排查期間避免同時更動核心、DNS、API 金鑰與節點，否則即使問題消失，也很難確認真正有效的變更。
匯入 Clash 設定並確認代理節點可用
如果尚未在 Clash 中匯入設定，請使用服務提供者交付的設定檔或訂閱連結，並確認來源可信。訂閱連結通常包含帳戶識別資訊，不應貼到公開聊天室、截圖或第三方除錯網站。匯入後先等待客戶端完成更新，再確認設定檔已成功載入；若畫面顯示 YAML 格式錯誤、代理節點為空，或策略組沒有成員，OpenClaw 當然無法透過一條不存在或無效的代理路徑連線。
接著到代理頁選擇策略組，再從組內挑一個節點。先使用單一、已知可用的節點進行測試，比同時加入多層策略組、負載平衡或自動切換更容易定位問題。延遲測試只能反映探測網址在當下的回應時間，不能保證特定模型 API 一定可達；若節點測速很快，但 OpenClaw 仍逾時，還要檢查該節點出口是否能連到你設定的供應商服務。
設定檔更新後，也要留意本地自訂規則是否被覆蓋。有些訂閱更新會重新產生完整設定，手動加入的規則可能因此消失。若你需要長期維護 OpenClaw 專用分流，應使用客戶端支援的覆寫或合併方式，並保留原始設定備份。不要直接在不清楚用途的區段大量貼入網路上的 YAML；縮排錯誤、重複規則或節點名稱不符，都可能讓核心無法啟動。
切換代理模式：判斷 OpenClaw 流量是否命中規則
Clash 常見的規則、全域與直連模式，決定了流量如何送出。規則模式會依設定檔中的規則挑選策略；全域模式則把大部分符合代理條件的流量交給目前選定的代理策略，適合短時間確認是否為分流造成的問題；直連模式不會按照一般代理路徑轉送外部請求，不適合拿來測試「透過代理是否能連線」。不同客戶端的操作名稱可能略有差異，請以目前介面顯示的模式和核心狀態為準。
建議先在規則模式下重現一次 OpenClaw 的錯誤，同時開啟 Clash 的連線記錄，尋找請求發生時出現的主機名稱、規則類型、命中策略與連線結果。若記錄顯示目標連線命中直連，而你預期它應經過代理，就要檢查規則順序、目標網域與策略組。若它已命中代理策略，卻仍然逾時，則要進一步測試節點、DNS 與上游服務，而不是不斷重複新增相同規則。
全域模式可以作為短暫的對照測試：先記錄規則模式下的結果，再切到全域模式，以相同模型、相同請求內容重試。若全域模式成功、規則模式失敗，問題較可能落在分流規則或規則所指向的策略組；若兩種模式都失敗，便應把檢查範圍擴大到節點可達性、代理是否被 OpenClaw 繞過、API 設定及服務商狀態。測試完成後，記得切回符合日常需求的模式，避免讓不相關的流量長時間套用全域代理。
規則應以實際觀察到的請求目標為依據。若模型 API 使用自訂網域或中介服務，單純加入某家模型供應商的常見網域後綴未必有效；相反地，過寬的網域規則可能把無關服務也送進同一個出口。修改後只需重新載入設定，並再次查看連線記錄，確認新規則確實先於可能攔截它的廣泛規則生效。若問題出在 DNS 解析或規則使用 IP 位址，則要依核心設定與客戶端日誌判斷，不宜只靠猜測新增網域。
讓 OpenClaw 使用正確的代理入口
Clash 的系統代理開關，主要是讓支援系統代理設定的應用程式使用本機代理；終端程式、背景服務與容器不一定會自動跟隨。若 OpenClaw 是從終端啟動，可先確認它支援的代理設定方式，並在相同執行環境中設定 HTTP 與 HTTPS 代理變數。常見情況會使用本機回環位址與 Clash 的 HTTP 或混合連接埠，例如：
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890
上述連接埠只是常見示例，實際值必須以 Clash 設定檔中的 port、mixed-port 或客戶端顯示值為準；不要在未確認的情況下直接照抄。若你使用 SOCKS 代理，則應確認 OpenClaw 或其底層網路函式庫支援該協定，再設定對應格式。代理網址通常應指向執行 OpenClaw 的同一個網路環境：在本機終端執行時，127.0.0.1 指向本機；但在容器內，這個位址通常指向容器自身，而不是宿主機上的 Clash。
設定好環境變數後，請在該終端重新啟動 OpenClaw。已經開啟的程序通常不會自動讀取後來新增的環境變數；若你從桌面捷徑啟動，它也可能沒有繼承終端中的設定。相反地，若 OpenClaw 本身已提供代理欄位，就應先確認它是否優先使用自己的設定，避免應用程式內的代理與環境變數互相衝突。除非文件明確要求，不要同時設定多個不同代理入口。
NO_PROXY 也值得檢查。若其中包含模型 API 的主機名稱或過寬的網域範圍，該請求可能被排除在代理之外；若沒有必要的本機例外，則本機回呼或內部服務又可能被錯誤送往代理。以最小範圍調整例外項目，並在每次變更後重啟程序測試，通常比整份清空更安全。請勿把 API 金鑰寫進公開的啟動腳本、命令列截圖或可分享的設定檔。
從連線記錄與錯誤訊息縮小問題範圍
排查時，請每次只改一個條件，並記下測試時間、使用的代理模式、節點名稱和 OpenClaw 回報。若連線記錄完全沒有出現模型 API 的目標主機，可能是 OpenClaw 沒有走本機 Clash、請求尚未送出，或代理變數沒有被程序讀取。若記錄有請求但顯示直連，應回頭核對規則與程序實際使用的 DNS 結果。若請求命中代理後立即失敗，再檢查節點狀態、出口可達性及核心日誌。
不同錯誤類型也能提供線索。DNS 解析失敗時，先確認 Clash 的 DNS 設定、網路是否可用，以及目標主機名稱是否拼寫正確；TLS 憑證或握手錯誤時，核對系統時間、代理出口與是否有其他安全軟體攔截 HTTPS；連線逾時則確認請求究竟直連還是經代理，以及所選節點是否能穩定連到目標服務。若服務回覆 HTTP 401、403 或模型不存在，則應優先檢查金鑰、帳戶權限、模型名稱與 API 端點，這些通常不是更換代理模式就能修好的問題。
也可以用與 OpenClaw 相同的執行環境做最小化測試：從同一個終端或容器檢查代理連接埠是否可達，再對照 Clash 連線記錄。若命令列測試成功、OpenClaw 失敗，差異可能在 OpenClaw 的代理支援、應用程式設定或程序環境；若兩者都失敗，則先回到節點與規則層。測試過程不要把含有認證資訊的完整請求、環境變數輸出或除錯日誌貼到公開平台；必要時先遮蔽金鑰、帳戶識別碼與私人端點。
最後，將可用設定整理成容易回復的狀態：記錄有效的代理入口、確認過的 API 主機名稱、對應策略組及必要的本地規則，並備份修改前的設定檔。若某次訂閱更新後問題重現，便能比對規則是否消失；若更換節點後失敗，也能快速還原到先前已驗證的組合。這比一次修改 DNS、代理模式、核心版本與規則集更容易保留可重現的排查線索。
有些只提供單一系統代理開關的工具，對終端、容器或自訂 API 網址的分流控制較有限；而手動維護多套代理設定，則容易忘記哪個程序使用哪個出口。使用 Clash 搭配 OpenClaw 的好處，是能從規則、策略組與連線記錄逐項核對，並按實際 API 目標調整路由。若你希望在同一個介面管理設定檔、切換代理並觀察連線狀態，可依自己的作業系統挑選合適客戶端，從 前往下載開始。