OpenClaw 429 錯誤：Claude API 限流後如何切換 Token 和備用模型完整教學
常見情況：OpenClaw 在執行任務時突然停下，你的 Telegram/Discord 收到訊息：rate_limit_error: Rate limit reached for organization... Limit 250000, Used 250000，或者直接看到 HTTP 429 錯誤。你的 Claude API 配額用完了，OpenClaw 不知道該怎麼辦。
什麼是 API 429 限流？為什麼 OpenClaw 會遇到？
Claude API（Anthropic）和 GPT API（OpenAI）都有「速率限制（Rate Limit）」，也就是在特定時間內你最多能發送多少 Token 的請求。超過這個上限，API 就會返回 HTTP 429 狀態碼，拒絕接受新的請求。
OpenClaw 是一個全天候運行的 AI Agent，你設定的定時任務、自動回覆、背景分析都在不斷消耗 API 配額。很多用戶在設定完 OpenClaw 後，第一、二天興奮地瘋狂使用，很快就把 Claude API 的月度或每日配額耗盡，導致 429 錯誤。
快速確認：你遇到的是哪種限流？
# 查看目前 API 使用狀態
openclaw models status
# 深度診斷（包含限流狀態）
openclaw status --deep
# 查看最近的限流錯誤日誌
grep -i "429\|rate_limit\|quota" ~/.openclaw/logs/openclaw.log | tail -20
訊息：rate_limit_error, retry after 60 seconds
原因：這一分鐘內的 Token 消耗超過上限。通常 60 秒後自動恢復，不需要手動處理。
訊息：daily token quota exceeded, resets at UTC midnight
原因：今天的 Token 配額已全部用完。需要等到明天 UTC 0 點重置，或立即切換到備用模型。
訊息：organization credit limit exceeded
原因：API 帳戶的月度信用額度耗盡。需要充值或升級 API Tier，並立即切換到備用 Token。
方案一：立即手動切換到備用模型（5 分鐘搞定）
最快的解決方法：在聊天中直接輸入指令切換到另一個 API 的模型。
# 步驟 1：確認目前有哪些可用模型
/model list
# 步驟 2：切換到 GPT（如果有設定 OpenAI API Key）
/model gpt-4o
# 或切換到 Gemini（Google API Key，有免費額度）
/model gemini-2.5-flash
# 步驟 3：確認切換成功
/model status
# 步驟 4：繼續你的任務
💡 如果 /model list 只顯示 Claude？
代表你還沒有設定其他 API Key。你需要先在 OpenClaw 設定中加入備用的 API Key，才能切換到其他模型。請往下看「方案三」的詳細設定方式。
方案二：設定自動 Fallback 備用模型（永久解決）
這是最推薦的長期方案。在 openclaw.json 設定檔中配置「備用模型（fallback）」清單，當主要模型遭遇 429 時，OpenClaw 會自動切換到備用模型，不需要你手動操作。
// 在 ~/.openclaw/openclaw.json 中設定
{
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4-5",
"fallbacks": [
"openai/gpt-4o",
"google/gemini-2.5-flash-preview",
"openai/gpt-4o-mini"
]
}
}
}
}
設定完成後，當 Claude API 回傳 429 錯誤，OpenClaw 會依序嘗試：
方案三：為同一個模型設定多組 API Key 輪替
如果你有多個 Anthropic 帳號的 API Key（例如個人帳號 + 公司帳號），可以設定 OpenClaw 在一個 Key 限流時自動切換到另一個 Key，保持使用同一個 Claude 模型。
// 在 ~/.openclaw/openclaw.json 中設定多個 Auth Profile
{
"providers": {
"anthropic": {
"profiles": [
{
"name": "primary",
"apiKey": "sk-ant-api03-你的主要Key",
"priority": 1
},
{
"name": "backup",
"apiKey": "sk-ant-api03-你的備用Key",
"priority": 2
}
]
}
}
}
⚠️ 安全提醒
API Key 屬於高度敏感資訊，確保 ~/.openclaw/openclaw.json 的檔案權限設定正確：
chmod 600 ~/.openclaw/openclaw.json
取得免費備用 API Key：Gemini 和 Codex 免費額度
Google Gemini API（免費額度）
- ✅ 訪問 aistudio.google.com 免費申請
- ✅ Gemini 2.5 Flash 免費使用（有每日限制）
- ✅ 適合作為 Claude 限流時的備用方案
- ✅ 每天 1,500 次請求 / 每分鐘 60 次
OpenAI Codex CLI（GitHub Copilot）
- ✅ GitHub Copilot 訂閱者可免費使用
- ✅ 支援 OpenClaw 作為 API Proxy
- ✅ 月費 $10 即可使用，遠低於 Claude API
- ✅ x.com 上有教學：如何設定 Codex 作為 OpenClaw 後端
主動監控：在限流之前預警
與其等到 429 爆了才來應急，不如設定主動監控，在 Token 使用量接近上限時提前預警：
# 開啟 Token 使用量顯示（每次回應都顯示消耗了多少 Token）
/usage on
# 查看 API 使用狀態
openclaw models status
# 在 soul.md 或設定中加入自動警告
# 讓 OpenClaw 在 Token 使用量超過 80% 時主動通知你
💡 在 soul.md 中加入 Token 監控指示
在你的 soul.md（OpenClaw 個性設定）中加入以下指示，讓 OpenClaw 主動監控自己的 Token 消耗：
Monitor API usage proactively:
- When reaching 70% of daily token quota, notify me with a warning
- When reaching 90% of quota, switch to the cheapest available model automatically
- Log all model switches to memory for review
長期方案：升級 Claude API Tier
如果你長期重度使用 OpenClaw，最根本的解決方案是升級 Claude API Tier。不同 Tier 的配額差異非常大：
| Tier | 每分鐘 Token | 升級條件 | 適合對象 |
|---|---|---|---|
| Tier 1 | 40K TPM | 充值 $5 | 測試用戶 |
| Tier 2 | 80K TPM | 消費滿 $40 | 個人用戶 |
| Tier 3 | 160K TPM | 消費滿 $200 | 進階用戶 |
| Tier 4 | 400K TPM | 消費滿 $400 | 重度用戶/企業 |
常見問題 Q&A
Q：遇到 429 時，OpenClaw 會自動重試嗎？
A：會，但有限制。OpenClaw 在遇到 429 後會自動等待並重試最多 3 次。如果 3 次都失敗，才會向你發出錯誤通知。如果你設定了 fallback 模型清單，在主模型失敗後就會自動切換到備用模型，通常不需要人工介入。
Q：429 限流錯誤在被修復前，原來的任務還會繼續執行嗎？
A：如果有設定 fallback 模型，任務會在備用模型上繼續執行，幾乎無感切換。如果沒有備用模型，任務會停止等待，直到主模型的限流解除（通常是 60 秒到 24 小時不等，視限流類型而定）。
Q：切換到 GPT 後，OpenClaw 的記憶和設定會改變嗎？
A：不會。OpenClaw 的記憶系統、soul.md 個性設定、Skill 外掛都是與模型無關的。不管用 Claude 還是 GPT，你的 AI 助理都還是認識你、記得你之前交代的事情。
Q：有辦法減少每天的 Token 消耗量，避免觸發限流嗎？
A：有幾個有效方法：① 用 /think off 或 /think minimal 減少思考 Token；② 定期執行 /compact 減少歷史 Context；③ 避免在 cron 任務中設定太多高頻觸發的任務；④ 切換到更輕量的模型處理簡單任務（如 Gemini Flash 或 GPT-4o Mini）。
提升 Token 使用效率：讓每一個 Token 都物盡其用
即使你已經設定了 fallback 模型，學會節省 Token 同樣重要——你的備用模型也有配額，節約 Token 讓你在限流之前能完成更多任務：
✅ 技巧一：關閉不必要的思考模式
Claude 的「延伸思考」功能非常耗費 Token。對於簡單任務（發提醒、查天氣、回覆訊息），完全不需要開啟高強度思考：
# 一般日常任務：關閉思考
/think off
# 只有需要複雜推理時才開啟
/think medium # 或 /think high
✅ 技巧二：定期執行 /compact 壓縮歷史
OpenClaw 每次與 AI 通訊都會把對話歷史一起送出。歷史越長，每次請求消耗的輸入 Token 就越多。每天或每隔幾百條訊息執行一次 /compact：
# 壓縮上下文，釋放輸入 Token 空間
/compact
# 查看目前上下文大小
/context
✅ 技巧三：按任務選用最便宜的模型
不是所有任務都需要最強的 Claude Opus。對於簡單的日常任務，使用更輕量的模型可以大幅降低每次請求的費用：
關於 429 限流的 3 個常見誤解
❌ 誤解一：「我的帳號被封鎖了」
正確認識：429 是臨時的配額限制，不是帳號封鎖。你的帳號完全正常，只是在一定時間內的請求量達到上限。等待配額重置（通常每分鐘或每天重置）或切換備用模型，馬上就可以繼續使用。
❌ 誤解二：「只要等 60 秒就好」
正確認識：60 秒等待只對「每分鐘速率限制（TPM）」有效。如果你遇到的是「每日配額耗盡」，需要等到明天 UTC 0 點才重置。如果是「帳戶信用額度耗盡」，需要充值才能繼續使用。
❌ 誤解三：「越快重試越好」
正確認識：在遭遇 429 後立即大量重試，只會讓情況更糟——每次失敗的重試都可能消耗更多嘗試次數，導致更長的冷卻時間。正確做法是使用指數退避（等待 60 秒、120 秒、240 秒……），或直接切換到備用模型。
網路問題如何加速 Token 消耗？
台灣用戶在連線 Claude API 和 OpenAI API 時，如果網路不穩定，反而會加速 429 限流的到來：
🔄 網路超時導致大量重試
當連線到 Claude API 的速度很慢，OpenClaw 的請求容易超時。系統會自動重試，每次重試都是一次全新的 API 請求，消耗額外的 Token，讓你更快觸及配額上限。
💸 重複請求浪費 Token
網路不穩導致 Agent 判斷上一個請求失敗，重新發送相同的任務，但實際上第一個請求可能已經被 API 接收。這種「重複計費」會讓你的 Token 消耗量遠超預期。
💡 穩定的連線 = 更少的 Token 浪費
使用 VPN07 這類低延遲、高頻寬的加速方案，能確保每次 OpenClaw 與 Claude API 的通訊都直達無阻，大幅減少因超時重試而浪費的 Token，讓你的 API 配額用在真正有意義的任務上。
VPN07 - 減少Token浪費的關鍵
1000Mbps穩定連線 · 減少API超時重試 · 讓你的Token用在刀口上
台灣用戶使用 OpenClaw 時，連線 Claude API 的延遲是 Token 浪費的隱性殺手。VPN07 提供 1000Mbps 千兆頻寬、全球 70+ 節點，讓你的每次 API 請求都精準送達、快速回應，大幅減少因超時重試消耗的額外 Token，讓 429 限流來得更晚。十年品牌，月費僅 $1.5，30 天退款保證。