OpenClaw常見問題解答：API金鑰、計費帳單與帳戶安全

API金鑰相關常見問題

問題：API金鑰突然失效，無法調用模型怎麼辦？
OpenClaw的API金鑰可能因過期、被手動撤銷或觸發安全限制而失效。首先登入OpenClaw控制台，在「API Keys」頁面檢查金鑰狀態。若顯示「Inactive」，請重新產生一個金鑰並替換舊金鑰。注意：每個帳戶最多可建立5個有效金鑰，頻繁輪換時記得刪除不再使用的舊金鑰。

問題：呼叫API時返回401錯誤如何排查？
401表示身分驗證失敗。請確認請求標頭中「Authorization」欄位格式為「Bearer <your_api_key>」，且金鑰未包含多餘空格。若使用環境變數儲存金鑰，檢查變數名稱是否拼寫正確。另外，免費試用帳戶的金鑰可能在試用期結束後自動停用，需升級為付費計畫才能繼續使用。

計費與帳單問題

問題：為什麼帳單金額超出我的預期？
OpenClaw按token計費，不同模型的價格不同。超出預期可能源於：1）啟用了高精度模型（如Claw-4）但未留意單價；2）請求中包含了大量系統提示或歷史對話，導致實際消耗token數較高。建議在API請求中設定「max_tokens」限制，並在控制台「Usage」頁面查看每日/每小時消耗明細。若發現異常峰值，檢查程式碼中是否有迴圈錯誤。

問題：訂閱後如何申請稅務發票？
在OpenClaw帳戶設定中找到「Billing」板塊，點選「Invoice History」並選擇需要開票的帳單記錄。支援填寫公司名稱、稅號和註冊地址。注意：個人帳戶只能開立個人發票，企業認證後可選企業發票。發票通常會在申請後3-5個工作天傳送至註冊信箱。

帳戶安全與權限管理

問題：如何防止API金鑰被他人濫用？
OpenClaw提供「IP白名單」功能，在「Security」介面可設定允許呼叫API的IP範圍。如果不確定IP，可使用「臨時金鑰」機制，設定有效期限（如1小時）。另外，建議不要將API金鑰直接寫在前端程式碼中，改用後端代理轉發。定期在控制台查看「API Logs」可發現異常呼叫來源。

問題：帳號被鎖定後如何解鎖？
帳號鎖定通常因多次登入失敗或超出API呼叫頻率限制。可嘗試以下步驟：1）等待15-30分鐘自動解鎖（短時鎖）；2）重設密碼後再次登入；3）若顯示「Suspended」，請聯絡OpenClaw客服並提供註冊信箱，說明情況。注意：違反服務條款（如大量註冊、惡意爬取）可能導致永久封禁，且不支援申訴。