1. 项目概述
OpenClaw 是一个开源的 AI 应用框架,它允许开发者灵活地集成各种大语言模型(LLM)。本文将详细介绍如何配置 OpenClaw 使用 Ollama 本地运行的 Qwen3-VL 2B 模型。这种本地部署方案特别适合对数据隐私有严格要求的企业或个人开发者,也适合在没有稳定互联网连接的环境下使用大模型能力。
提示:Ollama 是一个本地化的大模型运行环境,支持在个人电脑或服务器上部署和运行各种开源模型,避免了云服务可能带来的隐私泄露风险。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 安装 Ollama 服务
在开始配置前,需要确保 Ollama 服务已正确安装并运行。Ollama 支持 Windows、macOS 和 Linux 系统,安装方法如下:
- Windows/macOS:从 Ollama 官网下载安装包,双击运行安装程序
- Linux:使用以下命令安装:
bash复制
curl -fsSL https://ollama.com/install.sh | sh
安装完成后,启动 Ollama 服务:
bash复制ollama serve
2.2 下载 Qwen3-VL 2B 模型
Qwen3-VL 2B 是阿里云开源的多模态大模型,支持文本和图像理解。使用以下命令下载模型:
bash复制ollama pull qwen3-vl:2b
下载完成后,可以通过以下命令验证模型是否可用:
bash复制ollama list
应该能看到 qwen3-vl:2b 出现在模型列表中。
3. OpenClaw 配置详解
3.1 配置文件结构
OpenClaw 的配置文件位于 ~/.openclaw/openclaw.json,采用 JSON 格式。我们需要修改两个主要部分:
- agents.defaults:设置默认使用的模型提供商和模型
- models.providers:定义模型提供商的详细配置
3.2 基础配置
以下是完整的配置示例,我们将逐项解析关键参数:
json复制{
"agents": {
"defaults": {
"m
