Providers 与模型
OpenSquilla 通过同一套配置入口支持多个 LLM provider。你可以运行直连的单模型模式，或启用 SquillaRouter 进行分层路由。
当你需要配置 provider、查看模型支持情况，或在直连模型模式与 router 模式之间选择时，请使用本页。
查看 provider
列出本地安装中的 provider 元数据：
opensquilla providers list
opensquilla providers list --json从运行中的 gateway 查看运行时 provider 诊断：
opensquilla providers status
opensquilla providers status openrouter --json
opensquilla providers status --probe-modelsproviders list 不需要运行中的 gateway。providers status 需要。
配置 provider
交互式：
opensquilla providers configure openrouter非交互式、onboarding 风格的配置：
export OPENROUTER_API_KEY="sk-..."
opensquilla configure provider --provider openrouter --api-key-env OPENROUTER_API_KEY直连 provider 示例：
opensquilla configure provider --provider openai --model gpt-5.4-mini --api-key-env OPENAI_API_KEY
opensquilla configure provider --provider anthropic --model claude-sonnet-4-5 --api-key-env ANTHROPIC_API_KEY
opensquilla configure provider --provider gemini --model gemini-2.5-flash --api-key-env GEMINI_API_KEY
opensquilla configure provider --provider ollama --model llama3.1API key 优先使用环境变量引用，避免将密钥直接写入配置文件。
Onboarding 已验证的 provider
该构建为以下 provider 提供 onboarding 支持：
- OpenRouter
- OpenAI
- Anthropic
- Ollama
- DeepSeek
- Gemini
- DashScope / Qwen
- Moonshot AI
- Zhipu / Z.AI
- Baidu Qianfan
- Volcengine Ark
provider 注册表中可能包含面向进阶或自托管场景的其他兼容 provider。请在你的安装上运行 opensquilla providers list 查看当前目录。
OpenAI：openai vs openai_responses
OpenAI 以两个 provider id 暴露，二者共享同一个 OPENAI_API_KEY 和 base URL（https://api.openai.com/v1）：
openai—— chat/completions 请求形态。用于标准的 chat 式 turn 和广泛的工具兼容性。openai_responses—— 原生 Responses-API 形态（能力为chat和responses）。当你想要 Responses-API 行为而非 chat/completions 入口时使用。
两者读取相同的 key 和 base URL，因此在它们之间切换只需更改 provider。
模型查看
列出模型：
opensquilla models list如果运行时模型查看无法连接，请启动 gateway：
opensquilla gateway run对于不需要 gateway 的 provider 元数据，请使用：
opensquilla providers list直连模型 vs Router
直连模型模式：
opensquilla configure router --router disabled
opensquilla configure provider --provider openai --model gpt-5.4-mini --api-key-env OPENAI_API_KEYRouter 模式：
opensquilla configure router --router recommended| 模式 | 使用场景 |
|---|---|
| 直连模型 | 测试某个具体模型、复现 provider 行为，或审计 provider 计费时。 |
| Router 模式 | 进行常规的个人 agent 使用，每个 turn 的成本与任务复杂度都会变化。 |
路由细节参见
features/squilla-router.md。
Provider 排障
先从以下入手：
opensquilla doctor
opensquilla providers status
opensquilla diagnostics on检查：
- gateway 进程环境中已设置 API key 环境变量；
- 模型 id 与 provider 匹配；
- 兼容 API 的 base URL 正确；
- 代理设置与你的网络一致；
- 在排查某个具体 provider/模型时已禁用 router；
- 配置变更后已重启 gateway。