对话限制与 API 限频排查
三种常见限制
限制一：会员额度用完了
现象：Claw 回复说"API 额度已耗尽""会员额度不足"。
原因：Kimi Claw 的模型调用和搜索能力从你的 Kimi 会员额度池 扣除。额度用完了 Claw 就不能正常回复了。
解决：
- 打开 kimi.com 查看会员额度剩余
- 充值 / 升级会员计划
- 等待下个月额度刷新
注意：Kimi 网页端、App、Kimi Work、Kimi Code 和 Kimi Claw 共用同一个额度池——任何一个产品消耗额度都会影响所有产品。
限制二：搜索 API 限流
现象：联网搜索偶尔失败、报"rate limit exceeded"或"搜索服务暂时不可用"。
原因：短时间内发起了太多搜索请求（比如批量跑定时任务），Kimi Web Search 的限流触发了。
解决：
- 等几分钟再试——限流窗口一般是分钟级
- 定时任务尽量错开时间（不要让多个 Claw 同时在 9:00 执行搜索任务）
- 把批量搜索拆成分批执行
限制三：群聊 / 多 Claw 的消息风暴
现象：群聊里多个 Claw 同时回复、互相 @、陷入循环。
解决：
- 输入
/stop强制打断所有 Claw - 检查群规是否合理（有没有让 Claw 互相 @ 的规则）
- 减少同时在线的 Claw 数量
排查步骤
当 Claw 回复异常时：
第一步：看报错信息
Claw 的报错信息通常很明确：
- "额度不足" → 会员额度用完
- "rate limit" → API 限流
- "timeout" → 网络问题或服务端暂时故障
第二步：查终端状态
在终端里执行 /status：
/status
→ 模型调用：正常 ✓ / 已达上限 ✗
→ 联网搜索：正常 ✓ / 限流中 ✗
→ ClawHub 技能库：正常 ✓ / 已连接 ✓第三步：查看日志
/logs 可以看到具体的报错原因和时间：
/logs
→ 2026-10-14 09:13:15 [ERROR] API call failed: quota exceeded第四步：等待或升级
- 如果是临时限流（搜索、群聊）：等几分钟自然恢复
- 如果是额度用完：充值会员
- 如果是持续报错：重启 Claw
避免限制的习惯
- 定时任务错开：不要让多个 Claw 同时在整点执行 → 用非整点时间
- 搜索加缓冲：批量搜索任务之间加间隔
- 群聊设好群规：避免 Claw 互相 @ 陷入循环
- 定期查额度：每周看一下会员额度剩余，避免月底突然用完
- 云端版优先：定时任务和批量自动化尽量用云端版执行，避免本地网络和额度双重问题
各形态的额度消耗
| 形态 | 额度消耗路径 |
|---|---|
| 云端托管版 | 模型调用 + 搜索 → 会员额度池 |
| Android 终端版 | 模型调用 + 搜索 → 会员额度池（通过 Kimi 账号关联） |
| 桌面端版 | 模型调用 + 搜索 → 会员额度池（通过 Kimi 账号关联） |
三种形态共用同一份额度。