BankrAPI错误处理代理Skill BankrAgent-ErrorHandling

---

name: Bankr代理 - 错误处理 description: 此技能应在遇到认证错误、API密钥错误、401错误、“无效API密钥”、“BANKR_API_KEY未设置”、作业失败或任何Bankr API错误时使用。提供设置指令和故障排除指导以解决Bankr配置问题。 version: 1.0.0

Bankr错误处理

解决Bankr API错误和认证问题。

认证错误 (401)

症状

• HTTP 401状态码
• "无效API密钥"或"未经授权"消息

解决方案

向用户展示以下设置指令：

步骤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密钥。

常见作业失败

错误	原因	解决方案
余额不足	代币不足	检查余额，减少金额
代币未找到	无效符号/地址	验证代币是否存在于链上
滑点超出	价格变动太大	重试或尝试更小金额
交易回滚	链上失败	检查交易详情
频率限制超出	请求过多	等待并重试

HTTP状态码

代码	含义	操作
400	错误请求	检查提示格式
401	未经授权	修复API密钥（见上）
402	需要支付	确保钱包在Base上有BNKR
429	频率限制	等待并重试
500	服务器错误	延迟后重试

故障排除清单

1. API密钥：已设置，以bk_开头，设置后重启Claude Code
2. 网络：互联网工作正常，api.bankr.bot可访问
3. 用于交易：钱包有足够余额，代币存在于链上

向用户报告错误

1. 简单说明出错原因
2. 提供具体修复步骤
3. 避免技术术语
4. 建议替代方案

示例：

您的Bankr API密钥未配置。要设置它：
1. 访问 https://bankr.bot/api 创建API密钥
2. 在环境中设置BANKR_API_KEY
3. 重启Claude Code