openclaw-botonline 0.1.4

package/docs/providers/opencode.md

@@ -0,0 +1,34 @@
+---
+summary: "在 Clawdbot 中使用 OpenCode Zen（精选模型）"
+read_when:
+  - 您想通过 OpenCode Zen 访问模型
+  - 您想要一个精选的编程友好模型列表
+---
+# OpenCode Zen
+
+OpenCode Zen 是由 OpenCode 团队推荐的**精选编程模型列表**。
+它是一个可选的托管模型访问方式，使用 API 密钥和 `opencode` 供应商。
+Zen 目前处于 Beta 阶段。
+
+## CLI 配置
+
+```bash
+openclaw-cn onboard --auth-choice opencode-zen
+# 或非交互式
+openclaw-cn 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/providers/openrouter.md

@@ -0,0 +1,36 @@
+---
+summary: "在 Clawdbot 中通过 OpenRouter 统一 API 访问多种模型"
+read_when:
+  - 您想用一个 API 密钥访问多种 LLM
+  - 您想在 Clawdbot 中通过 OpenRouter 使用模型
+---
+# OpenRouter
+
+OpenRouter 是一个**统一的模型 API 网关**，通过单一端点和 API 密钥将请求路由到多种模型（Claude、GPT、Gemini、Llama、DeepSeek 等）。它兼容 OpenAI API 格式，大多数 OpenAI SDK 只需切换 base URL 即可使用。
+
+OpenRouter 对国内用户特别友好：**支持支付宝 (Alipay) 充值**，无需国际信用卡即可使用海外主流模型。
+
+## CLI 配置
+
+```bash
+openclaw-cn 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](/concepts/model-providers)。
+- OpenRouter 底层使用 Bearer token 配合您的 API 密钥进行认证。

package/docs/providers/qwen.md

@@ -0,0 +1,51 @@
+---
+summary: "Use Qwen OAuth (free tier) in Clawdbot"
+read_when:
+  - You want to use Qwen with Clawdbot
+  - You want free-tier OAuth access to Qwen Coder
+---
+# Qwen
+
+Qwen provides a free-tier OAuth flow for Qwen Coder and Qwen Vision models
+(2,000 requests/day, subject to Qwen rate limits).
+
+## Enable the plugin
+
+```bash
+openclaw-cn plugins enable qwen-portal-auth
+```
+
+Restart the Gateway after enabling.
+
+## Authenticate
+
+```bash
+openclaw-cn models auth login --provider qwen-portal --set-default
+```
+
+This runs the Qwen device-code OAuth flow and writes a provider entry to your
+`models.json` (plus a `qwen` alias for quick switching).
+
+## Model IDs
+
+- `qwen-portal/coder-model`
+- `qwen-portal/vision-model`
+
+Switch models with:
+
+```bash
+openclaw-cn models set qwen-portal/coder-model
+```
+
+## Reuse Qwen Code CLI login
+
+If you already logged in with the Qwen Code CLI, Clawdbot will sync credentials
+from `~/.qwen/oauth_creds.json` when it loads the auth store. You still need a
+`models.providers.qwen-portal` entry (use the login command above to create one).
+
+## Notes
+
+- Tokens auto-refresh; re-run the login command if refresh fails or access is revoked.
+- Default base URL: `https://portal.qwen.ai/v1` (override with
+  `models.providers.qwen-portal.baseUrl` if Qwen provides a different endpoint).
+- See [Model providers](/concepts/model-providers) for provider-wide rules.

package/docs/providers/synthetic.md

@@ -0,0 +1,97 @@
+---
+summary: "Use Synthetic's Anthropic-compatible API in Clawdbot"
+read_when:
+  - You want to use Synthetic as a model provider
+  - You need a Synthetic API key or base URL setup
+---
+# Synthetic
+
+Synthetic exposes Anthropic-compatible endpoints. Clawdbot registers it as the
+`synthetic` provider and uses the Anthropic Messages API.
+
+## Quick setup
+
+1) Set `SYNTHETIC_API_KEY` (or run the wizard below).
+2) Run onboarding:
+
+```bash
+openclaw-cn onboard --auth-choice synthetic-api-key
+```
+
+The default model is set to:
+
+```
+synthetic/hf:MiniMaxAI/MiniMax-M2.1
+```
+
+## Config example
+
+```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
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+Note: Clawdbot's Anthropic client appends `/v1` to the base URL, so use
+`https://api.synthetic.new/anthropic` (not `/anthropic/v1`). If Synthetic changes
+its base URL, override `models.providers.synthetic.baseUrl`.
+
+## Model catalog
+
+All models below use cost `0` (input/output/cache).
+
+| Model ID | Context window | Max tokens | Reasoning | Input |
+| --- | --- | --- | --- | --- |
+| `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 |
+
+## Notes
+
+- Model refs use `synthetic/<modelId>`.
+- If you enable a model allowlist (`agents.defaults.models`), add every model you
+  plan to use.
+- See [Model providers](/concepts/model-providers) for provider rules.

package/docs/providers/venice.md

@@ -0,0 +1,264 @@
+---
+summary: "在 Clawdbot 中使用 Venice AI 隐私优先模型"
+read_when:
+  - 您想在 Clawdbot 中使用隐私优先的推理
+  - 您需要 Venice AI 配置指南
+---
+# Venice AI（Venius 推荐方案）
+
+**Venius** 是我们推荐的 Venice 配置方案，提供隐私优先的推理，并可选择通过匿名代理访问主流商业模型。
+
+Venice AI 提供隐私优先的 AI 推理服务，支持无审查模型，以及通过匿名代理访问主流商业模型。所有推理默认私密——不会用您的数据训练，不记录日志。
+
+## 为什么选择 Venice
+
+- **私密推理** — 开源模型完全不记录日志
+- **无审查模型** — 在需要时使用
+- **匿名访问** — 通过代理使用商业模型（Opus/GPT/Gemini），元数据被剥离
+- 兼容 OpenAI `/v1` 端点
+
+## 隐私模式
+
+Venice 提供两种隐私级别，选择模型时需要了解：
+
+| 模式 | 说明 | 适用模型 |
+|------|------|---------|
+| **私密 (Private)** | 完全私密。提示和回复**永不存储或记录**。 | Llama、Qwen、DeepSeek、Venice Uncensored 等 |
+| **匿名 (Anonymized)** | 通过 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. 配置 Clawdbot
+
+**方式 A：环境变量**
+
+```bash
+export VENICE_API_KEY="vapi_xxxxxxxxxxxx"
+```
+
+**方式 B：交互式配置（推荐）**
+
+```bash
+openclaw-cn onboard --auth-choice venice-api-key
+```
+
+这将：
+1. 提示输入 API 密钥（或使用已有的 `VENICE_API_KEY`）
+2. 显示所有可用的 Venice 模型
+3. 让您选择默认模型
+4. 自动配置供应商
+
+**方式 C：非交互式**
+
+```bash
+openclaw-cn onboard --non-interactive \
+  --auth-choice venice-api-key \
+  --venice-api-key "vapi_xxxxxxxxxxxx"
+```
+
+### 3. 验证配置
+
+```bash
+clawdbot chat --model venice/llama-3.3-70b "Hello, are you working?"
+```
+
+## 模型选择
+
+配置完成后，Clawdbot 会显示所有可用的 Venice 模型。根据需求选择：
+
+- **默认推荐**：`venice/llama-3.3-70b` — 私密，性能均衡
+- **最佳综合质量**：`venice/claude-opus-45` — 适合高难度任务（Opus 仍然最强）
+- **隐私优先**：选择"私密"模型，完全不记录日志
+- **能力优先**：选择"匿名"模型，通过 Venice 代理访问 Claude、GPT、Gemini
+
+随时切换默认模型：
+
+```bash
+openclaw-cn models set venice/claude-opus-45
+openclaw-cn models set venice/llama-3.3-70b
+```
+
+列出所有可用模型：
+
+```bash
+openclaw-cn models list | grep venice
+```
+
+## 通过 `clawdbot configure` 配置
+
+1. 运行 `clawdbot 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 | 名称 | 上下文（tokens） | 特性 |
+|---------|------|-----------------|------|
+| `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 | 原始模型 | 上下文（tokens） | 特性 |
+|---------|---------|-----------------|------|
+| `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` 后，Clawdbot 会自动从 Venice API 发现模型。如果 API 不可达，则回退到静态模型目录。
+
+`/models` 端点是公开的（列出模型不需要认证），但推理需要有效的 API 密钥。
+
+## 流式传输和工具支持
+
+| 功能 | 支持情况 |
+|------|---------|
+| **流式传输** | 所有模型支持 |
+| **函数调用** | 大部分模型支持（查看 API 中的 `supportsFunctionCalling`） |
+| **视觉/图片** | 标记"视觉"特性的模型支持 |
+| **JSON 模式** | 通过 `response_format` 支持 |
+
+## 定价
+
+Venice 使用积分制。当前费率请查看 [venice.ai/pricing](https://venice.ai/pricing)：
+
+- **私密模型**：通常成本更低
+- **匿名模型**：接近直接 API 定价 + Venice 小额费用
+
+## 对比：Venice vs 直接 API
+
+| 方面 | Venice（匿名） | 直接 API |
+|------|---------------|---------|
+| **隐私** | 元数据被剥离，匿名化 | 关联您的账户 |
+| **延迟** | +10-50ms（代理） | 直连 |
+| **功能** | 大部分功能支持 | 全部功能 |
+| **计费** | Venice 积分 | 供应商计费 |
+
+## 使用示例
+
+```bash
+# 使用默认私密模型
+clawdbot chat --model venice/llama-3.3-70b
+
+# 通过 Venice 使用 Claude（匿名）
+clawdbot chat --model venice/claude-opus-45
+
+# 使用无审查模型
+clawdbot chat --model venice/venice-uncensored
+
+# 使用视觉模型
+clawdbot chat --model venice/qwen3-vl-235b-a22b
+
+# 使用编程模型
+clawdbot chat --model venice/qwen3-coder-480b-a35b-instruct
+```
+
+## 故障排除
+
+### API 密钥无法识别
+
+```bash
+echo $VENICE_API_KEY
+openclaw-cn models list | grep venice
+```
+
+确保密钥以 `vapi_` 开头。
+
+### 模型不可用
+
+Venice 模型目录动态更新。运行 `openclaw-cn 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/providers/vercel-ai-gateway.md

@@ -0,0 +1,48 @@
+---
+title: "Vercel AI Gateway"
+summary: "Vercel AI Gateway 配置（认证 + 模型选择）"
+read_when:
+  - 您想在 Clawdbot 中使用 Vercel AI Gateway
+  - 您需要 API 密钥环境变量或 CLI 认证选项
+---
+# Vercel AI Gateway
+
+[Vercel AI Gateway](https://vercel.com/ai-gateway) 提供统一 API，通过单一端点访问数百种模型。
+
+- 供应商：`vercel-ai-gateway`
+- 认证：`AI_GATEWAY_API_KEY`
+- API：兼容 Anthropic Messages 格式
+
+## 快速开始
+
+1) 设置 API 密钥（推荐：为网关存储）：
+
+```bash
+openclaw-cn onboard --auth-choice ai-gateway-api-key
+```
+
+2) 设置默认模型：
+
+```json5
+{
+  agents: {
+    defaults: {
+      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.5" }
+    }
+  }
+}
+```
+
+## 非交互式示例
+
+```bash
+openclaw-cn onboard --non-interactive \
+  --mode local \
+  --auth-choice ai-gateway-api-key \
+  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"
+```
+
+## 环境说明
+
+如果网关以守护进程运行（launchd/systemd），请确保该进程能访问 `AI_GATEWAY_API_KEY`
+（例如写在 `~/.openclaw/.env` 中或通过 `env.shellEnv` 设置）。

package/docs/providers/volcengine.md

@@ -0,0 +1,114 @@
+---
+summary: "使用火山引擎 (豆包) 模型"
+read_when:
+  - 您想使用火山引擎/豆包模型
+  - 您想配置字节跳动的 AI 服务
+---
+
+# 火山引擎 (Volcengine)
+
+火山引擎是字节跳动旗下的云服务平台，提供豆包等大语言模型的 API 服务。
+
+## 快速开始
+
+### 方式一：引导安装（推荐）
+
+运行 onboard 命令，选择「火山引擎 (ARK) API key」：
+
+```bash
+openclaw-cn onboard
+```
+
+按提示输入 API Key，系统会自动配置并验证模型访问权限。
+
+### 方式二：手动配置
+
+1. 设置环境变量或在配置中添加 API Key：
+
+```bash
+export VOLCENGINE_API_KEY="your-api-key"
+```
+
+2. 配置供应商：
+
+```json5
+{
+  "models": {
+    "providers": {
+      "volcengine": {
+        "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
+        "apiKey": "${VOLCENGINE_API_KEY}",
+        "api": "openai-completions",
+        "models": [
+          { "id": "doubao-1-5-pro-32k-250115", "name": "豆包 1.5 Pro 32K" },
+          { "id": "doubao-1-5-lite-32k-250115", "name": "豆包 1.5 Lite 32K" }
+        ]
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": { "primary": "volcengine/doubao-1-5-pro-32k-250115" }
+    }
+  }
+}
+```
+
+## 获取 API Key
+
+1. 登录 [火山引擎控制台](https://console.volcengine.com/)
+2. 进入「火山方舟」(ARK) 控制台
+3. 创建 API Key 或使用现有的 Key
+4. 如果使用付费模型，需要先在控制台创建推理接入点 (Endpoint)
+
+## 模型 ID
+
+火山引擎的模型 ID 格式取决于您的配置方式：
+
+- **按量付费模型**：使用模型名称，如 `doubao-1-5-pro-32k-250115`
+- **自定义 Endpoint**：使用您在控制台创建的 Endpoint ID
+
+常用模型：
+
+| 模型 ID | 说明 |
+|---------|------|
+| `doubao-1-5-pro-32k-250115` | 豆包 1.5 Pro，32K 上下文 |
+| `doubao-1-5-lite-32k-250115` | 豆包 1.5 Lite，32K 上下文 |
+| `doubao-pro-32k` | 豆包 Pro，32K 上下文 |
+| `doubao-lite-32k` | 豆包 Lite，32K 上下文 |
+
+## 企业用户：自定义 Header
+
+如果需要为请求添加自定义 Header（如标识调用来源用于审计），可通过环境变量配置：
+
+```bash
+export MODEL_AGENT_CLIENT_REQ_ID="X-Custom-Source"
+export MODEL_AGENT_CLIENT_REQ_VALUE="your-app-name"
+```
+
+配置后，所有发往火山引擎的请求都会带上该 Header。
+
+## 切换模型
+
+```bash
+# 设置默认模型
+openclaw-cn models set volcengine/doubao-1-5-pro-32k-250115
+
+# 在聊天中切换
+/model volcengine/doubao-1-5-pro-32k-250115
+```
+
+## 故障排除
+
+### "Endpoint not found" 错误
+
+检查模型 ID 是否正确。如果使用自定义 Endpoint，确保 ID 与控制台一致。
+
+### "Permission denied" 错误
+
+确保 API Key 有访问该模型的权限，或在控制台开通按量付费。
+
+## 相关文档
+
+- [自定义供应商配置](/guides/custom-ai-providers)
+- [模型选择](/concepts/models)

package/docs/providers/zai.md

@@ -0,0 +1,34 @@
+---
+summary: "Use Z.AI (GLM models) with Clawdbot"
+read_when:
+  - You want Z.AI / GLM models in Clawdbot
+  - You need a simple ZAI_API_KEY setup
+---
+# Z.AI
+
+Z.AI is the API platform for **GLM** models. It provides REST APIs for GLM and uses API keys
+for authentication. Create your API key in the Z.AI console. Clawdbot uses the `zai` provider
+with a Z.AI API key.
+
+## CLI setup
+
+```bash
+openclaw-cn onboard --auth-choice zai-api-key
+# or non-interactive
+openclaw-cn onboard --zai-api-key "$ZAI_API_KEY"
+```
+
+## Config snippet
+
+```json5
+{
+  env: { ZAI_API_KEY: "sk-..." },
+  agents: { defaults: { model: { primary: "zai/glm-4.7" } } }
+}
+```
+
+## Notes
+
+- GLM models are available as `zai/<model>` (example: `zai/glm-4.7`).
+- See [/providers/glm](/providers/glm) for the model family overview.
+- Z.AI uses Bearer auth with your API key.