LLM 提供商

LLM 提供商（必需——至少设置一个，除非你经 `minara auth login` 使用 OAuth profile）

默认模型不从 .env 读取——它持久化到 settings.json#model。用 minara config model use <id>、 REPL 中的 /model <id>，或 web UI 的 Provider & Model 页面更改它。

主 LLM 提供商。

作用: 为 agent 循环发起的每一次 Claude completion 做鉴权（src/core/agent-loop.ts → src/llm/anthropic-*.ts）。
消费方: src/llm/select-provider.ts 在选择 Anthropic 客户端路径时读取（src/llm/anthropic-api-key.ts / anthropic-oauth.ts 下的运维工具也会遵循）。
何时设置: 你在用裸 API key 而非已存储的 OAuth profile 运行 agent 时。可在 https://console.anthropic.com 获取。
未设置时: agent 回退到 (a) minara auth login claude 保存的 device-flow OAuth profile，然后 (b) OPENROUTER_API_KEY。若三者都不可用，agent 拒绝启动。
格式: 不透明字符串，通常以 sk-ant-... 为前缀。
设置归属: LLM 提供商凭证（设置 → 提供商与模型）

覆盖众多模型的备选 LLM 路由。

作用: 当 Anthropic 凭据不存在，或 AGENT_MODEL 指定了某个 OpenRouter 模型时，为经 OpenRouter 路由的 completion 做鉴权（src/llm/openrouter.ts）。
消费方: src/llm/select-provider.ts（次选提供商）。
何时设置: 你想通过 OpenRouter 用非 Anthropic 模型（Llama、DeepSeek、Gemini 等）运行 agent 时。
未设置时: 只尝试 Anthropic / OAuth 路径。
格式: 以 sk-or-... 开头的不透明字符串。
设置归属: LLM 提供商凭证（设置 → 提供商与模型）

原生 xAI（Grok）LLM 提供商 key。

作用: 通过 xai-api-key LLM 提供商直连 https://api.x.ai/v1 —— 绕过 OpenRouter 以降低延迟、免去路由加价。原生 xAI 客户端在 wire 层与 OpenAI 兼容（src/llm/xai-api-key.ts 复用 openai-wire.ts）。
消费方: src/llm/select-provider.ts（xAI 在自动选择中优先级最低；仅当没有其他提供商 profile 或环境变量存在时，该环境变量才触发 xai-api-key）。
何时设置: 你有 xAI console key 并希望使用原生 Grok 路由时。
未设置时: Grok 仍可通过 OpenRouter 访问（x-ai/grok-4）。
格式: 来自 https://console.x.ai/ 的不透明字符串。
设置归属: LLM 提供商凭证（设置 → 提供商与模型）

KIMI_API_KEY：Kimi 原生 LLM 提供商 key。

作用: 为通过 https://api.moonshot.ai/v1 发起的 Kimi 对话和模型目录请求鉴权。
消费方: 由 src/llm/select-provider.ts、src/llm/v2/custom-loaders.ts 中的 kimi-api-key 加载器，以及 Kimi 模型目录抓取器读取。
何时设置: 你拥有 Kimi API 平台 key，并希望直连 Kimi 模型而不是通过 OpenRouter 路由时。
未设置时: Kimi 直连提供商不可用；其他已配置的聚合服务仍可能提供 Kimi 模型。
格式: 在 https://platform.kimi.ai/ 创建的不透明字符串。
设置归属: LLM 提供商凭证（设置 → 提供商与模型）

xAI API base URL 的可选覆盖。

覆盖 xAI OAuth 的 client_id。

作用: 运行 minara auth login xai（OAuth 浏览器流程）时，Minara 发送给 auth.x.ai 的 OAuth 公开 client_id。
默认值: xAI 官方 Grok-CLI 公开 client_id，Hermes Agent 也在使用，并按其公开源码公开共享。RFC 8252 §8.4 允许在原生应用间复用公开客户端，但 xAI 可能不经通知即撤销。
何时设置: xAI 已为 Minara 铸发了专属的注册 client_id 时。
未设置时: 使用共享的 Grok-CLI id，并在首次 minara auth login xai 时输出一次性的 stderr 警告。
格式: UUID 风格字符串。
设置归属: 非用户设置项

Ollama Cloud

Ollama Cloud LLM 提供商 key。

作用: 为 agent 对 Ollama Cloud（https://ollama.com）做鉴权，后者通过 OpenAI 兼容端点提供开放模型（gpt-oss、deepseek、qwen3-coder、kimi-k2 ……）。
消费方: src/llm/v2/custom-loaders.ts（ollama 加载器）、src/gateway/auth-cli.ts（minara auth login ollama）和 src/gateway/model-registry.ts（/api/tags catalog 抓取）。
何时设置: 你想使用 Ollama Cloud 模型时。在 https://ollama.com/settings/keys 创建 key。
未设置时: ollama 提供商不可用；agent 使用另一个已配置的提供商。
格式: 来自 ollama.com/settings/keys 的不透明字符串。
设置归属: LLM 提供商凭证（设置 → 提供商与模型）

Ollama 主机的可选覆盖。

作用: ollama 加载器 + catalog 抓取发送请求的目标地址。指向自托管 / 企业 Ollama 服务器，或本地实例（http://localhost:11434）。
默认值: https://ollama.com（Ollama Cloud）。
何时设置: 指向非云端 Ollama 主机时。
未设置时: 使用 Ollama Cloud。
格式: 绝对 URL，无尾部斜杠。
设置归属: 非用户设置项