Bankr Error Handling 用于解决 Bankr API 错误和认证问题。
用途 当遇到认证错误、API 密钥错误、401 错误、"invalid API key"、"BANKR_API_KEY not set"、任务失败或其他 Bankr 相关错误时，可使用该技能进行诊断与处理。
认证错误（401） 症状：HTTP 401 状态码；出现 "Invalid API key" 或 "Unauthorized" 消息。 解决方式：向用户展示以下设置说明。 第 1 步：创建 API 密钥，访问 https://bankr.bot/api 创建新的 API 密钥。 第 2 步：设置环境变量，在 shell 配置文件（~/.zshrc 或 ~/.bashrc）中添加： export BANKR_API_KEY=bk_your_api_key_here 第 3 步：重启 Claude Code，关闭并重新打开终端/Claude Code 会话。 重要：认证失败时不要重试，用户必须先修复 API 密钥。
常见任务失败
- Insufficient balance：原因是不足代币，解决方式是检查余额、减少金额。
- Token not found：原因是无效符号/地址，解决方式是验证代币在链上存在。
- Slippage exceeded：原因是价格变动过大，解决方式是重试或尝试更小金额。
- Transaction reverted：原因是链上失败，解决方式是检查交易详情。
- Rate limit exceeded：原因是请求过多，解决方式是等待并重试。
HTTP 状态码
- 400 Bad request：检查提示格式。
- 401 Unauthorized：修复 API 密钥（见上文）。
- 402 Payment required：确保钱包在 Base 上有 BNKR。
- 429 Rate limited：等待并重试。
- 500 Server error：延迟后重试。
故障排查清单
- API 密钥：已设置、以 bk_ 开头、设置后已重启 Claude Code。
- 网络：互联网正常、api.bankr.bot 可访问。
- 交易相关：钱包余额充足、代币在链上存在。
向用户报告错误
- 简单说明出了什么问题。
- 提供具体的修复步骤。
- 避免技术术语。
- 建议替代方案。 示例：你的 Bankr API 密钥未配置。设置方法：1. 访问 https://bankr.bot/api 创建 API 密钥；2. 在环境中设置 BANKR_API_KEY；3. 重启 Claude Code。