From 42a327bf6c04e206c7f968d199d6ad2ab10e2e34 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Wed, 22 Apr 2026 04:51:45 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/providers/ollama.md | 136 ++++++++++++++++----------------- 1 file changed, 68 insertions(+), 68 deletions(-) diff --git a/docs/zh-CN/providers/ollama.md b/docs/zh-CN/providers/ollama.md index b33af1833..c592570a1 100644 --- a/docs/zh-CN/providers/ollama.md +++ b/docs/zh-CN/providers/ollama.md @@ -6,20 +6,20 @@ read_when: summary: 使用 Ollama 运行 OpenClaw（云端和本地模型） title: Ollama x-i18n: - generated_at: "2026-04-21T21:37:02Z" + generated_at: "2026-04-22T04:50:54Z" model: gpt-5.4 provider: openai - source_hash: 32623b6523f22930a5987fb22d2074f1e9bb274cc01ae1ad1837825cc04ec179 + source_hash: 704beed3bf988d6c2ad50b2a1533f6dcef655e44b34f23104827d2acb71b8655 source_path: providers/ollama.md workflow: 15 --- # Ollama -OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模型和本地/自托管的 Ollama 服务器。你可以通过三种模式使用 Ollama：通过可访问的 Ollama 主机使用 `云端 + 本地`，针对 `https://ollama.com` 使用 `仅云端`，或针对可访问的 Ollama 主机使用 `仅本地`。 +OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管的云端模型以及本地 / 自托管的 Ollama 服务器。你可以通过三种模式使用 Ollama：通过可访问的 Ollama 主机实现的 `Cloud + Local`、针对 `https://ollama.com` 的 `Cloud only`，或针对可访问 Ollama 主机的 `Local only`。 -**远程 Ollama 用户**：不要在 OpenClaw 中使用 `/v1` 的 OpenAI 兼容 URL（`http://host:11434/v1`）。这会破坏工具调用，模型还可能把原始工具 JSON 作为纯文本输出。请改用原生 Ollama API URL：`baseUrl: "http://host:11434"`（不要加 `/v1`）。 +**远程 Ollama 用户**：不要在 OpenClaw 中使用 `/v1` 的 OpenAI 兼容 URL（`http://host:11434/v1`）。这会破坏工具调用，模型还可能将原始工具 JSON 作为纯文本输出。请改用原生 Ollama API URL：`baseUrl: "http://host:11434"`（不要加 `/v1`）。 ## 入门指南 @@ -39,12 +39,12 @@ OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模 从提供商列表中选择 **Ollama**。 - - **云端 + 本地** — 本地 Ollama 主机，加上通过该主机路由的云模型 - - **仅云端** — 通过 `https://ollama.com` 使用托管的 Ollama 模型 - - **仅本地** — 仅使用本地模型 + - **Cloud + Local** — 本地 Ollama 主机，加上通过该主机路由的云端模型 + - **Cloud only** — 通过 `https://ollama.com` 使用托管的 Ollama 模型 + - **Local only** — 仅使用本地模型 - `仅云端` 会提示输入 `OLLAMA_API_KEY`，并推荐托管云端默认模型。`云端 + 本地` 和 `仅本地` 会要求提供 Ollama 基础 URL，发现可用模型，并在所选本地模型尚不可用时自动拉取。`云端 + 本地` 还会检查该 Ollama 主机是否已登录以启用云访问。 + `Cloud only` 会提示输入 `OLLAMA_API_KEY`，并建议托管云端默认模型。`Cloud + Local` 和 `Local only` 会要求提供 Ollama 基础 URL，发现可用模型，并在所选本地模型尚不可用时自动拉取。`Cloud + Local` 还会检查该 Ollama 主机是否已登录以启用云端访问。 ```bash @@ -61,7 +61,7 @@ OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模 --accept-risk ``` - 你也可以选择性指定自定义基础 URL 或模型： + 你也可以选择指定自定义基础 URL 或模型： ```bash openclaw onboard --non-interactive \ @@ -74,13 +74,13 @@ OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模 - **最适合：** 完全掌控云端或本地设置。 + **最适合：** 完全控制云端或本地设置。 - - **云端 + 本地**：安装 Ollama，使用 `ollama signin` 登录，并通过该主机路由云请求 - - **仅云端**：使用带有 `OLLAMA_API_KEY` 的 `https://ollama.com` - - **仅本地**：从 [ollama.com/download](https://ollama.com/download) 安装 Ollama + - **Cloud + Local**：安装 Ollama，使用 `ollama signin` 登录，并通过该主机路由云端请求 + - **Cloud only**：使用带有 `OLLAMA_API_KEY` 的 `https://ollama.com` + - **Local only**：从 [ollama.com/download](https://ollama.com/download) 安装 Ollama ```bash @@ -92,7 +92,7 @@ OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模 ``` - 对于 `仅云端`，请使用你真实的 `OLLAMA_API_KEY`。对于基于主机的设置，任意占位值都可以： + 对于 `Cloud only`，请使用你真实的 `OLLAMA_API_KEY`。对于基于主机的设置，任意占位值都可以： ```bash # 云端 @@ -105,7 +105,7 @@ OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模 openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY" ``` - + ```bash openclaw models list openclaw models set ollama/gemma4 @@ -128,47 +128,47 @@ OpenClaw 集成了 Ollama 的原生 API（`/api/chat`），可用于托管云模 -## 云模型 +## 云端模型 - - `云端 + 本地` 会把可访问的 Ollama 主机作为本地模型和云模型的统一控制点。这是 Ollama 偏好的混合使用流程。 + + `Cloud + Local` 使用一个可访问的 Ollama 主机作为本地和云端模型的控制点。这是 Ollama 推荐的混合流程。 - 在设置期间使用 **云端 + 本地**。OpenClaw 会提示输入 Ollama 基础 URL，从该主机发现本地模型，并检查该主机是否已通过 `ollama signin` 登录以启用云访问。当主机已登录时，OpenClaw 还会推荐托管云端默认模型，例如 `kimi-k2.5:cloud`、`minimax-m2.7:cloud` 和 `glm-5.1:cloud`。 + 在设置期间使用 **Cloud + Local**。OpenClaw 会提示输入 Ollama 基础 URL，从该主机发现本地模型，并检查该主机是否已通过 `ollama signin` 登录以启用云端访问。当主机已登录时，OpenClaw 还会建议托管的云端默认模型，例如 `kimi-k2.5:cloud`、`minimax-m2.7:cloud` 和 `glm-5.1:cloud`。 - 如果主机尚未登录，OpenClaw 会保持为仅本地设置，直到你运行 `ollama signin`。 + 如果该主机尚未登录，OpenClaw 会将设置保持为仅本地，直到你运行 `ollama signin`。 - - `仅云端` 通过 Ollama 的托管 API `https://ollama.com` 运行。 + + `Cloud only` 通过 Ollama 的托管 API `https://ollama.com` 运行。 - 在设置期间使用 **仅云端**。OpenClaw 会提示输入 `OLLAMA_API_KEY`，设置 `baseUrl: "https://ollama.com"`，并填充托管云模型列表。此路径**不**需要本地 Ollama 服务器，也不需要 `ollama signin`。 + 在设置期间使用 **Cloud only**。OpenClaw 会提示输入 `OLLAMA_API_KEY`，设置 `baseUrl: "https://ollama.com"`，并填充托管云端模型列表。此路径 **不** 需要本地 Ollama 服务器或 `ollama signin`。 - 在 `openclaw onboard` 期间显示的云模型列表会通过 `https://ollama.com/api/tags` 实时填充，最多显示 500 条，因此选择器反映的是当前托管目录，而不是静态预设。如果设置时 `ollama.com` 无法访问或未返回任何模型，OpenClaw 会回退到之前的硬编码推荐项，以便新手引导仍能完成。 + `openclaw onboard` 期间显示的云端模型列表会从 `https://ollama.com/api/tags` 实时填充，上限为 500 条，因此选择器反映的是当前托管目录，而不是静态预设。如果在设置时无法访问 `ollama.com` 或未返回任何模型，OpenClaw 会回退到之前的硬编码建议，以便新手引导仍可完成。 - - 在仅本地模式下，OpenClaw 会从已配置的 Ollama 实例发现模型。此路径适用于本地或自托管的 Ollama 服务器。 + + 在仅本地模式下，OpenClaw 会从已配置的 Ollama 实例中发现模型。此路径适用于本地或自托管的 Ollama 服务器。 - OpenClaw 当前推荐 `gemma4` 作为本地默认模型。 + OpenClaw 当前建议 `gemma4` 作为本地默认模型。 ## 模型发现（隐式提供商） -当你设置了 `OLLAMA_API_KEY`（或认证配置文件），并且**没有**定义 `models.providers.ollama` 时，OpenClaw 会从位于 `http://127.0.0.1:11434` 的本地 Ollama 实例发现模型。 +当你设置了 `OLLAMA_API_KEY`（或凭证配置文件），并且**没有**定义 `models.providers.ollama` 时，OpenClaw 会从位于 `http://127.0.0.1:11434` 的本地 Ollama 实例中发现模型。 -| 行为 | 说明 | +| 行为 | 详情 | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 目录查询 | 查询 `/api/tags` | -| 能力检测 | 使用尽力而为的 `/api/show` 查询来读取 `contextWindow` 并检测能力（包括视觉） | -| 视觉模型 | 对于 `/api/show` 报告了 `vision` 能力的模型，会标记为支持图像（`input: ["text", "image"]`），因此 OpenClaw 会自动将图像注入提示词 | +| 能力检测 | 使用尽力而为的 `/api/show` 查询读取 `contextWindow` 并检测能力（包括视觉） | +| 视觉模型 | 如果 `/api/show` 报告模型具有 `vision` 能力，则该模型会被标记为支持图像（`input: ["text", "image"]`），因此 OpenClaw 会自动将图像注入提示词 | | 推理检测 | 使用模型名称启发式（`r1`、`reasoning`、`think`）标记 `reasoning` | -| Token 限制 | 将 `maxTokens` 设置为 OpenClaw 使用的默认 Ollama 最大 token 上限 | -| 成本 | 所有成本均设为 `0` | +| token 限制 | 将 `maxTokens` 设置为 OpenClaw 使用的默认 Ollama 最大 token 上限 | +| 成本 | 将所有成本设置为 `0` | 这样可以避免手动录入模型，同时让模型目录与本地 Ollama 实例保持一致。 @@ -178,21 +178,21 @@ ollama list openclaw models list ``` -要添加新模型，只需使用 Ollama 拉取即可： +要添加新模型，只需使用 Ollama 拉取它： ```bash ollama pull mistral ``` -新模型会被自动发现并可立即使用。 +新模型会被自动发现并可直接使用。 -如果你显式设置了 `models.providers.ollama`，自动发现将被跳过，你必须手动定义模型。参见下方的显式配置部分。 +如果你显式设置了 `models.providers.ollama`，将跳过自动发现，此时你必须手动定义模型。请参见下方的显式配置部分。 ## 视觉与图像描述 -内置的 Ollama 插件会将 Ollama 注册为支持图像的媒体理解提供商。这使 OpenClaw 能够将显式的图像描述请求以及已配置的图像模型默认值，路由到本地或托管的 Ollama 视觉模型。 +内置的 Ollama 插件会将 Ollama 注册为支持图像的媒体理解提供商。这使 OpenClaw 能够通过本地或托管的 Ollama 视觉模型，路由显式图像描述请求以及已配置的图像模型默认值。 对于本地视觉模型，请拉取一个支持图像的模型： @@ -210,9 +210,9 @@ openclaw infer image describe \ --json ``` -`--model` 必须是完整的 `` 引用。设置后，`openclaw infer image describe` 会直接运行该模型，而不会因为模型支持原生视觉而跳过描述。 +`--model` 必须是完整的 `` 引用。设置后，`openclaw infer image describe` 将直接运行该模型，而不会因为模型支持原生视觉而跳过描述。 -要让 Ollama 成为传入媒体的默认图像理解模型，请配置 `agents.defaults.imageModel`： +要让 Ollama 成为入站媒体的默认图像理解模型，请配置 `agents.defaults.imageModel`： ```json5 { @@ -226,7 +226,7 @@ openclaw infer image describe \ } ``` -如果你手动定义了 `models.providers.ollama.models`，请为视觉模型标记图像输入支持： +如果你手动定义 `models.providers.ollama.models`，请为视觉模型标记图像输入支持： ```json5 { @@ -238,7 +238,7 @@ openclaw infer image describe \ } ``` -OpenClaw 会拒绝未标记为支持图像的模型所发起的图像描述请求。在隐式发现模式下，当 `/api/show` 报告视觉能力时，OpenClaw 会从 Ollama 中读取此信息。 +对于未标记为支持图像的模型，OpenClaw 会拒绝图像描述请求。在隐式发现模式下，如果 `/api/show` 报告了视觉能力，OpenClaw 会从 Ollama 读取此信息。 ## 配置 @@ -251,13 +251,13 @@ OpenClaw 会拒绝未标记为支持图像的模型所发起的图像描述请 ``` - 如果设置了 `OLLAMA_API_KEY`，你可以在提供商条目中省略 `apiKey`，OpenClaw 会在可用性检查时自动填入。 + 如果已设置 `OLLAMA_API_KEY`，你可以在提供商条目中省略 `apiKey`，OpenClaw 会自动填入它以进行可用性检查。 - 当你需要托管云设置、Ollama 运行在其他主机/端口、想强制指定特定上下文窗口或模型列表，或者需要完全手动定义模型时，请使用显式配置。 + 当你希望使用托管云端设置、Ollama 运行在其他主机 / 端口上、你想强制指定特定的上下文窗口或模型列表，或者你想完全手动定义模型时，请使用显式配置。 ```json5 { @@ -287,7 +287,7 @@ OpenClaw 会拒绝未标记为支持图像的模型所发起的图像描述请 - 如果 Ollama 运行在不同的主机或端口上（显式配置会禁用自动发现，因此你需要手动定义模型）： + 如果 Ollama 运行在其他主机或端口上（显式配置会禁用自动发现，因此你需要手动定义模型）： ```json5 { @@ -296,7 +296,7 @@ OpenClaw 会拒绝未标记为支持图像的模型所发起的图像描述请 ollama: { apiKey: "ollama-local", baseUrl: "http://ollama-host:11434", // 不要加 /v1 - 使用原生 Ollama API URL - api: "ollama", // 显式设置以确保原生工具调用行为 + api: "ollama", // 显式设置，以确保原生工具调用行为 }, }, }, @@ -312,7 +312,7 @@ OpenClaw 会拒绝未标记为支持图像的模型所发起的图像描述请 ### 模型选择 -配置完成后，你的所有 Ollama 模型都会可用： +配置完成后，你的所有 Ollama 模型都可用： ```json5 { @@ -329,15 +329,15 @@ OpenClaw 会拒绝未标记为支持图像的模型所发起的图像描述请 ## Ollama Web 搜索 -OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商。 +OpenClaw 支持 **Ollama Web 搜索**，作为内置的 `web_search` 提供商。 -| 属性 | 说明 | +| 属性 | 详情 | | ----------- | ----------------------------------------------------------------------------------------------------------------- | -| 主机 | 使用你已配置的 Ollama 主机（设置了 `models.providers.ollama.baseUrl` 时使用该值，否则使用 `http://127.0.0.1:11434`） | +| 主机 | 使用你配置的 Ollama 主机（设置了 `models.providers.ollama.baseUrl` 时使用该值，否则使用 `http://127.0.0.1:11434`） | | 认证 | 无需密钥 | | 要求 | Ollama 必须正在运行，并已通过 `ollama signin` 登录 | -在 `openclaw onboard` 或 `openclaw configure --section web` 期间选择 **Ollama Web 搜索**，或者设置： +在 `openclaw onboard` 或 `openclaw configure --section web` 期间选择 **Ollama Web 搜索**，或设置： ```json5 { @@ -360,10 +360,10 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 - **在 OpenAI 兼容模式下，工具调用并不可靠。** 仅当你需要通过代理使用 OpenAI 格式，且不依赖原生工具调用行为时，才应使用此模式。 + **在 OpenAI 兼容模式下，工具调用并不可靠。** 仅当你需要为代理使用 OpenAI 格式，且不依赖原生工具调用行为时，才使用此模式。 - 如果你需要改用 OpenAI 兼容端点（例如位于只支持 OpenAI 格式的代理之后），请显式设置 `api: "openai-completions"`： + 如果你需要改用 OpenAI 兼容端点（例如在仅支持 OpenAI 格式的代理后方），请显式设置 `api: "openai-completions"`： ```json5 { @@ -381,9 +381,9 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 } ``` - 此模式可能无法同时支持流式传输和工具调用。你可能需要在模型配置中使用 `params: { streaming: false }` 来禁用流式传输。 + 此模式可能不支持同时进行流式传输和工具调用。你可能需要在模型配置中使用 `params: { streaming: false }` 禁用流式传输。 - 当 Ollama 使用 `api: "openai-completions"` 时，OpenClaw 默认会注入 `options.num_ctx`，以避免 Ollama 悄悄回退到 4096 的上下文窗口。如果你的代理/上游会拒绝未知的 `options` 字段，请禁用此行为： + 当 Ollama 使用 `api: "openai-completions"` 时，OpenClaw 默认会注入 `options.num_ctx`，以避免 Ollama 静默回退到 4096 的上下文窗口。如果你的代理 / 上游拒绝未知的 `options` 字段，请禁用此行为： ```json5 { @@ -404,7 +404,7 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 - 对于自动发现的模型，OpenClaw 会在可用时使用 Ollama 报告的上下文窗口；否则会回退到 OpenClaw 使用的默认 Ollama 上下文窗口。 + 对于自动发现的模型，OpenClaw 会优先使用 Ollama 报告的上下文窗口；如果不可用，则回退到 OpenClaw 为 Ollama 使用的默认上下文窗口。 你可以在显式提供商配置中覆盖 `contextWindow` 和 `maxTokens`： @@ -429,29 +429,27 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 - OpenClaw 默认会将名称中包含 `deepseek-r1`、`reasoning` 或 `think` 的模型视为支持推理的模型。 + OpenClaw 默认会将名称中包含 `deepseek-r1`、`reasoning` 或 `think` 的模型视为具备推理能力。 ```bash ollama pull deepseek-r1:32b ``` - 不需要额外配置——OpenClaw 会自动标记它们。 + 无需额外配置——OpenClaw 会自动标记它们。 - Ollama 是免费的，并且可在本地运行，因此所有模型成本都设置为 $0。这同时适用于自动发现和手动定义的模型。 + Ollama 可免费使用并在本地运行，因此所有模型成本都设置为 $0。这同时适用于自动发现的模型和手动定义的模型。 - 内置的 Ollama 插件为 - [memory search](/zh-CN/concepts/memory) 注册了一个内存嵌入提供商。它使用已配置的 Ollama 基础 URL - 和 API 密钥。 + 内置的 Ollama 插件为 [memory search](/zh-CN/concepts/memory) 注册了一个内存嵌入提供商。它使用已配置的 Ollama 基础 URL 和 API 密钥。 | 属性 | 值 | | ------------- | ------------------- | | 默认模型 | `nomic-embed-text` | - | 自动拉取 | 是——如果本地不存在，该嵌入模型会被自动拉取 | + | 自动拉取 | 是——如果本地不存在，该嵌入模型会自动拉取 | 要将 Ollama 选为 memory search 的嵌入提供商： @@ -468,7 +466,9 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 - OpenClaw 的 Ollama 集成默认使用 **原生 Ollama API**（`/api/chat`），它完全支持同时进行流式传输和工具调用。不需要任何特殊配置。 + OpenClaw 的 Ollama 集成默认使用 **原生 Ollama API**（`/api/chat`），可完整支持同时进行流式传输和工具调用。无需特殊配置。 + + 对于原生 `/api/chat` 请求，OpenClaw 还会将 thinking 控制直接转发给 Ollama：`/think off` 和 `openclaw agent --thinking off` 会发送顶层 `think: false`，而非 `off` 的 thinking 级别会发送 `think: true`。 如果你需要使用 OpenAI 兼容端点，请参见上方的“旧版 OpenAI 兼容模式”部分。在该模式下，流式传输和工具调用可能无法同时工作。 @@ -481,13 +481,13 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 - 请确保 Ollama 正在运行，并且你已设置 `OLLAMA_API_KEY`（或认证配置文件），同时你**没有**定义显式的 `models.providers.ollama` 条目： + 请确保 Ollama 正在运行，并且你已设置 `OLLAMA_API_KEY`（或凭证配置文件），同时**没有**定义显式的 `models.providers.ollama` 条目： ```bash ollama serve ``` - 验证 API 是否可访问： + 验证 API 可访问： ```bash curl http://localhost:11434/api/tags @@ -496,7 +496,7 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 - 如果列表中没有你的模型，请在本地拉取该模型，或者在 `models.providers.ollama` 中显式定义它。 + 如果列表中没有你的模型，请在本地拉取该模型，或在 `models.providers.ollama` 中显式定义它。 ```bash ollama list # 查看已安装的模型 @@ -522,7 +522,7 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 -更多帮助：[故障排除](/zh-CN/help/troubleshooting) 和 [常见问题](/zh-CN/help/faq)。 +更多帮助：参见 [故障排除](/zh-CN/help/troubleshooting) 和 [常见问题](/zh-CN/help/faq)。 ## 相关内容 @@ -535,7 +535,7 @@ OpenClaw 支持将 **Ollama Web 搜索** 作为内置的 `web_search` 提供商 如何选择和配置模型。 - 由 Ollama 驱动的 web search 的完整设置和行为细节。 + 由 Ollama 驱动的 Web 搜索的完整设置和行为细节。 完整配置参考。