使用 OPenClaw 進行 AI 開發時，難免會被各種報錯卡住。無論是 API 呼叫失敗還是帳戶權限問題，這篇文章整理了幾個高頻錯誤代碼與對應的排查思路，希望能幫你少走冤枉路。
API 認證報錯：401 與 403
遇到 401 Unauthorized 通常代表你的 API 金鑰無效或已過期。請先檢查金鑰是否被誤刪字元，再到 OPenClaw 控制台的「API Keys」頁面重新產生一組，注意複製時別漏掉前後空白。而 403 Forbidden 一般是因為該金鑰沒有存取某個介面的權限，登入後台查看角色權限設定，確認是否已為你的帳號分配正確的 Scope。
請求超時與網路問題：408 與 429
408 Request Timeout 表示伺服器等待你的請求時間過長，常見原因包括網路延遲高或請求本體過大。建議將單次請求的資料量控制在 2MB 以內，並檢查你的網路代理是否穩定。429 Too Many Requests 則是觸發了速率限制，OPenClaw 對每個帳號有每分鐘請求次數上限。此時可以先等 60 秒再試，或者升級方案提高配額，避免頻繁輪詢。
伺服器端異常：500 與 502
500 Internal Server Error 屬於伺服端暫時性故障，通常 OPenClaw 團隊會在幾分鐘內修復。你可以先前往 status.openclaw.com 查看服務狀態，若顯示正常就重試一次；若持續報錯，建議聯繫技術支援並提供完整請求日誌。502 Bad Gateway 偏向閘道層問題，等待 5 分鐘後重試多半能恢復，請不要反覆重新整理頁面。
帳戶鎖定與訂閱限制
如果登入後出現 Account Locked，很可能是多次輸入錯誤密碼或偵測到異常登入。可以透過綁定的電子郵件重設密碼，並檢查最近登入記錄。另外，部分高階功能需要特定訂閱才能使用，報錯 400 Bad Request 並附帶「insufficient plan」訊息時，代表你的方案不支援該操作，建議升級至 Pro 版本。
日常避坑小秘訣
養成每次修改程式碼或設定後先執行一次小規模測試的習慣，能避免大量報錯。同時保持 OPenClaw SDK 版本為最新，舊版本可能因介面變更而產生詭異錯誤。遇到看不懂的報錯時，直接查閱官方文件的 Error Code 說明頁，那裡往往有最準確的解釋。
