OpenClaw Ollama 提供商配置指南

Ollama 是一个本地 LLM 运行时，可让你轻松在本地机器上运行开源模型。OpenClaw 集成了 Ollama 兼容 OpenAI 的 API，当你通过 OLLAMA_API_KEY（或认证配置）启用该功能，且未显式定义 models.providers.ollama 条目时，OpenClaw 可以自动发现支持工具调用的模型。

快速开始

安装 Ollama：访问 https://ollama.ai
拉取模型：

ollama pull llama3.3
## 或者
ollama pull qwen2.5-coder:32b
## 或者
ollama pull deepseek-r1:32b

为 OpenClaw 启用 Ollama（任意值均可；Ollama 不需要真实的密钥）：

## 设置环境变量
export OLLAMA_API_KEY="ollama-local"
## 或者在配置文件中配置
openclaw config set models.providers.ollama.apiKey "ollama-local"

使用 Ollama 模型：

{
  agents: {
    defaults: {
      model: { primary: "ollama/llama3.3" },
    },
  },
}

模型发现（隐式提供商）

当你设置了 OLLAMA_API_KEY（或认证配置），且未定义 models.providers.ollama 时，OpenClaw 会从本地 Ollama 实例（http://127.0.0.1:11434）自动发现模型：

调用 /api/tags 和 /api/show 接口
仅保留报告了工具调用能力的模型
当模型报告了思维能力时，标记为推理模型
当可用时，从 model_info["<arch>.context_length"] 读取上下文窗口大小
将最大输出 Token 设置为上下文窗口的 10 倍
将所有成本设置为 0

这避免了手动配置模型条目，同时让目录与 Ollama 的能力保持同步。

查看可用模型：

ollama list
openclaw models list

添加新模型，只需通过 Ollama 拉取即可：

ollama pull mistral

新模型会被自动发现并可以直接使用。

如果你显式设置了 models.providers.ollama，自动发现功能会被跳过，你需要手动定义模型（见下文）。

配置

基础配置（隐式发现）

启用 Ollama 最简单的方式是通过环境变量：

export OLLAMA_API_KEY="ollama-local"

显式配置（手动模型）

在以下场景使用显式配置：

Ollama 运行在其他主机 / 端口上
你想要强制指定特定的上下文窗口或模型列表
你想要包含不支持工具调用的模型

配置示例：

{
  models: {
    providers: {
      ollama: {
        // 使用包含 /v1 的主机，以兼容 OpenAI 的 API
        baseUrl: "http://ollama-host:11434/v1",
        apiKey: "ollama-local",
        api: "openai-completions",
        models: [
          {
            id: "llama3.3",
            name: "Llama 3.3",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 8192,
            maxTokens: 8192 * 10
          }
        ]
      }
    }
  }
}

如果设置了 OLLAMA_API_KEY，你可以省略提供商条目中的 apiKey，OpenClaw 会自动填充它用于可用性检查。

自定义基础 URL（显式配置）

如果 Ollama 运行在不同的主机或端口上（显式配置会禁用自动发现，因此需要手动定义模型）：

{
  models: {
    providers: {
      ollama: {
        apiKey: "ollama-local",
        baseUrl: "http://ollama-host:11434/v1",
      },
    },
  },
}

模型选择

配置完成后，你所有的 Ollama 模型都可以使用：

{
  agents: {
    defaults: {
      model: {
        primary: "ollama/llama3.3",
        fallback: ["ollama/qwen2.5-coder:32b"],
      },
    },
  },
}

高级功能

推理模型

当 Ollama 在 /api/show 中报告了思维能力时，OpenClaw 会将模型标记为支持推理：

ollama pull deepseek-r1:32b

模型成本

Ollama 是免费的本地运行服务，因此所有模型的成本都设置为 $0。

上下文窗口

对于自动发现的模型，OpenClaw 会优先使用 Ollama 报告的上下文窗口，否则默认使用 8192。你可以在显式提供商配置中覆盖 contextWindow 和 maxTokens。

故障排查

Ollama 未被检测到

确保 Ollama 正在运行，且你已设置 OLLAMA_API_KEY（或认证配置），并且你没有显式定义 models.providers.ollama 条目：

ollama serve

同时确保 API 可访问：

curl http://localhost:11434/api/tags

没有可用模型

OpenClaw 仅会自动发现报告了工具调用能力的模型。如果你的模型未列出，你可以：

拉取一个支持工具调用的模型，或者
在 models.providers.ollama 中显式定义该模型。

添加模型的方式：

ollama list  # 查看已安装的模型
ollama pull llama3.3  # 拉取模型

连接被拒绝

检查 Ollama 是否在正确的端口上运行：

## 检查 Ollama 是否正在运行
ps aux | grep ollama
## 或者重启 Ollama
ollama serve