需将openclaw与本地ollama对接以实现离线隐私可控的大模型运行,方法包括:一、向导式配置(openclaw onboard);二、命令行逐项配置(openclaw config set);三、手动修改config.yaml;四、验证连接状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在本地环境中运行大语言模型,并确保所有数据处理完全离线、隐私可控,则需将 OpenClaw 与本地 Ollama 服务正确对接。以下是实现该目标的多种配置方法:
一、向导式配置(推荐新手)
此方式通过交互式命令行引导完成全部参数设置,避免手动编辑配置文件出错,适合首次部署用户。
1、在终端或 PowerShell 中执行初始化命令:openclaw onboard。
2、根据提示选择 Ollama 作为模型提供方(Provider)。
3、在服务地址栏输入本地 Ollama 默认接口:http://localhost:11434。
4、从已下载模型列表中选择一个支持工具调用的本地模型,例如:qwen2.5:7b。
5、API Key 字段可填入任意非空字符串,如:ollama-local。
6、最后选择 Local 模式 完成配置并自动重启服务。
二、命令行逐项配置
该方式适用于需要脚本化部署或批量配置的场景,所有参数通过 openclaw config set 命令直接写入配置系统。
1、设置 Ollama API 密钥(仅作身份标识,无需真实密钥):openclaw config set models.providers.ollama.apiKey "ollama-local"。
2、指定 Ollama 服务基础地址:openclaw config set models.providers.ollama.baseUrl "http://localhost:11434"。
3、设定默认使用的模型标识符:openclaw config set models.default "ollama/qwen2.5:7b"。
4、执行重启命令使配置生效:openclaw restart。
三、手动修改 YAML 配置文件
此方式提供最高自由度,允许精确控制模型元信息、温度、最大输出长度等高级参数,适用于进阶用户。
1、定位配置文件路径:macOS/Linux 用户打开 ~/.openclaw/config.yaml;Windows 用户打开 C:\Users\用户名\.openclaw\config.yaml。
2、在文件中插入以下结构化配置块(注意缩进为两个空格):
models:
此技能为 OpenClaw 安装并配置 Tablestore Mem0 插件。Tablestore Mem0使用阿里云表格存储作为向量存储后端。
default: ollama/qwen2.5:7b
providers:
ollama:
baseUrl: "http://localhost:11434"
apiKey: "ollama-local"
api: "ollama"
models:
- id: "qwen2.5:7b"
name: "Qwen2.5 7B"
max_tokens: 32768
temperature: 0.7
3、保存文件后,在终端执行:openclaw restart。
四、验证本地模型连接状态
配置完成后必须确认 OpenClaw 能成功调用 Ollama 托管的模型,避免因地址错误或模型未加载导致后续技能失效。
1、确保 Ollama 服务正在运行:ollama serve(若已开机自启可跳过)。
2、检查本地已加载模型:ollama list,确认目标模型如 qwen2.5:7b 显示在列表中。
3、在 OpenClaw 启动日志中查找关键词:"Connected to Ollama provider" 和 "Loaded model: qwen2.5:7b"。
4、发起一次测试对话,观察是否返回流式响应且无网络请求痕迹(如无 HTTP 请求日志、无远程域名解析行为)。









