⚠️ Hermes / OpenAI 兼容接口调用 Claude 模型避坑

如果你用 Hermes、OpenClaw类 Agent，通过 OpenAI-compatible 接口调用 Claude 模型，比如：

claude-opus-4-7
claude-sonnet-4-6

遇到一切换 Claude 模型就秒报错，不一定是 key 坏了，也不一定是上游渠道挂了。

我这边实测踩到一个坑：

Hermes 开了 fast / priority 模式后，切到 Claude 模型时会自动带一个参数：

speed="fast"

这个参数对 Anthropic 原生 Messages API 是有意义的，但如果你走的是 OpenAI-compatible 的 /v1/chat/completions，就可能直接报错：

Completions.create() got an unexpected keyword argument 'speed'

重点是：这个错误甚至可能还没真正打到中转站/上游，客户端 SDK 本地就先炸了。

排查建议：

1. 先直连 /v1/chat/completions 测模型是否可用
2. 再看 Agent 实际请求里有没有多带 speed / service_tier / reasoning 这类额外参数
3. OpenAI-compatible 转 Claude 时，不要盲目复用 Anthropic 原生参数
4. 如果是 Hermes，临时可以关 fast mode，或者在 chat_completions 路径过滤掉 speed

结论：

Claude 模型能不能用，要分清楚两件事：

✅ 渠道是否支持这个模型
✅ 客户端发出的请求格式是否兼容当前接口

很多“模型不可用”的问题，其实是请求参数不兼容。

包括gpt-image-2也是一样的，很多人都会以为是中转站问题，其实是客户端这边没有配置好模型的端点。