【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_KEY=sk-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_KEY=sk-ant-KEY_A openclaw --print "task1" export ANTHROPIC_API_KEY=sk-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 2>&1 # 下次直接读取 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. 常见问题 FAQ
5.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[✅ 长期方案]
)
 agent和组件)