@quantumclaw/quantumclaw 2026.3.22

package/docs/zh-CN/providers/synthetic.md

@@ -0,0 +1,106 @@
+---
+read_when:
+  - 你想将 Synthetic 用作模型提供商
+  - 你需要 Synthetic API key 或 base URL 设置
+summary: 在 QuantumClaw 中使用 Synthetic 的 Anthropic 兼容 API
+title: Synthetic
+x-i18n:
+  generated_at: "2026-03-16T06:27:11Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 3a2adb0b831babe3e88b027772167748764d85ee72d402ff759571420a91757f
+  source_path: providers/synthetic.md
+  workflow: 15
+---
+
+# Synthetic
+
+Synthetic 提供与 Anthropic 兼容的端点。QuantumClaw 将其注册为
+`synthetic` 提供商，并使用 Anthropic Messages API。
+
+## 快速设置
+
+1. 设置 `SYNTHETIC_API_KEY`（或运行下面的向导）。
+2. 运行新手引导：
+
+```bash
+quantumclaw onboard --auth-choice synthetic-api-key
+```
+
+默认模型会设置为：
+
+```
+synthetic/hf:MiniMaxAI/MiniMax-M2.5
+```
+
+## 配置示例
+
+```json5
+{
+  env: { SYNTHETIC_API_KEY: "sk-..." },
+  agents: {
+    defaults: {
+      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" },
+      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.5": { alias: "MiniMax M2.5" } },
+    },
+  },
+  models: {
+    mode: "merge",
+    providers: {
+      synthetic: {
+        baseUrl: "https://api.synthetic.new/anthropic",
+        apiKey: "${SYNTHETIC_API_KEY}",
+        api: "anthropic-messages",
+        models: [
+          {
+            id: "hf:MiniMaxAI/MiniMax-M2.5",
+            name: "MiniMax M2.5",
+            reasoning: false,
+            input: ["text"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 192000,
+            maxTokens: 65536,
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+注意：QuantumClaw 的 Anthropic 客户端会将 `/v1` 追加到 base URL 后面，因此请使用
+`https://api.synthetic.new/anthropic`（而不是 `/anthropic/v1`）。如果 Synthetic 更改了
+其 base URL，请覆盖 `models.providers.synthetic.baseUrl`。
+
+## 模型目录
+
+下面所有模型的成本都为 `0`（输入/输出/缓存）。
+
+| 模型 ID                                                | 上下文窗口 | 最大 tokens | 推理  | 输入         |
+| ------------------------------------------------------ | ---------- | ----------- | ----- | ------------ |
+| `hf:MiniMaxAI/MiniMax-M2.5`                            | 192000     | 65536       | false | text         |
+| `hf:moonshotai/Kimi-K2-Thinking`                       | 256000     | 8192        | true  | text         |
+| `hf:zai-org/GLM-4.7`                                   | 198000     | 128000      | false | text         |
+| `hf:deepseek-ai/DeepSeek-R1-0528`                      | 128000     | 8192        | false | text         |
+| `hf:deepseek-ai/DeepSeek-V3-0324`                      | 128000     | 8192        | false | text         |
+| `hf:deepseek-ai/DeepSeek-V3.1`                         | 128000     | 8192        | false | text         |
+| `hf:deepseek-ai/DeepSeek-V3.1-Terminus`                | 128000     | 8192        | false | text         |
+| `hf:deepseek-ai/DeepSeek-V3.2`                         | 159000     | 8192        | false | text         |
+| `hf:meta-llama/Llama-3.3-70B-Instruct`                 | 128000     | 8192        | false | text         |
+| `hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` | 524000     | 8192        | false | text         |
+| `hf:moonshotai/Kimi-K2-Instruct-0905`                  | 256000     | 8192        | false | text         |
+| `hf:openai/gpt-oss-120b`                               | 128000     | 8192        | false | text         |
+| `hf:Qwen/Qwen3-235B-A22B-Instruct-2507`                | 256000     | 8192        | false | text         |
+| `hf:Qwen/Qwen3-Coder-480B-A35B-Instruct`               | 256000     | 8192        | false | text         |
+| `hf:Qwen/Qwen3-VL-235B-A22B-Instruct`                  | 250000     | 8192        | false | text + image |
+| `hf:zai-org/GLM-4.5`                                   | 128000     | 128000      | false | text         |
+| `hf:zai-org/GLM-4.6`                                   | 198000     | 128000      | false | text         |
+| `hf:deepseek-ai/DeepSeek-V3`                           | 128000     | 8192        | false | text         |
+| `hf:Qwen/Qwen3-235B-A22B-Thinking-2507`                | 256000     | 8192        | true  | text         |
+
+## 说明
+
+- 模型引用使用 `synthetic/<modelId>`。
+- 如果你启用了模型允许列表（`agents.defaults.models`），请添加你
+  计划使用的每个模型。
+- 有关提供商规则，请参阅 [Model providers](/concepts/model-providers)。

package/docs/zh-CN/providers/together.md

@@ -0,0 +1,72 @@
+---
+read_when:
+  - 你想在 QuantumClaw 中使用 Together AI
+  - 你需要 API 密钥环境变量或 CLI 身份验证选项
+summary: Together AI 设置（身份验证 + 模型选择）
+x-i18n:
+  generated_at: "2026-03-16T06:27:08Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 4f2ba5a12b03d0140feba4f54e0540bb57237cd131c8f1d826bc3629fde2d111
+  source_path: providers/together.md
+  workflow: 15
+---
+
+# Together AI
+
+[Together AI](https://together.ai) 通过统一 API 提供对领先开源模型的访问，包括 Llama、DeepSeek、Kimi 等。
+
+- 提供商：`together`
+- 身份验证：`TOGETHER_API_KEY`
+- API：兼容 OpenAI
+
+## 快速开始
+
+1. 设置 API 密钥（推荐：为 Gateway 网关存储它）：
+
+```bash
+quantumclaw onboard --auth-choice together-api-key
+```
+
+2. 设置默认模型：
+
+```json5
+{
+  agents: {
+    defaults: {
+      model: { primary: "together/moonshotai/Kimi-K2.5" },
+    },
+  },
+}
+```
+
+## 非交互式示例
+
+```bash
+quantumclaw onboard --non-interactive \
+  --mode local \
+  --auth-choice together-api-key \
+  --together-api-key "$TOGETHER_API_KEY"
+```
+
+这会将 `together/moonshotai/Kimi-K2.5` 设置为默认模型。
+
+## 环境说明
+
+如果 Gateway 网关作为守护进程运行（launchd/systemd），请确保 `TOGETHER_API_KEY`
+对该进程可用（例如在 `~/.quantumclaw/.env` 中，或通过
+`env.shellEnv`）。
+
+## 可用模型
+
+Together AI 提供对许多热门开源模型的访问：
+
+- **GLM 4.7 Fp8** - 具有 200K 上下文窗口的默认模型
+- **Llama 3.3 70B Instruct Turbo** - 快速、高效的指令跟随模型
+- **Llama 4 Scout** - 具备图像理解能力的视觉模型
+- **Llama 4 Maverick** - 高级视觉和推理模型
+- **DeepSeek V3.1** - 强大的编码和推理模型
+- **DeepSeek R1** - 高级推理模型
+- **Kimi K2 Instruct** - 具有 262K 上下文窗口的高性能模型
+
+所有模型都支持标准聊天补全，并兼容 OpenAI API。

package/docs/zh-CN/providers/venice.md

@@ -0,0 +1,289 @@
+---
+read_when:
+  - 你想在 QuantumClaw 中使用注重隐私的推理
+  - 你想获得 Venice AI 设置指引
+summary: 在 QuantumClaw 中使用 Venice AI 注重隐私的模型
+title: Venice AI
+x-i18n:
+  generated_at: "2026-03-16T06:27:49Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: e72c7ad24b045e9695530bee80ab7213986742354b7553b72bb230b75edf76e8
+  source_path: providers/venice.md
+  workflow: 15
+---
+
+# Venice AI（Venice 亮点）
+
+**Venice** 是我们重点推荐的 Venice 设置，适用于隐私优先的推理，并可选择通过匿名访问专有模型。
+
+Venice AI 提供注重隐私的 AI 推理，支持未审查模型，并可通过其匿名代理访问主要专有模型。所有推理默认都是私密的——不会使用你的数据进行训练，也不会记录日志。
+
+## 为什么在 QuantumClaw 中使用 Venice
+
+- **私密推理**，适用于开源模型（不记录日志）。
+- 当你需要时可使用**未审查模型**。
+- 当质量更重要时，可**匿名访问**专有模型（Opus/GPT/Gemini）。
+- 兼容 OpenAI 的 `/v1` 端点。
+
+## 隐私模式
+
+Venice 提供两个隐私级别 —— 理解这一点对于选择你的模型至关重要：
+
+| 模式     | 说明                                                                                         | 模型                                                         |
+| -------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| **私密** | 完全私密。提示词/响应**绝不会被存储或记录**。临时性。                                        | Llama、Qwen、DeepSeek、Kimi、MiniMax、Venice Uncensored 等。 |
+| **匿名** | 通过 Venice 代理并剥离元数据。底层提供商（OpenAI、Anthropic、Google、xAI）看到的是匿名请求。 | Claude、GPT、Gemini、Grok                                    |
+
+## 功能
+
+- **注重隐私**：可在 “private”（完全私密）和 “anonymized”（代理）模式之间选择
+- **未审查模型**：访问不受内容限制的模型
+- **主流模型访问**：通过 Venice 的匿名代理使用 Claude、GPT、Gemini 和 Grok
+- **兼容 OpenAI 的 API**：标准 `/v1` 端点，易于集成
+- **流式传输**：✅ 所有模型都支持
+- **函数调用**：✅ 选定模型支持（请检查模型能力）
+- **视觉**：✅ 具备视觉能力的模型支持
+- **无硬性速率限制**：极端使用情况下可能会应用公平使用节流
+
+## 设置
+
+### 1. 获取 API 密钥
+
+1. 在 [venice.ai](https://venice.ai) 注册
+2. 前往 **Settings → API Keys → Create new key**
+3. 复制你的 API 密钥（格式：`vapi_xxxxxxxxxxxx`）
+
+### 2. 配置 QuantumClaw
+
+**选项 A：环境变量**
+
+```bash
+export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
+```
+
+**选项 B：交互式设置（推荐）**
+
+```bash
+quantumclaw onboard --auth-choice venice-api-key
+```
+
+这将会：
+
+1. 提示输入你的 API 密钥（或使用现有的 `VENICE_API_KEY`）
+2. 显示所有可用的 Venice 模型
+3. 让你选择默认模型
+4. 自动配置该提供商
+
+**选项 C：非交互式**
+
+```bash
+quantumclaw onboard --non-interactive \
+  --auth-choice venice-api-key \
+  --venice-api-key "vapi_xxxxxxxxxxxx"
+```
+
+### 3. 验证设置
+
+```bash
+quantumclaw agent --model venice/kimi-k2-5 --message "Hello, are you working?"
+```
+
+## 模型选择
+
+设置完成后，QuantumClaw 会显示所有可用的 Venice 模型。请根据你的需要进行选择：
+
+- **默认模型**：`venice/kimi-k2-5`，适合强大的私密推理 + 视觉。
+- **高能力选项**：`venice/claude-opus-4-6`，适合最强的匿名 Venice 路径。
+- **隐私**：选择 “private” 模型以获得完全私密的推理。
+- **能力**：选择 “anonymized” 模型，以通过 Venice 的代理访问 Claude、GPT、Gemini。
+
+你可以随时更改默认模型：
+
+```bash
+quantumclaw models set venice/kimi-k2-5
+quantumclaw models set venice/claude-opus-4-6
+```
+
+列出所有可用模型：
+
+```bash
+quantumclaw models list | grep venice
+```
+
+## 通过 `quantumclaw configure` 配置
+
+1. 运行 `quantumclaw configure`
+2. 选择 **Model/auth**
+3. 选择 **Venice AI**
+
+## 我应该使用哪个模型？
+
+| 使用场景             | 推荐模型                         | 原因                             |
+| -------------------- | -------------------------------- | -------------------------------- |
+| **通用聊天（默认）** | `kimi-k2-5`                      | 强大的私密推理 + 视觉            |
+| **整体最佳质量**     | `claude-opus-4-6`                | 最强的匿名 Venice 选项           |
+| **隐私 + 编码**      | `qwen3-coder-480b-a35b-instruct` | 具有大上下文的私密编码模型       |
+| **私密视觉**         | `kimi-k2-5`                      | 无需离开私密模式即可支持视觉     |
+| **快速 + 便宜**      | `qwen3-4b`                       | 轻量级推理模型                   |
+| **复杂私密任务**     | `deepseek-v3.2`                  | 推理能力强，但不支持 Venice 工具 |
+| **未审查**           | `venice-uncensored`              | 无内容限制                       |
+
+## 可用模型（共 41 个）
+
+### 私密模型（26 个）—— 完全私密，不记录日志
+
+| 模型 ID                                | 名称                                 | 上下文 | 功能               |
+| -------------------------------------- | ------------------------------------ | ------ | ------------------ |
+| `kimi-k2-5`                            | Kimi K2.5                            | 256k   | 默认、推理、视觉   |
+| `kimi-k2-thinking`                     | Kimi K2 Thinking                     | 256k   | 推理               |
+| `llama-3.3-70b`                        | Llama 3.3 70B                        | 128k   | 通用               |
+| `llama-3.2-3b`                         | Llama 3.2 3B                         | 128k   | 通用               |
+| `hermes-3-llama-3.1-405b`              | Hermes 3 Llama 3.1 405B              | 128k   | 通用，工具已禁用   |
+| `qwen3-235b-a22b-thinking-2507`        | Qwen3 235B Thinking                  | 128k   | 推理               |
+| `qwen3-235b-a22b-instruct-2507`        | Qwen3 235B Instruct                  | 128k   | 通用               |
+| `qwen3-coder-480b-a35b-instruct`       | Qwen3 Coder 480B                     | 256k   | 编码               |
+| `qwen3-coder-480b-a35b-instruct-turbo` | Qwen3 Coder 480B Turbo               | 256k   | 编码               |
+| `qwen3-5-35b-a3b`                      | Qwen3.5 35B A3B                      | 256k   | 推理、视觉         |
+| `qwen3-next-80b`                       | Qwen3 Next 80B                       | 256k   | 通用               |
+| `qwen3-vl-235b-a22b`                   | Qwen3 VL 235B（视觉）                | 256k   | 视觉               |
+| `qwen3-4b`                             | Venice Small（Qwen3 4B）             | 32k    | 快速、推理         |
+| `deepseek-v3.2`                        | DeepSeek V3.2                        | 160k   | 推理，工具已禁用   |
+| `venice-uncensored`                    | Venice Uncensored（Dolphin-Mistral） | 32k    | 未审查，工具已禁用 |
+| `mistral-31-24b`                       | Venice Medium（Mistral）             | 128k   | 视觉               |
+| `google-gemma-3-27b-it`                | Google Gemma 3 27B Instruct          | 198k   | 视觉               |
+| `openai-gpt-oss-120b`                  | OpenAI GPT OSS 120B                  | 128k   | 通用               |
+| `nvidia-nemotron-3-nano-30b-a3b`       | NVIDIA Nemotron 3 Nano 30B           | 128k   | 通用               |
+| `olafangensan-glm-4.7-flash-heretic`   | GLM 4.7 Flash Heretic                | 128k   | 推理               |
+| `zai-org-glm-4.6`                      | GLM 4.6                              | 198k   | 通用               |
+| `zai-org-glm-4.7`                      | GLM 4.7                              | 198k   | 推理               |
+| `zai-org-glm-4.7-flash`                | GLM 4.7 Flash                        | 128k   | 推理               |
+| `zai-org-glm-5`                        | GLM 5                                | 198k   | 推理               |
+| `minimax-m21`                          | MiniMax M2.1                         | 198k   | 推理               |
+| `minimax-m25`                          | MiniMax M2.5                         | 198k   | 推理               |
+
+### 匿名模型（15 个）—— 通过 Venice 代理
+
+| 模型 ID                         | 名称                             | 上下文 | 功能             |
+| ------------------------------- | -------------------------------- | ------ | ---------------- |
+| `claude-opus-4-6`               | Claude Opus 4.6（通过 Venice）   | 1M     | 推理、视觉       |
+| `claude-opus-4-5`               | Claude Opus 4.5（通过 Venice）   | 198k   | 推理、视觉       |
+| `claude-sonnet-4-6`             | Claude Sonnet 4.6（通过 Venice） | 1M     | 推理、视觉       |
+| `claude-sonnet-4-5`             | Claude Sonnet 4.5（通过 Venice） | 198k   | 推理、视觉       |
+| `openai-gpt-54`                 | GPT-5.4（通过 Venice）           | 1M     | 推理、视觉       |
+| `openai-gpt-53-codex`           | GPT-5.3 Codex（通过 Venice）     | 400k   | 推理、视觉、编码 |
+| `openai-gpt-52`                 | GPT-5.2（通过 Venice）           | 256k   | 推理             |
+| `openai-gpt-52-codex`           | GPT-5.2 Codex（通过 Venice）     | 256k   | 推理、视觉、编码 |
+| `openai-gpt-4o-2024-11-20`      | GPT-4o（通过 Venice）            | 128k   | 视觉             |
+| `openai-gpt-4o-mini-2024-07-18` | GPT-4o Mini（通过 Venice）       | 128k   | 视觉             |
+| `gemini-3-1-pro-preview`        | Gemini 3.1 Pro（通过 Venice）    | 1M     | 推理、视觉       |
+| `gemini-3-pro-preview`          | Gemini 3 Pro（通过 Venice）      | 198k   | 推理、视觉       |
+| `gemini-3-flash-preview`        | Gemini 3 Flash（通过 Venice）    | 256k   | 推理、视觉       |
+| `grok-41-fast`                  | Grok 4.1 Fast（通过 Venice）     | 1M     | 推理、视觉       |
+| `grok-code-fast-1`              | Grok Code Fast 1（通过 Venice）  | 256k   | 推理、编码       |
+
+## 模型发现
+
+当设置了 `VENICE_API_KEY` 时，QuantumClaw 会自动从 Venice API 发现模型。如果 API 不可访问，则会回退到静态目录。
+
+`/models` 端点是公开的（列出模型无需身份验证），但推理需要有效的 API 密钥。
+
+## 流式传输与工具支持
+
+| 功能          | 支持情况                                                   |
+| ------------- | ---------------------------------------------------------- |
+| **流式传输**  | ✅ 所有模型                                                |
+| **函数调用**  | ✅ 大多数模型（请检查 API 中的 `supportsFunctionCalling`） |
+| **视觉/图像** | ✅ 标有 “Vision” 功能的模型                                |
+| **JSON 模式** | ✅ 通过 `response_format` 支持                             |
+
+## 定价
+
+Venice 使用基于积分的系统。当前费率请查看 [venice.ai/pricing](https://venice.ai/pricing)：
+
+- **私密模型**：通常成本更低
+- **匿名模型**：与直接 API 定价相近，外加少量 Venice 费用
+
+## 对比：Venice 与直接 API
+
+| 方面     | Venice（匿名）       | 直接 API       |
+| -------- | -------------------- | -------------- |
+| **隐私** | 元数据被剥离，匿名化 | 关联到你的账户 |
+| **延迟** | +10-50ms（代理）     | 直接           |
+| **功能** | 支持大多数功能       | 完整功能       |
+| **计费** | Venice 积分          | 提供商计费     |
+
+## 使用示例
+
+```bash
+# 使用默认私密模型
+quantumclaw agent --model venice/kimi-k2-5 --message "Quick health check"
+
+# 通过 Venice 使用 Claude Opus（匿名）
+quantumclaw agent --model venice/claude-opus-4-6 --message "Summarize this task"
+
+# 使用未审查模型
+quantumclaw agent --model venice/venice-uncensored --message "Draft options"
+
+# 使用带图像的视觉模型
+quantumclaw agent --model venice/qwen3-vl-235b-a22b --message "Review attached image"
+
+# 使用编码模型
+quantumclaw agent --model venice/qwen3-coder-480b-a35b-instruct --message "Refactor this function"
+```
+
+## 故障排除
+
+### API 密钥无法识别
+
+```bash
+echo $VENICE_API_KEY
+quantumclaw models list | grep venice
+```
+
+请确保该密钥以 `vapi_` 开头。
+
+### 模型不可用
+
+Venice 模型目录会动态更新。运行 `quantumclaw models list` 以查看当前可用的模型。某些模型可能暂时离线。
+
+### 连接问题
+
+Venice API 地址为 `https://api.venice.ai/api/v1`。请确保你的网络允许 HTTPS 连接。
+
+## 配置文件示例
+
+```json5
+{
+  env: { VENICE_API_KEY: "vapi_..." },
+  agents: { defaults: { model: { primary: "venice/kimi-k2-5" } } },
+  models: {
+    mode: "merge",
+    providers: {
+      venice: {
+        baseUrl: "https://api.venice.ai/api/v1",
+        apiKey: "${VENICE_API_KEY}",
+        api: "openai-completions",
+        models: [
+          {
+            id: "kimi-k2-5",
+            name: "Kimi K2.5",
+            reasoning: true,
+            input: ["text", "image"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 256000,
+            maxTokens: 65536,
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+## 链接
+
+- [Venice AI](https://venice.ai)
+- [API Documentation](https://docs.venice.ai)
+- [Pricing](https://venice.ai/pricing)
+- [Status](https://status.venice.ai)

package/docs/zh-CN/providers/vercel-ai-gateway.md

@@ -0,0 +1,66 @@
+---
+read_when:
+  - 你想将 Vercel AI Gateway 与 QuantumClaw 一起使用
+  - 你需要 API key 环境变量或 CLI 认证选项
+summary: Vercel AI Gateway 设置（认证 + 模型选择）
+title: Vercel AI Gateway
+x-i18n:
+  generated_at: "2026-03-16T06:27:18Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: f30768dc3db49708b25042d317906f7ad9a2c72b0fa03263bc04f5eefbf7a507
+  source_path: providers/vercel-ai-gateway.md
+  workflow: 15
+---
+
+# Vercel AI Gateway
+
+[Vercel AI Gateway](https://vercel.com/ai-gateway) 提供统一 API，可通过单个端点访问数百个模型。
+
+- 提供商：`vercel-ai-gateway`
+- 认证：`AI_GATEWAY_API_KEY`
+- API：兼容 Anthropic Messages
+- QuantumClaw 会自动发现 Gateway 的 `/v1/models` 目录，因此 `/models vercel-ai-gateway`
+  会包含当前模型引用，例如 `vercel-ai-gateway/openai/gpt-5.4`。
+
+## 快速开始
+
+1. 设置 API key（推荐：为 Gateway 网关持久保存它）：
+
+```bash
+quantumclaw onboard --auth-choice ai-gateway-api-key
+```
+
+2. 设置默认模型：
+
+```json5
+{
+  agents: {
+    defaults: {
+      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
+    },
+  },
+}
+```
+
+## 非交互式示例
+
+```bash
+quantumclaw onboard --non-interactive \
+  --mode local \
+  --auth-choice ai-gateway-api-key \
+  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"
+```
+
+## 环境说明
+
+如果 Gateway 作为守护进程运行（launchd/systemd），请确保 `AI_GATEWAY_API_KEY`
+对此进程可用（例如放在 `~/.quantumclaw/.env` 中，或通过
+`env.shellEnv` 提供）。
+
+## 模型 ID 简写
+
+QuantumClaw 接受 Vercel Claude 简写模型引用，并会在运行时将其规范化：
+
+- `vercel-ai-gateway/claude-opus-4.6` -> `vercel-ai-gateway/anthropic/claude-opus-4.6`
+- `vercel-ai-gateway/opus-4.6` -> `vercel-ai-gateway/anthropic/claude-opus-4-6`

package/docs/zh-CN/providers/xiaomi.md

@@ -0,0 +1,93 @@
+---
+read_when:
+  - 你想在 QuantumClaw 中使用 Xiaomi MiMo 模型
+  - 你需要设置 `XIAOMI_API_KEY`
+summary: 在 QuantumClaw 中使用 Xiaomi MiMo 模型
+title: Xiaomi MiMo
+x-i18n:
+  generated_at: "2026-03-20T01:18:00Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: e0abfbe49f438807ce1c5cf5d7910e930c0d670f447f6eb53ca4e9af61cc0843
+  source_path: providers/xiaomi.md
+  workflow: 15
+---
+
+# Xiaomi MiMo
+
+Xiaomi MiMo 是 **MiMo** 模型的 API 平台。QuantumClaw 使用 Xiaomi 提供的
+OpenAI 兼容端点，并通过 API key 认证。请在
+[Xiaomi MiMo console](https://platform.xiaomimimo.com/#/console/api-keys) 中创建你的 API key，然后用它配置内置的
+`xiaomi` 提供商。
+
+## 模型概览
+
+- **mimo-v2-flash**：默认文本模型，262144-token 上下文窗口
+- **mimo-v2-pro**：支持推理的文本模型，1048576-token 上下文窗口
+- **mimo-v2-omni**：支持推理的多模态模型，支持文本和图像输入，262144-token 上下文窗口
+- Base URL：`https://api.xiaomimimo.com/v1`
+- API：`openai-completions`
+- 认证方式：`Bearer $XIAOMI_API_KEY`
+
+## CLI 设置
+
+```bash
+quantumclaw onboard --auth-choice xiaomi-api-key
+# 或非交互式
+quantumclaw onboard --auth-choice xiaomi-api-key --xiaomi-api-key "$XIAOMI_API_KEY"
+```
+
+## 配置片段
+
+```json5
+{
+  env: { XIAOMI_API_KEY: "your-key" },
+  agents: { defaults: { model: { primary: "xiaomi/mimo-v2-flash" } } },
+  models: {
+    mode: "merge",
+    providers: {
+      xiaomi: {
+        baseUrl: "https://api.xiaomimimo.com/v1",
+        api: "openai-completions",
+        apiKey: "XIAOMI_API_KEY",
+        models: [
+          {
+            id: "mimo-v2-flash",
+            name: "Xiaomi MiMo V2 Flash",
+            reasoning: false,
+            input: ["text"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 262144,
+            maxTokens: 8192,
+          },
+          {
+            id: "mimo-v2-pro",
+            name: "Xiaomi MiMo V2 Pro",
+            reasoning: true,
+            input: ["text"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 1048576,
+            maxTokens: 32000,
+          },
+          {
+            id: "mimo-v2-omni",
+            name: "Xiaomi MiMo V2 Omni",
+            reasoning: true,
+            input: ["text", "image"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 262144,
+            maxTokens: 32000,
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+## 说明
+
+- 默认模型引用：`xiaomi/mimo-v2-flash`。
+- 额外内置模型：`xiaomi/mimo-v2-pro`、`xiaomi/mimo-v2-omni`。
+- 当设置了 `XIAOMI_API_KEY`（或存在凭证配置文件）时，提供商会自动注入。
+- 有关提供商规则，请参阅 [/concepts/model-providers](/concepts/model-providers)。

package/docs/zh-CN/providers/zai.md

@@ -0,0 +1,53 @@
+---
+read_when:
+  - 你想在 QuantumClaw 中使用 Z.AI / GLM 模型
+  - 你需要简单的 `ZAI_API_KEY` 设置
+summary: 在 QuantumClaw 中使用 Z.AI（GLM 模型）
+title: Z.AI
+x-i18n:
+  generated_at: "2026-03-16T06:27:34Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 79ea8f3d6c286b5fef090e54257eb7c60c82b29630cee3f54e96161e55349bf5
+  source_path: providers/zai.md
+  workflow: 15
+---
+
+# Z.AI
+
+Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 API key
+进行认证。请在 Z.AI 控制台中创建你的 API key。QuantumClaw 使用 `zai` 提供商
+配合 Z.AI API key。
+
+## CLI 设置
+
+```bash
+# Coding Plan Global，推荐给 Coding Plan 用户
+quantumclaw onboard --auth-choice zai-coding-global
+
+# Coding Plan CN（中国区域），推荐给 Coding Plan 用户
+quantumclaw onboard --auth-choice zai-coding-cn
+
+# 通用 API
+quantumclaw onboard --auth-choice zai-global
+
+# 通用 API CN（中国区域）
+quantumclaw onboard --auth-choice zai-cn
+```
+
+## 配置片段
+
+```json5
+{
+  env: { ZAI_API_KEY: "sk-..." },
+  agents: { defaults: { model: { primary: "zai/glm-5" } } },
+}
+```
+
+## 说明
+
+- GLM 模型可用作 `zai/<model>`（例如：`zai/glm-5`）。
+- `tool_stream` 默认启用，用于 Z.AI 工具调用流式传输。若要禁用，请设置
+  `agents.defaults.models["zai/<model>"].params.tool_stream` 为 `false`。
+- 关于模型家族概览，请参阅 [/providers/glm](/providers/glm)。
+- Z.AI 使用带有你的 API key 的 Bearer 认证。