@gguf/claw 2026.2.1 → 2026.2.2

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

@@ -0,0 +1,158 @@
+---
+read_when:
+  - 你想在 OpenClaw 中使用 Anthropic 模型
+  - 你想使用 setup-token 而非 API 密钥
+summary: 在 OpenClaw 中通过 API 密钥或 setup-token 使用 Anthropic Claude
+title: Anthropic
+x-i18n:
+  generated_at: "2026-02-01T21:34:53Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: a78ccd855810a93e71d7138af4d3fc7d66e877349815c4a3207cf2214b0150b3
+  source_path: providers/anthropic.md
+  workflow: 15
+---
+
+# Anthropic (Claude)
+
+Anthropic 开发了 **Claude** 模型系列，并通过 API 提供访问。
+在 OpenClaw 中，你可以使用 API 密钥或 **setup-token** 进行认证。
+
+## 方案 A：Anthropic API 密钥
+
+**适用于：** 标准 API 访问和按量计费。
+在 Anthropic Console 中创建你的 API 密钥。
+
+### CLI 设置
+
+```bash
+openclaw onboard
+# 选择：Anthropic API key
+
+# 或非交互式
+openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
+```
+
+### 配置片段
+
+```json5
+{
+  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
+  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
+}
+```
+
+## 提示缓存（Anthropic API）
+
+OpenClaw 支持 Anthropic 的提示缓存功能。此功能**仅限 API**；订阅认证不支持缓存设置。
+
+### 配置
+
+在模型配置中使用 `cacheRetention` 参数：
+
+| 值      | 缓存时长 | 描述                       |
+| ------- | -------- | -------------------------- |
+| `none`  | 不缓存   | 禁用提示缓存               |
+| `short` | 5 分钟   | API 密钥认证的默认值       |
+| `long`  | 1 小时   | 扩展缓存（需要 beta 标志） |
+
+```json5
+{
+  agents: {
+    defaults: {
+      models: {
+        "anthropic/claude-opus-4-5": {
+          params: { cacheRetention: "long" },
+        },
+      },
+    },
+  },
+}
+```
+
+### 默认值
+
+使用 Anthropic API 密钥认证时，OpenClaw 会自动为所有 Anthropic 模型应用 `cacheRetention: "short"`（5 分钟缓存）。你可以在配置中显式设置 `cacheRetention` 来覆盖此默认值。
+
+### 旧版参数
+
+旧的 `cacheControlTtl` 参数仍然支持向后兼容：
+
+- `"5m"` 对应 `short`
+- `"1h"` 对应 `long`
+
+我们建议迁移到新的 `cacheRetention` 参数。
+
+OpenClaw 在 Anthropic API 请求中包含了 `extended-cache-ttl-2025-04-11` beta 标志；如果你覆盖了提供商请求头，请保留此标志（参见 [/gateway/configuration](/gateway/configuration)）。
+
+## 方案 B：Claude setup-token
+
+**适用于：** 使用你的 Claude 订阅。
+
+### 如何获取 setup-token
+
+Setup-token 由 **Claude Code CLI** 创建，而非 Anthropic Console。你可以在**任何机器**上运行：
+
+```bash
+claude setup-token
+```
+
+将令牌粘贴到 OpenClaw 中（向导中选择：**Anthropic token (paste setup-token)**），或在 Gateway网关主机上运行：
+
+```bash
+openclaw models auth setup-token --provider anthropic
+```
+
+如果你在其他机器上生成了令牌，请粘贴：
+
+```bash
+openclaw models auth paste-token --provider anthropic
+```
+
+### CLI 设置
+
+```bash
+# 在新手引导过程中粘贴 setup-token
+openclaw onboard --auth-choice setup-token
+```
+
+### 配置片段
+
+```json5
+{
+  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
+}
+```
+
+## 注意事项
+
+- 使用 `claude setup-token` 生成令牌并粘贴，或在 Gateway网关主机上运行 `openclaw models auth setup-token`。
+- 如果在 Claude 订阅上看到 "OAuth token refresh failed …" 错误，请使用 setup-token 重新认证。参见 [/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription](/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription)。
+- 认证详情和重用规则请参阅 [/concepts/oauth](/concepts/oauth)。
+
+## 故障排除
+
+**401 错误 / 令牌突然失效**
+
+- Claude 订阅认证可能会过期或被撤销。重新运行 `claude setup-token`
+  并将其粘贴到 **Gateway网关主机**上。
+- 如果 Claude CLI 登录在另一台机器上，请在 Gateway网关主机上使用
+  `openclaw models auth paste-token --provider anthropic`。
+
+**No API key found for provider "anthropic"**
+
+- 认证是**按智能体**设置的。新智能体不会继承主智能体的密钥。
+- 为该智能体重新运行新手引导，或在 Gateway网关主机上粘贴 setup-token / API 密钥，
+  然后使用 `openclaw models status` 验证。
+
+**No credentials found for profile `anthropic:default`**
+
+- 运行 `openclaw models status` 查看当前活跃的认证配置文件。
+- 重新运行新手引导，或为该配置文件粘贴 setup-token / API 密钥。
+
+**No available auth profile (all in cooldown/unavailable)**
+
+- 检查 `openclaw models status --json` 中的 `auth.unusableProfiles`。
+- 添加另一个 Anthropic 配置文件或等待冷却期结束。
+
+更多信息：[/gateway/troubleshooting](/gateway/troubleshooting) 和 [/help/faq](/help/faq)。

package/docs/zh-CN/providers/claude-max-api-proxy.md

@@ -0,0 +1,155 @@
+---
+read_when:
+  - 你想将 Claude Max 订阅与 OpenAI 兼容工具配合使用
+  - 你想要一个封装 Claude Code CLI 的本地 API 服务器
+  - 你想通过使用订阅而非 API 密钥来节省费用
+summary: 将 Claude Max/Pro 订阅用作 OpenAI 兼容的 API 端点
+title: Claude Max API 代理
+x-i18n:
+  generated_at: "2026-02-01T21:34:52Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 63b61096b96b720c6d0c317520852db65d72ca8279b3868f35e8387fe3b6ce41
+  source_path: providers/claude-max-api-proxy.md
+  workflow: 15
+---
+
+# Claude Max API 代理
+
+**claude-max-api-proxy** 是一个社区工具，将你的 Claude Max/Pro 订阅暴露为 OpenAI 兼容的 API 端点。这使你可以将订阅与任何支持 OpenAI API 格式的工具配合使用。
+
+## 为什么使用它？
+
+| 方式            | 费用                                            | 适用场景                 |
+| --------------- | ----------------------------------------------- | ------------------------ |
+| Anthropic API   | 按 token 计费（Opus 约 $15/M 输入，$75/M 输出） | 生产应用、高流量场景     |
+| Claude Max 订阅 | 每月固定 $200                                   | 个人使用、开发、无限用量 |
+
+如果你有 Claude Max 订阅并希望与 OpenAI 兼容工具配合使用，这个代理可以帮你节省大量费用。
+
+## 工作原理
+
+```
+你的应用 → claude-max-api-proxy → Claude Code CLI → Anthropic（通过订阅）
+     （OpenAI 格式）              （转换格式）           （使用你的登录凭据）
+```
+
+该代理：
+
+1. 在 `http://localhost:3456/v1/chat/completions` 接受 OpenAI 格式的请求
+2. 将其转换为 Claude Code CLI 命令
+3. 以 OpenAI 格式返回响应（支持流式传输）
+
+## 安装
+
+```bash
+# 需要 Node.js 20+ 和 Claude Code CLI
+npm install -g claude-max-api-proxy
+
+# 验证 Claude CLI 已认证
+claude --version
+```
+
+## 使用方法
+
+### 启动服务器
+
+```bash
+claude-max-api
+# 服务器运行在 http://localhost:3456
+```
+
+### 测试
+
+```bash
+# 健康检查
+curl http://localhost:3456/health
+
+# 列出模型
+curl http://localhost:3456/v1/models
+
+# 聊天补全
+curl http://localhost:3456/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "claude-opus-4",
+    "messages": [{"role": "user", "content": "Hello!"}]
+  }'
+```
+
+### 与 OpenClaw 配合使用
+
+你可以将 OpenClaw 指向该代理作为自定义 OpenAI 兼容端点：
+
+```json5
+{
+  env: {
+    OPENAI_API_KEY: "not-needed",
+    OPENAI_BASE_URL: "http://localhost:3456/v1",
+  },
+  agents: {
+    defaults: {
+      model: { primary: "openai/claude-opus-4" },
+    },
+  },
+}
+```
+
+## 可用模型
+
+| 模型 ID           | 对应模型        |
+| ----------------- | --------------- |
+| `claude-opus-4`   | Claude Opus 4   |
+| `claude-sonnet-4` | Claude Sonnet 4 |
+| `claude-haiku-4`  | Claude Haiku 4  |
+
+## macOS 自动启动
+
+创建 LaunchAgent 以自动运行代理：
+
+```bash
+cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.claude-max-api</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/node</string>
+    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
+  </dict>
+</dict>
+</plist>
+EOF
+
+launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist
+```
+
+## 链接
+
+- **npm:** https://www.npmjs.com/package/claude-max-api-proxy
+- **GitHub:** https://github.com/atalovesyou/claude-max-api-proxy
+- **Issues:** https://github.com/atalovesyou/claude-max-api-proxy/issues
+
+## 注意事项
+
+- 这是一个**社区工具**，并非由 Anthropic 或 OpenClaw 官方支持
+- 需要有效的 Claude Max/Pro 订阅并已认证 Claude Code CLI
+- 代理在本地运行，不会将数据发送到任何第三方服务器
+- 完全支持流式响应
+
+## 另请参阅
+
+- [Anthropic 提供商](/providers/anthropic) - OpenClaw 与 Claude 的原生集成，使用 setup-token 或 API 密钥
+- [OpenAI 提供商](/providers/openai) - 适用于 OpenAI/Codex 订阅

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

@@ -0,0 +1,97 @@
+---
+read_when:
+  - 你想使用 Deepgram 语音转文字处理音频附件
+  - 你需要一个快速的 Deepgram 配置示例
+summary: Deepgram 语音转录，用于接收语音消息
+title: Deepgram
+x-i18n:
+  generated_at: "2026-02-01T21:34:47Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 8f19e072f08672116ed1a72578635c0dcebb2b1f0dfcbefa12f80b21a18ad25c
+  source_path: providers/deepgram.md
+  workflow: 15
+---
+
+# Deepgram（音频转录）
+
+Deepgram 是一个语音转文字 API。在 OpenClaw 中，它通过 `tools.media.audio` 用于**接收音频/语音消息的转录**。
+
+启用后，OpenClaw 会将音频文件上传到 Deepgram，并将转录文本注入回复管道（`{{Transcript}}` + `[Audio]` 块）。这**不是流式**处理；它使用的是预录音转录端点。
+
+网站：https://deepgram.com  
+文档：https://developers.deepgram.com
+
+## 快速开始
+
+1. 设置你的 API 密钥：
+
+```
+DEEPGRAM_API_KEY=dg_...
+```
+
+2. 启用提供商：
+
+```json5
+{
+  tools: {
+    media: {
+      audio: {
+        enabled: true,
+        models: [{ provider: "deepgram", model: "nova-3" }],
+      },
+    },
+  },
+}
+```
+
+## 选项
+
+- `model`：Deepgram 模型 ID（默认：`nova-3`）
+- `language`：语言提示（可选）
+- `tools.media.audio.providerOptions.deepgram.detect_language`：启用语言检测（可选）
+- `tools.media.audio.providerOptions.deepgram.punctuate`：启用标点符号（可选）
+- `tools.media.audio.providerOptions.deepgram.smart_format`：启用智能格式化（可选）
+
+带语言参数的示例：
+
+```json5
+{
+  tools: {
+    media: {
+      audio: {
+        enabled: true,
+        models: [{ provider: "deepgram", model: "nova-3", language: "en" }],
+      },
+    },
+  },
+}
+```
+
+带 Deepgram 选项的示例：
+
+```json5
+{
+  tools: {
+    media: {
+      audio: {
+        enabled: true,
+        providerOptions: {
+          deepgram: {
+            detect_language: true,
+            punctuate: true,
+            smart_format: true,
+          },
+        },
+        models: [{ provider: "deepgram", model: "nova-3" }],
+      },
+    },
+  },
+}
+```
+
+## 注意事项
+
+- 认证遵循标准提供商认证顺序；`DEEPGRAM_API_KEY` 是最简单的方式。
+- 使用代理时，可通过 `tools.media.audio.baseUrl` 和 `tools.media.audio.headers` 覆盖端点或请求头。
+- 输出遵循与其他提供商相同的音频规则（大小限制、超时、转录文本注入）。

package/docs/zh-CN/providers/github-copilot.md

@@ -0,0 +1,67 @@
+---
+read_when:
+  - 你想使用 GitHub Copilot 作为模型提供商
+  - 你需要了解 `openclaw models auth login-github-copilot` 流程
+summary: 使用设备流从 OpenClaw 登录 GitHub Copilot
+title: GitHub Copilot
+x-i18n:
+  generated_at: "2026-02-01T21:34:57Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 503e0496d92c921e2f7111b1b4ba16374f5b781643bfbc6cb69cea97d9395c25
+  source_path: providers/github-copilot.md
+  workflow: 15
+---
+
+# GitHub Copilot
+
+## 什么是 GitHub Copilot？
+
+GitHub Copilot 是 GitHub 的 AI 编程助手。它为你的 GitHub 账户和订阅计划提供 Copilot 模型的访问权限。OpenClaw 可以通过两种不同的方式将 Copilot 用作模型提供商。
+
+## 在 OpenClaw 中使用 Copilot 的两种方式
+
+### 1）内置 GitHub Copilot 提供商（`github-copilot`）
+
+使用原生设备登录流程获取 GitHub 令牌，然后在 OpenClaw 运行时将其兑换为 Copilot API 令牌。这是**默认**且最简单的方式，因为它不需要 VS Code。
+
+### 2）Copilot Proxy 插件（`copilot-proxy`）
+
+使用 **Copilot Proxy** VS Code 扩展作为本地桥接。OpenClaw 与代理的 `/v1` 端点通信，并使用你在其中配置的模型列表。当你已经在 VS Code 中运行 Copilot Proxy 或需要通过它进行路由时，选择此方式。你必须启用该插件并保持 VS Code 扩展运行。
+
+使用 GitHub Copilot 作为模型提供商（`github-copilot`）。登录命令运行 GitHub 设备流程，保存认证配置文件，并更新你的配置以使用该配置文件。
+
+## CLI 设置
+
+```bash
+openclaw models auth login-github-copilot
+```
+
+系统会提示你访问一个 URL 并输入一次性代码。请保持终端打开直到流程完成。
+
+### 可选参数
+
+```bash
+openclaw models auth login-github-copilot --profile-id github-copilot:work
+openclaw models auth login-github-copilot --yes
+```
+
+## 设置默认模型
+
+```bash
+openclaw models set github-copilot/gpt-4o
+```
+
+### 配置片段
+
+```json5
+{
+  agents: { defaults: { model: { primary: "github-copilot/gpt-4o" } } },
+}
+```
+
+## 注意事项
+
+- 需要交互式 TTY；请直接在终端中运行。
+- Copilot 模型的可用性取决于你的订阅计划；如果某个模型被拒绝，请尝试其他 ID（例如 `github-copilot/gpt-4.1`）。
+- 登录会将 GitHub 令牌存储在认证配置文件中，并在 OpenClaw 运行时将其兑换为 Copilot API 令牌。

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

@@ -0,0 +1,39 @@
+---
+read_when:
+  - 你想在 OpenClaw 中使用 GLM 模型
+  - 你需要了解模型命名规范和设置方法
+summary: GLM 模型系列概述 + 如何在 OpenClaw 中使用
+title: GLM 模型
+x-i18n:
+  generated_at: "2026-02-01T21:34:53Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2d7b457f033f26f28c230a9cd2310151f825fc52c3ee4fb814d08fd2d022d041
+  source_path: providers/glm.md
+  workflow: 15
+---
+
+# GLM 模型
+
+GLM 是一个**模型系列**（而非公司），通过 Z.AI 平台提供。在 OpenClaw 中，GLM 模型通过 `zai` 提供商访问，模型 ID 格式如 `zai/glm-4.7`。
+
+## CLI 设置
+
+```bash
+openclaw onboard --auth-choice zai-api-key
+```
+
+## 配置片段
+
+```json5
+{
+  env: { ZAI_API_KEY: "sk-..." },
+  agents: { defaults: { model: { primary: "zai/glm-4.7" } } },
+}
+```
+
+## 注意事项
+
+- GLM 版本和可用性可能会变化；请查阅 Z.AI 的文档获取最新信息。
+- 示例模型 ID 包括 `glm-4.7` 和 `glm-4.6`。
+- 有关提供商的详细信息，请参阅 [/providers/zai](/providers/zai)。

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

@@ -0,0 +1,67 @@
+---
+read_when:
+  - 你想选择一个模型提供商
+  - 你需要快速了解支持的 LLM 后端
+summary: OpenClaw 支持的模型提供商（LLM）
+title: 模型提供商
+x-i18n:
+  generated_at: "2026-02-01T21:35:01Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: eb4a97438adcf610499253afcf8b2af6624f4be098df389a6c3746f14c4a901b
+  source_path: providers/index.md
+  workflow: 15
+---
+
+# 模型提供商
+
+OpenClaw 可以使用多种 LLM 提供商。选择一个提供商，完成认证，然后将默认模型设置为 `provider/model`。
+
+在找聊天渠道文档（WhatsApp/Telegram/Discord/Slack/Mattermost（插件）/等）？请参阅[渠道](/channels)。
+
+## 推荐：Venice (Venice AI)
+
+Venice 是我们推荐的 Venice AI 配置方案，适合注重隐私的推理场景，并可选择使用 Opus 处理复杂任务。
+
+- 默认：`venice/llama-3.3-70b`
+- 综合最佳：`venice/claude-opus-45`（Opus 仍然是最强的）
+
+参阅 [Venice AI](/providers/venice)。
+
+## 快速开始
+
+1. 向提供商进行认证（通常通过 `openclaw onboard`）。
+2. 设置默认模型：
+
+```json5
+{
+  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
+}
+```
+
+## 提供商文档
+
+- [OpenAI (API + Codex)](/providers/openai)
+- [Anthropic (API + Claude Code CLI)](/providers/anthropic)
+- [Qwen (OAuth)](/providers/qwen)
+- [OpenRouter](/providers/openrouter)
+- [Vercel AI Gateway](/providers/vercel-ai-gateway)
+- [Moonshot AI (Kimi + Kimi Coding)](/providers/moonshot)
+- [OpenCode Zen](/providers/opencode)
+- [Amazon Bedrock](/bedrock)
+- [Z.AI](/providers/zai)
+- [Xiaomi](/providers/xiaomi)
+- [GLM 模型](/providers/glm)
+- [MiniMax](/providers/minimax)
+- [Venice (Venice AI，注重隐私)](/providers/venice)
+- [Ollama (本地模型)](/providers/ollama)
+
+## 转录提供商
+
+- [Deepgram (音频转录)](/providers/deepgram)
+
+## 社区工具
+
+- [Claude Max API 代理](/providers/claude-max-api-proxy) - 将 Claude Max/Pro 订阅用作 OpenAI 兼容的 API 端点
+
+如需完整的提供商目录（xAI、Groq、Mistral 等）及高级配置，请参阅[模型提供商](/concepts/model-providers)。