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 原生 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，無尾部斜槓。
設置歸屬: 非用戶設置項