配置 OpenClaw 使用 Ollama 本地模型

本文介绍了如何配置OpenClaw使用Ollama服务的Qwen3-VL 2B模型。首先需确保Ollama服务运行且模型已下载，然后编辑配置文件指定模型提供商和默认模型。配置包含设置API地址、模型参数（如contextWindow和maxTokens）等细节。修改完成后需重启网关服务，最后可通过TUI界面测试对话功能。注意事项包括确保服务地址匹配、模型ID正确等。配置文件示例展示了完整的参数设置

穆友航

8637人浏览 · 2026-02-05 20:27:59

穆友航 · 2026-02-05 20:27:59 发布

前提条件
确保已安装并运行 Ollama 服务，且模型 qwen3-vl:2b 已下载。
配置步骤
修改 OpenClaw 配置文件，指定 Ollama 作为模型提供商并设置默认模型。
验证配置
通过 TUI 界面进行对话测试，确认模型正常工作。
高级配置
可根据需要添加更多模型或调整参数如 contextWindow 和 maxTokens。
注意事项
- 确保 Ollama 服务地址与配置中的 baseUrl 一致。
- 模型 ID 必须与 Ollama 中的模型名称匹配。
- 若模型支持多模态，可在 input 字段中添加 "image" 等类型。

编辑 ~/.openclaw/openclaw.json 文件，添加或修改以下配置内容：

{
  "agents": {
    "defaults": {
      "models": {"ollama":{}},
      "model": {"primary": "ollama/qwen3-vl:2b"}
    }
  },
  "models": {
    "providers": {
      "ollama":{
        "baseUrl": "http://127.0.0.1:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-vl:2b",
            "name": "Qwen3 VL 2B",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}