mcpField
B
Bankr Agent - Error Handling

Bankr Agent - Error Handling

github.com/bankrbot开发88358 次安装31 周前更新
代码仓库

关于 Bankr Agent - Error Handling

用于排查 Bankr API 身份验证和任务失败的技能，按错误类型提供检查与解决步骤，并说明何时应先修复凭据而非重试。

主要功能

  1. 01401 身份验证故障排查
  2. 02常见任务失败的解决方法
  3. 03HTTP 状态码处理指引
  4. 04网络连接与余额检查
  5. 05面向用户的错误说明步骤

适用场景

  1. 01修复无效 API 密钥
  2. 02诊断交易任务失败
  3. 03处理限流或服务器错误
  4. 04向用户说明解决步骤

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bankrbot/claude-plugins --skill bankr-agent---error-handling

安装后在 Claude Code 中输入/bankr-agent---error-handling确认已加载。

详细介绍

Bankr 错误处理

解决 Bankr API 错误和身份验证问题。

身份验证错误（401）

症状
  • HTTP 401 状态码
  • 显示“API 密钥无效”或“未授权”消息
解决方法

向用户提供以下设置说明：

步骤 1：创建 API 密钥

Visit https://bankr.bot/api to create a new API key

步骤 2：设置环境变量

# Add to shell profile (~/.zshrc or ~/.bashrc)
export BANKR_API_KEY=bk_your_api_key_here

步骤 3：重启 Claude Code

Close and reopen the terminal/Claude Code session

重要：身份验证失败时，切勿重试。用户必须先修复 API 密钥。

常见任务失败

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

HTTP 状态码

代码含义操作
400请求错误检查提示词格式
401未授权修复 API 密钥（见上文）
402需要付款确保钱包在 Base 上有 BNKR
429请求受限等待后重试
500服务错误稍后重试

故障排查清单

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

向用户报告错误

  1. 简明说明出了什么问题
  2. 提供具体的修复步骤
  3. 避免使用专业术语
  4. 建议替代方案

示例：

Your Bankr API key is not configured. To set it up:
1. Visit https://bankr.bot/api to create an API key
2. Set BANKR_API_KEY in your environment
3. Restart Claude Code

评论

支持 Markdown