OPenClaw 作為開源 AI 閘道，使用中常遇到 HTTP 報錯讓新手頭痛。本文聚焦 403 與 429 兩種高頻錯誤碼，幫助你快速定位問題、恢復呼叫。
收到 403 錯誤時，首先檢查 API 金鑰是否過期或未被啟用。OPenClaw 控制台裡可以重新產生金鑰，記得複製後及時更新到設定檔中。另外，部分模型供應商對來源 IP 有白名單限制，如果你用的 VPS 或代理 IP 不在允許範圍，也會回傳 403。登入後台查看「允許 IP」設定，加入目前出口 IP 即可解封。還有一種情況是你在免費額度用完後繼續請求，帳戶會被暫時限制，這時需要充值或切換到付費方案。
429 表示你在短時間內發了太多請求，超過了 OPenClaw 設定的速率閾值。解決方案很簡單：暫停發送，等待幾十秒再重試。更根本的做法是在程式碼裡加入指數退避重試邏輯，例如每次失敗後等待 2 秒、4 秒、8 秒逐步延長。同時檢查你的 API 呼叫方案，OPenClaw 的不同方案對每分鐘請求數（RPM）有不同上限，升級方案能獲得更高配額。如果使用的是共享金鑰，不要跟別人同時跑大量請求，最好申請獨立 API Key。
偶爾會遇到 500 內部伺服器錯誤或 502 閘道超時，這通常是 OPenClaw 後端或上游供應商的問題。可以先等 5 分鐘再試，如果持續出現，前往官方 GitHub Issues 或 Discord 群回報。留意當前狀態頁（status.openclaw.com）查看是否有服務中斷公告。本地除錯時建議開啟詳細日誌，能幫你更快鎖定到底是設定問題還是伺服器端問題。養成定期更新 OPenClaw 映像檔的習慣，舊版本有已知 bug 也會觸發這些錯誤。
