@gguf/claw 2026.2.1 → 2026.2.2

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

@@ -0,0 +1,41 @@
+---
+read_when:
+  - 你想通过 OpenCode Zen 访问模型
+  - 你想要一个适合编程的精选模型列表
+summary: 在 OpenClaw 中使用 OpenCode Zen（精选模型）
+title: OpenCode Zen
+x-i18n:
+  generated_at: "2026-02-01T21:35:16Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 1390f9803a3cac48cb40694dd69267e3ddccd203a4ce8babda3198b926b5f6a3
+  source_path: providers/opencode.md
+  workflow: 15
+---
+
+# OpenCode Zen
+
+OpenCode Zen 是由 OpenCode 团队推荐的一组**精选模型列表**，适用于编程智能体。它是一个可选的托管模型访问路径，使用 API 密钥和 `opencode` 提供商。Zen 目前处于测试阶段。
+
+## CLI 设置
+
+```bash
+openclaw onboard --auth-choice opencode-zen
+# 或非交互式
+openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
+```
+
+## 配置片段
+
+```json5
+{
+  env: { OPENCODE_API_KEY: "sk-..." },
+  agents: { defaults: { model: { primary: "opencode/claude-opus-4-5" } } },
+}
+```
+
+## 注意事项
+
+- 也支持 `OPENCODE_ZEN_API_KEY`。
+- 你需要登录 Zen，添加账单信息，然后复制你的 API 密钥。
+- OpenCode Zen 按请求计费；详情请查看 OpenCode 控制台。

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

@@ -0,0 +1,43 @@
+---
+read_when:
+  - 你想用一个 API 密钥访问多种 LLM
+  - 你想在 OpenClaw 中通过 OpenRouter 运行模型
+summary: 使用 OpenRouter 的统一 API 在 OpenClaw 中访问多种模型
+title: OpenRouter
+x-i18n:
+  generated_at: "2026-02-01T21:35:19Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: b7e29fc9c456c64d567dd909a85166e6dea8388ebd22155a31e69c970e081586
+  source_path: providers/openrouter.md
+  workflow: 15
+---
+
+# OpenRouter
+
+OpenRouter 提供了一个**统一 API**，通过单一端点和 API 密钥将请求路由到多种模型。它兼容 OpenAI，因此大多数 OpenAI SDK 只需切换 base URL 即可使用。
+
+## CLI 设置
+
+```bash
+openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"
+```
+
+## 配置片段
+
+```json5
+{
+  env: { OPENROUTER_API_KEY: "sk-or-..." },
+  agents: {
+    defaults: {
+      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
+    },
+  },
+}
+```
+
+## 注意事项
+
+- 模型引用格式为 `openrouter/<provider>/<model>`。
+- 更多模型/提供商选项，请参阅[模型提供商](/concepts/model-providers)。
+- OpenRouter 底层使用 Bearer 令牌和你的 API 密钥进行认证。

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

@@ -0,0 +1,55 @@
+---
+read_when:
+  - 你想在 OpenClaw 中使用 Qwen
+  - 你想通过免费版 OAuth 访问 Qwen Coder
+summary: 在 OpenClaw 中使用 Qwen OAuth（免费版）
+title: Qwen
+x-i18n:
+  generated_at: "2026-02-01T21:35:24Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 88b88e224e2fecbb1ca26e24fbccdbe25609be40b38335d0451343a5da53fdd4
+  source_path: providers/qwen.md
+  workflow: 15
+---
+
+# Qwen
+
+Qwen 提供免费版 OAuth 流程，可访问 Qwen Coder 和 Qwen Vision 模型（每天 2,000 次请求，受 Qwen 速率限制约束）。
+
+## 启用插件
+
+```bash
+openclaw plugins enable qwen-portal-auth
+```
+
+启用后重启 Gateway网关。
+
+## 认证
+
+```bash
+openclaw models auth login --provider qwen-portal --set-default
+```
+
+这将运行 Qwen 设备码 OAuth 流程，并将提供商条目写入你的 `models.json`（同时创建一个 `qwen` 别名以便快速切换）。
+
+## 模型 ID
+
+- `qwen-portal/coder-model`
+- `qwen-portal/vision-model`
+
+切换模型：
+
+```bash
+openclaw models set qwen-portal/coder-model
+```
+
+## 复用 Qwen Code CLI 登录
+
+如果你已经通过 Qwen Code CLI 登录，OpenClaw 在加载认证存储时会从 `~/.qwen/oauth_creds.json` 同步凭据。你仍然需要一个 `models.providers.qwen-portal` 条目（使用上面的登录命令创建）。
+
+## 注意事项
+
+- 令牌会自动刷新；如果刷新失败或访问被撤销，请重新运行登录命令。
+- 默认基础 URL：`https://portal.qwen.ai/v1`（如果 Qwen 提供了不同的端点，可通过 `models.providers.qwen-portal.baseUrl` 覆盖）。
+- 有关提供商通用规则，请参阅[模型提供商](/concepts/model-providers)。

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

@@ -0,0 +1,102 @@
+---
+read_when:
+  - 你想使用 Synthetic 作为模型提供商
+  - 你需要配置 Synthetic API 密钥或 base URL
+summary: 在 OpenClaw 中使用 Synthetic 的 Anthropic 兼容 API
+title: Synthetic
+x-i18n:
+  generated_at: "2026-02-01T21:35:34Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: f3f6e3eb864661754cbe2276783c5bc96ae01cb85ee4a19c92bed7863a35a4f7
+  source_path: providers/synthetic.md
+  workflow: 15
+---
+
+# Synthetic
+
+Synthetic 提供兼容 Anthropic 的端点。OpenClaw 将其注册为 `synthetic` 提供商，并使用 Anthropic Messages API。
+
+## 快速设置
+
+1. 设置 `SYNTHETIC_API_KEY`（或运行以下向导）。
+2. 运行新手引导：
+
+```bash
+openclaw onboard --auth-choice synthetic-api-key
+```
+
+默认模型设置为：
+
+```
+synthetic/hf:MiniMaxAI/MiniMax-M2.1
+```
+
+## 配置示例
+
+```json5
+{
+  env: { SYNTHETIC_API_KEY: "sk-..." },
+  agents: {
+    defaults: {
+      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.1" },
+      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.1": { alias: "MiniMax M2.1" } },
+    },
+  },
+  models: {
+    mode: "merge",
+    providers: {
+      synthetic: {
+        baseUrl: "https://api.synthetic.new/anthropic",
+        apiKey: "${SYNTHETIC_API_KEY}",
+        api: "anthropic-messages",
+        models: [
+          {
+            id: "hf:MiniMaxAI/MiniMax-M2.1",
+            name: "MiniMax M2.1",
+            reasoning: false,
+            input: ["text"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 192000,
+            maxTokens: 65536,
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+注意：OpenClaw 的 Anthropic 客户端会自动在 base URL 后追加 `/v1`，因此请使用 `https://api.synthetic.new/anthropic`（而非 `/anthropic/v1`）。如果 Synthetic 更改了其 base URL，请覆盖 `models.providers.synthetic.baseUrl`。
+
+## 模型目录
+
+以下所有模型的费用均为 `0`（输入/输出/缓存）。
+
+| 模型 ID                                                | 上下文窗口 | 最大令牌数 | 推理  | 输入         |
+| ------------------------------------------------------ | ---------- | ---------- | ----- | ------------ |
+| `hf:MiniMaxAI/MiniMax-M2.1`                            | 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`），请添加你计划使用的所有模型。
+- 参阅[模型提供商](/concepts/model-providers)了解提供商规则。

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

@@ -0,0 +1,274 @@
+---
+read_when:
+  - 你想在 OpenClaw 中使用注重隐私的推理服务
+  - 你需要 Venice AI 设置指导
+summary: 在 OpenClaw 中使用 Venice AI 注重隐私的模型
+title: Venice AI
+x-i18n:
+  generated_at: "2026-02-01T21:36:03Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2453a6ec3a715c24c460f902dec1755edcad40328de2ef895e35a614a25624cf
+  source_path: providers/venice.md
+  workflow: 15
+---
+
+# Venice AI（Venice 精选）
+
+**Venice** 是我们精选的 Venice 隐私优先推理配置，支持可选的匿名化访问专有模型。
+
+Venice AI 提供注重隐私的 AI 推理服务，支持无审查模型，并可通过其匿名代理访问主流专有模型。所有推理默认私密——不会用你的数据训练，不会记录日志。
+
+## 为什么在 OpenClaw 中使用 Venice
+
+- **私密推理**，适用于开源模型（无日志记录）。
+- 需要时可使用**无审查模型**。
+- 在质量重要时，可**匿名访问**专有模型（Opus/GPT/Gemini）。
+- 兼容 OpenAI 的 `/v1` 端点。
+
+## 隐私模式
+
+Venice 提供两种隐私级别——理解这一点是选择模型的关键：
+
+| 模式       | 描述                                                                                  | 模型                                        |
+| ---------- | ------------------------------------------------------------------------------------- | ------------------------------------------- |
+| **私密**   | 完全私密。提示词/回复**从不存储或记录**。临时性处理。                                 | Llama、Qwen、DeepSeek、Venice Uncensored 等 |
+| **匿名化** | 通过 Venice 代理转发并剥离元数据。底层提供商（OpenAI、Anthropic）收到的是匿名化请求。 | Claude、GPT、Gemini、Grok、Kimi、MiniMax    |
+
+## 功能特性
+
+- **注重隐私**：可选择"私密"（完全私密）和"匿名化"（代理转发）模式
+- **无审查模型**：访问无内容限制的模型
+- **主流模型访问**：通过 Venice 匿名代理使用 Claude、GPT-5.2、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. 配置 OpenClaw
+
+**方案 A：环境变量**
+
+```bash
+export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
+```
+
+**方案 B：交互式设置（推荐）**
+
+```bash
+openclaw onboard --auth-choice venice-api-key
+```
+
+这将：
+
+1. 提示输入你的 API 密钥（或使用已有的 `VENICE_API_KEY`）
+2. 显示所有可用的 Venice 模型
+3. 让你选择默认模型
+4. 自动配置提供商
+
+**方案 C：非交互式**
+
+```bash
+openclaw onboard --non-interactive \
+  --auth-choice venice-api-key \
+  --venice-api-key "vapi_xxxxxxxxxxxx"
+```
+
+### 3. 验证设置
+
+```bash
+openclaw chat --model venice/llama-3.3-70b "Hello, are you working?"
+```
+
+## 模型选择
+
+设置完成后，OpenClaw 会显示所有可用的 Venice 模型。根据你的需求选择：
+
+- **默认（我们的推荐）**：`venice/llama-3.3-70b`，私密且性能均衡。
+- **最佳整体质量**：`venice/claude-opus-45`，适合复杂任务（Opus 仍然是最强的）。
+- **隐私**：选择"私密"模型以获得完全私密的推理。
+- **能力**：选择"匿名化"模型以通过 Venice 代理访问 Claude、GPT、Gemini。
+
+随时更改默认模型：
+
+```bash
+openclaw models set venice/claude-opus-45
+openclaw models set venice/llama-3.3-70b
+```
+
+列出所有可用模型：
+
+```bash
+openclaw models list | grep venice
+```
+
+## 通过 `openclaw configure` 配置
+
+1. 运行 `openclaw configure`
+2. 选择 **Model/auth**
+3. 选择 **Venice AI**
+
+## 应该使用哪个模型？
+
+| 使用场景               | 推荐模型                         | 原因                         |
+| ---------------------- | -------------------------------- | ---------------------------- |
+| **通用对话**           | `llama-3.3-70b`                  | 综合表现好，完全私密         |
+| **最佳整体质量**       | `claude-opus-45`                 | Opus 在复杂任务上仍然最强    |
+| **隐私 + Claude 品质** | `claude-opus-45`                 | 通过匿名代理获得最佳推理能力 |
+| **编程**               | `qwen3-coder-480b-a35b-instruct` | 代码优化，262k 上下文        |
+| **视觉任务**           | `qwen3-vl-235b-a22b`             | 最佳私密视觉模型             |
+| **无审查**             | `venice-uncensored`              | 无内容限制                   |
+| **快速 + 低成本**      | `qwen3-4b`                       | 轻量级，仍有不错能力         |
+| **复杂推理**           | `deepseek-v3.2`                  | 推理能力强，私密             |
+
+## 可用模型（共 25 个）
+
+### 私密模型（15 个）— 完全私密，无日志记录
+
+| 模型 ID                          | 名称                    | 上下文（token） | 特性         |
+| -------------------------------- | ----------------------- | --------------- | ------------ |
+| `llama-3.3-70b`                  | Llama 3.3 70B           | 131k            | 通用         |
+| `llama-3.2-3b`                   | Llama 3.2 3B            | 131k            | 快速，轻量   |
+| `hermes-3-llama-3.1-405b`        | Hermes 3 Llama 3.1 405B | 131k            | 复杂任务     |
+| `qwen3-235b-a22b-thinking-2507`  | Qwen3 235B Thinking     | 131k            | 推理         |
+| `qwen3-235b-a22b-instruct-2507`  | Qwen3 235B Instruct     | 131k            | 通用         |
+| `qwen3-coder-480b-a35b-instruct` | Qwen3 Coder 480B        | 262k            | 编程         |
+| `qwen3-next-80b`                 | Qwen3 Next 80B          | 262k            | 通用         |
+| `qwen3-vl-235b-a22b`             | Qwen3 VL 235B           | 262k            | 视觉         |
+| `qwen3-4b`                       | Venice Small (Qwen3 4B) | 32k             | 快速，推理   |
+| `deepseek-v3.2`                  | DeepSeek V3.2           | 163k            | 推理         |
+| `venice-uncensored`              | Venice Uncensored       | 32k             | 无审查       |
+| `mistral-31-24b`                 | Venice Medium (Mistral) | 131k            | 视觉         |
+| `google-gemma-3-27b-it`          | Gemma 3 27B Instruct    | 202k            | 视觉         |
+| `openai-gpt-oss-120b`            | OpenAI GPT OSS 120B     | 131k            | 通用         |
+| `zai-org-glm-4.7`                | GLM 4.7                 | 202k            | 推理，多语言 |
+
+### 匿名化模型（10 个）— 通过 Venice 代理
+
+| 模型 ID                  | 原始模型          | 上下文（token） | 特性       |
+| ------------------------ | ----------------- | --------------- | ---------- |
+| `claude-opus-45`         | Claude Opus 4.5   | 202k            | 推理，视觉 |
+| `claude-sonnet-45`       | Claude Sonnet 4.5 | 202k            | 推理，视觉 |
+| `openai-gpt-52`          | GPT-5.2           | 262k            | 推理       |
+| `openai-gpt-52-codex`    | GPT-5.2 Codex     | 262k            | 推理，视觉 |
+| `gemini-3-pro-preview`   | Gemini 3 Pro      | 202k            | 推理，视觉 |
+| `gemini-3-flash-preview` | Gemini 3 Flash    | 262k            | 推理，视觉 |
+| `grok-41-fast`           | Grok 4.1 Fast     | 262k            | 推理，视觉 |
+| `grok-code-fast-1`       | Grok Code Fast 1  | 262k            | 推理，编程 |
+| `kimi-k2-thinking`       | Kimi K2 Thinking  | 262k            | 推理       |
+| `minimax-m21`            | MiniMax M2.1      | 202k            | 推理       |
+
+## 模型发现
+
+当设置了 `VENICE_API_KEY` 时，OpenClaw 会自动从 Venice API 发现模型。如果 API 不可达，则回退到静态目录。
+
+`/models` 端点是公开的（列出模型无需认证），但推理需要有效的 API 密钥。
+
+## 流式输出与工具支持
+
+| 功能          | 支持情况                                                   |
+| ------------- | ---------------------------------------------------------- |
+| **流式输出**  | ✅ 所有模型                                                |
+| **函数调用**  | ✅ 大多数模型（请检查 API 中的 `supportsFunctionCalling`） |
+| **视觉/图像** | ✅ 标记为"视觉"特性的模型                                  |
+| **JSON 模式** | ✅ 通过 `response_format` 支持                             |
+
+## 定价
+
+Venice 使用积分制。请查看 [venice.ai/pricing](https://venice.ai/pricing) 了解当前费率：
+
+- **私密模型**：通常成本较低
+- **匿名化模型**：与直接 API 定价相近 + 少量 Venice 费用
+
+## 对比：Venice 与直接 API
+
+| 方面     | Venice（匿名化）   | 直接 API     |
+| -------- | ------------------ | ------------ |
+| **隐私** | 剥离元数据，匿名化 | 关联你的账户 |
+| **延迟** | +10-50ms（代理）   | 直连         |
+| **功能** | 支持大部分功能     | 完整功能     |
+| **计费** | Venice 积分        | 提供商计费   |
+
+## 使用示例
+
+```bash
+# 使用默认私密模型
+openclaw chat --model venice/llama-3.3-70b
+
+# 通过 Venice 使用 Claude（匿名化）
+openclaw chat --model venice/claude-opus-45
+
+# 使用无审查模型
+openclaw chat --model venice/venice-uncensored
+
+# 使用视觉模型处理图像
+openclaw chat --model venice/qwen3-vl-235b-a22b
+
+# 使用编程模型
+openclaw chat --model venice/qwen3-coder-480b-a35b-instruct
+```
+
+## 故障排除
+
+### API 密钥无法识别
+
+```bash
+echo $VENICE_API_KEY
+openclaw models list | grep venice
+```
+
+确保密钥以 `vapi_` 开头。
+
+### 模型不可用
+
+Venice 模型目录会动态更新。运行 `openclaw models list` 查看当前可用的模型。部分模型可能暂时离线。
+
+### 连接问题
+
+Venice API 地址为 `https://api.venice.ai/api/v1`。确保你的网络允许 HTTPS 连接。
+
+## 配置文件示例
+
+```json5
+{
+  env: { VENICE_API_KEY: "vapi_..." },
+  agents: { defaults: { model: { primary: "venice/llama-3.3-70b" } } },
+  models: {
+    mode: "merge",
+    providers: {
+      venice: {
+        baseUrl: "https://api.venice.ai/api/v1",
+        apiKey: "${VENICE_API_KEY}",
+        api: "openai-completions",
+        models: [
+          {
+            id: "llama-3.3-70b",
+            name: "Llama 3.3 70B",
+            reasoning: false,
+            input: ["text"],
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+            contextWindow: 131072,
+            maxTokens: 8192,
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+## 链接
+
+- [Venice AI](https://venice.ai)
+- [API 文档](https://docs.venice.ai)
+- [定价](https://venice.ai/pricing)
+- [状态页](https://status.venice.ai)

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

@@ -0,0 +1,57 @@
+---
+read_when:
+  - 你想要将 Vercel AI Gateway 与 OpenClaw 配合使用
+  - 你需要 API 密钥环境变量或 CLI 认证选项
+summary: Vercel AI Gateway 设置（认证 + 模型选择）
+title: Vercel AI Gateway
+x-i18n:
+  generated_at: "2026-02-01T21:36:13Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: c6482f047a31b09c7a691d40babbd1f9fb3aa2042b61cc42956ad9b791da8285
+  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
+
+## 快速开始
+
+1. 设置 API 密钥（推荐：为 Gateway网关存储密钥）：
+
+```bash
+openclaw onboard --auth-choice ai-gateway-api-key
+```
+
+2. 设置默认模型：
+
+```json5
+{
+  agents: {
+    defaults: {
+      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.5" },
+    },
+  },
+}
+```
+
+## 非交互式示例
+
+```bash
+openclaw 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`
+对该进程可用（例如，在 `~/.openclaw/.env` 中或通过
+`env.shellEnv` 设置）。

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

@@ -0,0 +1,68 @@
+---
+read_when:
+  - 你想在 OpenClaw 中使用 Xiaomi MiMo 模型
+  - 你需要设置 XIAOMI_API_KEY
+summary: 在 OpenClaw 中使用 Xiaomi MiMo (mimo-v2-flash)
+title: Xiaomi MiMo
+x-i18n:
+  generated_at: "2026-02-01T21:36:15Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 366fd2297b2caf8c5ad944d7f1b6d233b248fe43aedd22a28352ae7f370d2435
+  source_path: providers/xiaomi.md
+  workflow: 15
+---
+
+# Xiaomi MiMo
+
+Xiaomi MiMo 是 **MiMo** 模型的 API 平台。它提供与 OpenAI 和 Anthropic 格式兼容的 REST API，并使用 API 密钥进行身份验证。请在 [Xiaomi MiMo 控制台](https://platform.xiaomimimo.com/#/console/api-keys) 中创建你的 API 密钥。OpenClaw 使用 `xiaomi` 提供商配合 Xiaomi MiMo API 密钥。
+
+## 模型概览
+
+- **mimo-v2-flash**：262144 token 上下文窗口，兼容 Anthropic Messages API。
+- 基础 URL：`https://api.xiaomimimo.com/anthropic`
+- 授权方式：`Bearer $XIAOMI_API_KEY`
+
+## CLI 设置
+
+```bash
+openclaw onboard --auth-choice xiaomi-api-key
+# 或非交互式
+openclaw 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/anthropic",
+        api: "anthropic-messages",
+        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,
+          },
+        ],
+      },
+    },
+  },
+}
+```
+
+## 备注
+
+- 模型引用：`xiaomi/mimo-v2-flash`。
+- 当设置了 `XIAOMI_API_KEY`（或存在身份验证配置文件）时，该提供商会自动注入。
+- 有关提供商规则，请参阅 [/concepts/model-providers](/concepts/model-providers)。

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

@@ -0,0 +1,41 @@
+---
+read_when:
+  - 你想在 OpenClaw 中使用 Z.AI / GLM 模型
+  - 你需要简单的 ZAI_API_KEY 配置
+summary: 在 OpenClaw 中使用智谱 AI（GLM 模型）
+title: Z.AI
+x-i18n:
+  generated_at: "2026-02-01T21:36:13Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2c24bbad86cf86c38675a58e22f9e1b494f78a18fdc3051c1be80d2d9a800711
+  source_path: providers/zai.md
+  workflow: 15
+---
+
+# Z.AI
+
+Z.AI 是 **GLM** 模型的 API 平台。它为 GLM 提供 REST API，并使用 API 密钥进行身份验证。请在 Z.AI 控制台中创建你的 API 密钥。OpenClaw 通过 `zai` 提供商配合 Z.AI API 密钥使用。
+
+## CLI 设置
+
+```bash
+openclaw onboard --auth-choice zai-api-key
+# 或非交互式
+openclaw onboard --zai-api-key "$ZAI_API_KEY"
+```
+
+## 配置片段
+
+```json5
+{
+  env: { ZAI_API_KEY: "sk-..." },
+  agents: { defaults: { model: { primary: "zai/glm-4.7" } } },
+}
+```
+
+## 注意事项
+
+- GLM 模型以 `zai/<model>` 的形式提供（例如：`zai/glm-4.7`）。
+- 参阅 [/providers/glm](/providers/glm) 了解模型系列概览。
+- Z.AI 使用 Bearer 认证方式配合你的 API 密钥。