【Bug已解决】openclaw token usage exceeded / Credit limit reached — OpenClaw 额度耗尽解决方案

【Bug已解决】openclaw: token usage exceeded / Credit limit reached — OpenClaw 额度耗尽解决方案1. 问题描述OpenClaw 使用时遇到额度或 Token 用量超限# 额度耗尽 $ openclaw task Error: 402 payment_required Credit limit reached. Please add credits. # 或 Token 用量超限 $ openclaw 长任务 Error: usage_limit_exceeded Monthly token usage exceeded 10M tokens. # 或免费额度用完 $ openclaw --print task Error: free_tier_exhausted Free tier credits used up. # 或预付额度不足 $ openclaw task Error: insufficient_credits You have 0 credits remaining.这个问题在以下场景中特别常见免费额度用完月度 Token 超限预付余额不足高频使用大文件分析消耗大量 Token多人共享账户2. 原因分析原因分类表原因分类具体表现占比免费额度用完free tier约 35%月度超限10M tokens约 25%预付不足0 credits约 20%高频使用RPM TPM约 10%大文件消耗多约 5%多人共享同时用约 5%3. 解决方案方案一充值/添加 Credits最推荐# 步骤 1登录 Anthropic Console # https://console.anthropic.com/ # 步骤 2充值 # Settings → Billing → Add Credits # 步骤 3或升级计划 # Free → Pro → Enterprise # 步骤 4验证 openclaw --print hello方案二等待月度重置# 步骤 1检查用量 # 登录 console.anthropic.com → Usage # 步骤 2等待月度重置 # 通常每月 1 号重置 # 步骤 3检查重置日期 # Settings → Billing → Reset Date # 步骤 4临时使用其他 Key export ANTHROPIC_API_KEYsk-ant-backup-key openclaw task方案三减少 Token 消耗# 步骤 1使用更便宜的模型 openclaw --model claude-3-haiku task # Haiku 比 Sonnet 便宜 5-10 倍 # 步骤 2减少 max_tokens openclaw --max-tokens 2048 task # 步骤 3精简提示 # 错误: openclaw 分析整个项目所有文件 # 正确: openclaw 分析 src/index.js # 步骤 4分步执行 openclaw 分析 src/index.js # 新会话 openclaw 分析 src/auth.js # 新会话方案四使用多个 API Key# 步骤 1创建多个 Key # Key A: sk-ant-KEY_A # Key B: sk-ant-KEY_B # 步骤 2轮换使用 export ANTHROPIC_API_KEYsk-ant-KEY_A openclaw --print task1 export ANTHROPIC_API_KEYsk-ant-KEY_B openclaw --print task2 # 步骤 3自动轮换 KEYS(sk-ant-KEY_A sk-ant-KEY_B sk-ant-KEY_C) for i in 0 1 2; do export ANTHROPIC_API_KEY${KEYS[$((i % 3))]} openclaw --print task$i done方案五使用缓存# 步骤 1缓存重复请求 openclaw --print task /tmp/openclaw_cache.txt 21 # 下次直接读取 cat /tmp/openclaw_cache.txt # 步骤 2避免重复请求 # 如果任务相同使用缓存结果 # 步骤 3批量处理 openclaw --print 一次性处理多个文件: src/a.js src/b.js src/c.js # 步骤 4验证 openclaw --print hello方案六检查用量# 步骤 1检查当前用量 # 登录 console.anthropic.com → Usage # 步骤 2设置用量限制 # Settings → Usage Limits # 步骤 3设置告警 # Settings → Alerts → 80% alert # 步骤 4监控 openclaw --usage # 如果支持4. 各方案对比总结方案适用场景推荐指数难度方案一充值通用⭐⭐⭐⭐⭐低方案二等待重置临时⭐⭐⭐⭐低方案三减少消耗成本⭐⭐⭐⭐⭐低方案四多 Key高频⭐⭐⭐⭐中方案五缓存重复⭐⭐⭐⭐低方案六检查用量预防⭐⭐⭐⭐⭐低5. 常见问题 FAQ5.1 402 错误是什么Payment Required。额度耗尽需要充值。5.2 免费额度多少通常 $5 免费额度或 10M tokens/月具体看计划。5.3 如何充值登录 console.anthropic.com → Billing → Add Credits。5.4 月度什么时候重置通常每月 1 号。查看 Settings → Billing → Reset Date。5.5 如何减少 Token 消耗使用 Haiku 模型减少 max_tokens精简提示分步执行。5.6 Haiku 和 Sonnet 的价格差Haiku 约为 Sonnet 的 1/5-1/10 价格。5.7 多 API Key 合法吗合法。可以在 Anthropic 平台创建多个 Key。5.8 如何检查用量登录 console.anthropic.com → Usage。5.9 如何设置用量告警Settings → Alerts → 80% alert。5.10 排查清单速查表□ 1. console.anthropic.com 充值 □ 2. 检查 Usage → 用量 □ 3. 等待月度重置 □ 4. --model haiku 便宜模型 □ 5. --max-tokens 2048 减少 □ 6. 精简提示 □ 7. 分步执行每步新会话 □ 8. 多 API Key 轮换 □ 9. 缓存重复请求 □ 10. 设置用量告警 80%6. 总结根本原因额度耗尽最常见原因是免费额度用完35%和月度 Token 超限25%最佳实践在 console.anthropic.com 充值或升级计划减少消耗使用 claude-3-haiku 模型减少 max_tokens精简提示多 Key 轮换创建多个 API Key自动轮换使用最佳实践建议设置用量告警80%使用缓存避免重复请求故障排查流程图flowchart TD A[额度耗尽 402] -- B[检查用量] B -- C[console.anthropic.com Usage] C -- D{免费额度用完?} D --|是| E[充值 Credits] D --|否| F{月度超限?} E -- G[Settings → Billing → Add] G -- H[openclaw 验证] F --|是| I[等待月度重置] F --|否| j[减少 Token 消耗] I -- K[或用备用 Key] K -- H j -- L[--model claude-3-haiku] L -- M[--max-tokens 2048] M -- N[精简提示] N -- H H -- O{成功?} O --|是| P[✅ 问题解决] O --|否| Q[使用多 Key] Q -- R[KEY_A → KEY_B 轮换] R -- H H -- S{成功?} S --|是| P S --|否| T[使用缓存] T -- U[缓存重复请求] U -- H H -- V{成功?} V --|是| P V --|否| W[升级计划] W -- X[Pro/Enterprise] X -- H P -- Y[长期: 充值 haiku 告警] Y -- Z[✅ 长期方案]