疑难杂症
本文档收录了使用过程中可能遇到的常见问题及解决方案。如果以下方案无法解决您的问题，请通过微信 vp4wt 联系我们获取技术支持。
API 调用错误
错误：401 Unauthorized
**原因：**API Key 无效、过期或未正确配置。
解决方案：
检查 API Key 是否正确复制，确保没有多余空格
登录 KvioAI 控制台确认 Key 处于激活状态
如果 Key 已泄露，请立即删除并重新创建
错误：403 Forbidden
**原因：**账户权限不足或余额不足。
解决方案：
检查账户余额，如不足请前往 充值
确认当前模型在您的套餐范围内
联系微信 vp4wt 升级账户权限
错误：429 Too Many Requests
**原因：**超出调用频率限制。
解决方案：
降低调用频率，增加请求间隔
联系微信 vp4wt 申请提升调用限额
错误：500 Internal Server Error
**原因：**服务端临时故障。
解决方案：
等待 1-2 分钟后重试
如果问题持续，请联系微信 vp4wt 反馈
网络连接问题
连接超时
**原因：**网络不稳定或防火墙拦截。
解决方案：
检查本地网络连接是否正常
尝试 ping
kvioai.cloud确认连通性检查防火墙/安全软件是否拦截了请求
如使用代理，请确保代理配置正确
DNS 解析失败
解决方案：
尝试更换 DNS 服务器（推荐使用 8.8.8.8 或 114.114.114.114）
运行
nslookup kvioai.cloud检查解析结果
Claude Code 相关问题
Claude Code 无法启动
解决方案：
确认 Node.js 版本 >= 18
确认环境变量 ANTHROPIC_API_KEY 已正确设置
尝试重新安装：
npm install -g @anthropic-ai/claude-code
模型响应异常或返回乱码
解决方案：
检查 ANTHROPIC_BASE_URL 是否设置为
https://kvioai.cloud/v1确认 ANTHROPIC_API_KEY 有效且未过期
尝试切换其他模型测试
OpenClaw (CodeX) 相关问题
配置文件读取失败
解决方案：
确认配置文件路径为
~/.openclaw/openclaw.json使用 JSON 校验工具检查格式是否正确
确保文件权限允许读取：
chmod 644 ~/.openclaw/openclaw.json
模型调用无响应
解决方案：
检查
baseUrl是否设置为https://kvioai.cloud/v1确认
apiKey正确无误检查账户余额是否充足
充值与账户问题
充值后余额未到账
解决方案：
等待 1-5 分钟，系统可能需要时间处理
刷新页面或重新登录查看
检查兑换码是否正确输入
如超过 10 分钟仍未到账，请保存兑换码凭证并联系微信 vp4wt
账户被冻结
**原因：**检测到异常使用行为或违反服务条款。
**解决方案：**联系微信 vp4wt 说明情况，我们会尽快核实处理。
💡 提示 遇到问题时，请保存错误日志和截图，这将帮助技术支持更快定位问题。联系方式：微信 vp4wt。