【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. 原因分析

原因分类表

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. 各方案对比总结

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. 总结

1. 根本原因：额度耗尽最常见原因是免费额度用完（35%）和月度 Token 超限（25%）
2. 最佳实践：在 console.anthropic.com 充值或升级计划
3. 减少消耗：使用 claude-3-haiku 模型，减少 max_tokens，精简提示
4. 多 Key 轮换：创建多个 API Key，自动轮换使用
5. 最佳实践建议：设置用量告警（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[✅ 长期方案]