Error 400: 'model is not supported' 偶发错误（智谱 API 短暂不可用）

[sugershuo]

问题描述

SkillClaw 在运行过程中偶尔会返回 Error 400 错误：

Error code: 400 - {'error': {'code': 'invalid_parameter_error', 'message': 'model is not supported.', 'param': None}}

环境信息

• SkillClaw 版本: v0.4.0
• 模型: skillclaw-glm-5（智谱 GLM API）
• 运行方式: systemd 服务 (Restart=always)
• 平台: WSL2 Ubuntu 24.04

触发场景

错误发生在正常使用过程中，没有特定的触发条件。从 Gateway 日志来看：

2026-05-03 00:34:42 INFO gateway.platforms.feishu: [Feishu] Inbound dm message received...
...
Error code: 400 - {'error': {'code': 'invalid_parameter_error', 'message': 'model is not supported.'

影响

• Gateway 服务会因此崩溃
• 需要手动或通过 systemd Restart=on-failure 自动恢复
• 服务中断期间无法响应用户消息

当前缓解措施

已配置 systemd Restart=on-failure 自动重启，但这只是治标不治本。

可能原因

1. 智谱 GLM API 服务端短暂不可用
2. 网络连接问题导致请求失败
3. SkillClaw 与智谱 API 的连接状态异常

建议

1. 增加 API 调用的重试机制（带 exponential backoff）
2. 对 400 错误进行更细粒度的分类处理
3. 改善错误日志，记录更多诊断信息（如请求参数、响应时间等）
4. 考虑增加健康检查机制，定期检测 API 可用性

相关日志

# 查看 SkillClaw 日志
tail -50 ~/.skillclaw/skillclaw.log | grep -i error

# 查看 Gateway 日志
tail -50 ~/.hermes/logs/gateway.log | grep -i error

感谢考虑这个问题！

[sugershuo]

🔍 补充：根因分析（更新）

经进一步排查，发现真正的问题原因如下：

实际问题

Gateway 在处理请求时直接使用了 DashScope API endpoint，而不是 SkillClaw 本地代理：

项目	值
❌ 实际 URL	https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
✅ 应该使用	http://127.0.0.1:30000/v1/chat/completions
❌ 模型名	skillclaw-glm-5 被 DashScope API 拒绝（不支持）

根因

1. credential_pool 冲突：~/.hermes/auth.json 中有 alibaba provider 的 credential（来自环境变量），与 SkillClaw 配置冲突
2. Gateway fallback 机制：当 SkillClaw 代理配置有冲突时，Gateway 可能 fallback 到上游 API 直连

验证

• Python 测试确认 SkillClaw 正确返回本地代理配置
• SkillClaw 服务正在运行且正常
• 直接 curl DashScope API 用正确模型名成功（说明上游 API 正常）
• 问题在于 Gateway 没有走 SkillClaw 代理

解决方案

1. 清理 credential_pool：移除 ~/.hermes/auth.json 中冲突的 credential
2. 强制使用 SkillClaw 代理：设置 HERMES_INFERENCE_PROVIDER=skillclaw 或确保 config.yaml 中 provider 配置正确指向本地代理

---

抱歉之前的 Issue 描述有误，这是更准确的根因分析。

[sugershuo]

📝 补充说明

更准确的描述：

• 上游 API：阿里百炼 API（非 DashScope）
• 订阅计划：coding plan
• 模型：glm-5（阿里百炼 coding plan 中包含的模型）

Gateway 直连阿里百炼 API 时，使用了 skillclaw-glm-5 这个模型名，但百炼 API 只识别 glm-5，因此返回 "model is not supported"。

SkillClaw 代理的作用是将 skillclaw-glm-5 正确映射到百炼 API 的 glm-5 模型。