【05】OpenClaw 连接 Ollama:让本地 AI 助手跑起来

OpenClaw 连接 Ollama：让本地 AI 助手跑起来

详解 OpenClaw 与 Ollama 的完整配置流程

前言

前三章我们分别完成了：

• 环境准备

• OpenClaw 安装

• Ollama 模型部署

现在终于到了关键时刻：让 OpenClaw 连接 Ollama，让本地 AI 助手真正跑起来！

本章将讲解：

• 配置文件详解

• Ollama 连接设置

• 上下文窗口修复（重点！）

• 多种模型配置

• 完整配置示例

配置文件位置

OpenClaw 的配置信息存储在用户目录下：

C:\Users\<你的用户名>\.openclaw\

关键文件

文件	作用

openclaw.json	主配置文件
agents/main/agent/models.json	模型配置文件
logs/	日志目录

配置文件详解

openclaw.json 结构

{
“models”: {
“mode”: “merge”,
“providers”: {
“custom-127-0-0-1-11434”: {
“baseUrl”: “http://127.0.0.1:11434/v1”,
“apiKey”: “ollama”,
“api”: “openai-completions”,
“models”: []
}
}
},
“agents”: {
“defaults”: {
“model”: {
“primary”: “custom-127-0-0-1-11434/qwen2.5-7b-32k”
},
“workspace”: “C:\\Users\\用户名\\clawd”
}
},
“gateway”: {
“port”: 18789,
“mode”: “local”,
“bind”: “loopback”
}
}

核心配置项说明

1. baseUrl – API 地址

“baseUrl”: “http://127.0.0.1:11434/v1”

说明：

• 127.0.0.1 是本地地址

• 11434 是 Ollama 默认端口

• /v1 是 OpenAI 兼容 API 路径

2. apiKey – 认证密钥

“apiKey”: “ollama”

说明：Ollama 本地运行不需要真实密钥，随便填一个字符串即可。

3. api – API 类型

“api”: “openai-completions”

可选值：

值	说明

openai-completions	OpenAI 兼容（推荐）
anthropic	Anthropic API
google	Google API

关键：上下文窗口配置

为什么必须修改？

这是最容易踩的坑！

配置项	Ollama 默认值	OpenClaw 要求

上下文窗口	4096 tokens	≥ 16000 tokens
最大输出	4096 tokens	≥ 8192 tokens

如果不修改，会出现以下错误：

Error: Model context window too small (4096 tokens)
Minimum required: 16000 tokens

解决方案：创建扩展上下文模型

第一步：创建 Modelfile

在 C:\Users\<用户名>\ 目录下创建文件 Modelfile：

# PowerShell 命令
@”
FROM qwen2.5:7b
PARAMETER num_ctx 32768
“@ | Out-File -FilePath “$env:USERPROFILE\Modelfile” -Encoding ascii

第二步：验证文件内容

Get-Content “$env:USERPROFILE\Modelfile”

应该显示：

FROM qwen2.5:7b
PARAMETER num_ctx 32768

第三步：创建新模型

ollama create qwen2.5-7b-32k -f “$env:USERPROFILE\Modelfile”

第四步：验证创建成功

ollama list

应该看到 qwen2.5-7b-32k：

NAME SIZE MODIFIED
qwen2.5:7b 4.7GB 2 hours ago
qwen2.5-7b-32k 4.7GB 5 minutes ago

更新 OpenClaw 配置

修改 openclaw.json

找到配置文件 C:\Users\<用户名>\.openclaw\openclaw.json，修改以下内容：

{
“models”: {
“providers”: {
“custom-127-0-0-1-11434”: {
“models”: [
{
“id”: “qwen2.5-7b-32k”,
“name”: “Qwen2.5 7B 32K (本地)”,
“reasoning”: false,
“input”: [“text”],
“cost”: {
“input”: 0,
“output”: 0,
“cacheRead”: 0,
“cacheWrite”: 0
},
“contextWindow”: 32768,
“maxTokens”: 8192
}
]
}
}
}
}

修改 agents 配置

同时修改 agents 部分：

{
“agents”: {
“defaults”: {
“model”: {
“primary”: “custom-127-0-0-1-11434/qwen2.5-7b-32k”
}
}
}
}

完整配置示例

基础配置（单模型）

{
“models”: {
“mode”: “merge”,
“providers”: {
“custom-127-0-0-1-11434”: {
“baseUrl”: “http://127.0.0.1:11434/v1”,
“apiKey”: “ollama”,
“api”: “openai-completions”,
“models”: [
{
“id”: “qwen2.5-7b-32k”,
“name”: “Qwen2.5 7B (本地)”,
“contextWindow”: 32768,
“maxTokens”: 8192,
“cost”: {
“input”: 0,
“output”: 0
}
}
]
}
}
},
“agents”: {
“defaults”: {
“model”: {
“primary”: “custom-127-0-0-1-11434/qwen2.5-7b-32k”
}
}
}
}

多模型配置

{
“models”: {
“mode”: “merge”,
“providers”: {
“custom-127-0-0-1-11434”: {
“baseUrl”: “http://127.0.0.1:11434/v1”,
“apiKey”: “ollama”,
“api”: “openai-completions”,
“models”: [
{
“id”: “qwen2.5-7b-32k”,
“name”: “Qwen2.5 7B (日常对话)”,
“contextWindow”: 32768,
“maxTokens”: 8192,
“reasoning”: false
},
{
“id”: “qwen2.5-coder-32k”,
“name”: “Qwen2.5 Coder (代码)”,
“contextWindow”: 32768,
“maxTokens”: 8192,
“reasoning”: false
},
{
“id”: “deepseek-r1-32k”,
“name”: “DeepSeek R1 (推理)”,
“contextWindow”: 32768,
“maxTokens”: 8192,
“reasoning”: true
}
]
}
}
}
}

启动与验证

重启 OpenClaw Gateway

# 先停止之前的运行
Ctrl + C

# 重新启动
openclaw gateway

检查启动日志

正常启动日志应该显示：

Gateway started successfully
Agent model configured: custom-127-0-0-1-11434/qwen2.5-7b-32k
Listening on ws://127.0.0.1:18789

打开 Dashboard 验证

openclaw dashboard

浏览器应该打开并显示 OpenClaw 界面。

常见问题排查

问题 1：连接被拒绝

错误信息：

Connection refused: http://127.0.0.1:11434

检查步骤：

# 1. 检查 Ollama 是否运行
ollama list

# 2. 检查 Ollama 服务
curl http://localhost:11434

# 3. 重启 Ollama
ollama serve

问题 2：认证失败

错误信息：

Authentication failed

解决方案：

检查 apiKey 配置，确保不是空的：

“apiKey”: “ollama”

问题 3：模型上下文太小

错误信息：

Model context window too small (4096 tokens)

解决方案：

按照本章”上下文窗口配置”部分，创建一个扩展上下文的新模型。

问题 4：模型未找到

错误信息：

Model not found: qwen2.5:7b

解决方案：

# 1. 查看已下载模型
ollama list

# 2. 下载模型
ollama pull qwen2.5:7b

测试对话

配置成功后，可以在 Dashboard 中测试对话：

用户：你好，请介绍一下你自己
AI：你好！我是基于 Qwen2.5 7B 模型运行的本地 AI 助手。
我在你的电脑上运行，所有对话数据都是本地处理的。
我可以帮助你完成各种任务，包括：
– 回答问题
– 编写代码
– 分析文档
– 等等…

配置管理命令

查看当前配置

# 查看完整配置
openclaw config get

# 查看特定配置
openclaw config get models
openclaw config get agents.defaults.model

修改配置

# 修改默认模型
openclaw config set agents.defaults.model.primary “custom-127-0-0-1-11434/qwen2.5-7b-32k”

重置配置

# 重新初始化
openclaw onboard

总结

本章我们完成了：

• 理解 OpenClaw 配置文件结构

• 配置 Ollama 连接参数

• 修复上下文窗口问题（重要！）

• 配置多个本地模型

• 验证连接成功

下一章预告：多模型配置与管理 – 同时绑定多个 AI 大脑

关注公众号：跟着鹏鹏学技术

下一篇预告：多模型配置与管理详解