OpenClaw + Ollama 跨机部署踩坑记:从404错误到完美运行的完整指南

当AI助手遇上网络配置，一场跨越两台服务器的调试之旅

引言

在人工智能飞速发展的今天，本地部署大模型已成为许多开发者和技术爱好者的标配。然而，当我们需要将AI能力通过OpenClaw这样的框架暴露给外部服务时，往往会遇到各种网络和配置问题。

本文将详细记录一次从零开始配置OpenClaw远程连接Ollama服务的完整过程，包含所有遇到的技术难题及其解决方案。无论你是AI应用开发者，还是对本地模型部署感兴趣的爱好者，这篇文章都能帮你避开我踩过的坑。

一、问题背景

我的环境是这样的：

• 机器A（Ollama服务端）：Windows系统，IP地址 10.10.10.103，运行Ollama服务，已下载 qwen2.5:7b 和 deepseek-r1:7b 模型

• 机器B（OpenClaw客户端）：Ubuntu系统，IP地址 10.10.10.104，运行OpenClaw网关

目标：让Ubuntu上的OpenClaw能够调用Windows上Ollama的本地模型。

二、遇到的第一个坑：模型名称错误

最初在OpenClaw配置中，我使用了模型名 qwen2.5:7b-32k，结果报错：

text

Ollama API error 404: {"error":"model 'qwen2.5:7b-32k' not found"}

知识点： Ollama的模型标签有特定规范，qwen2.5:7b 本身已经支持32K上下文，不需要添加 -32k 后缀。

正确命令：

bash

# 拉取模型（注意标签格式）ollama pull qwen2.5:7b# 查看已安装模型ollama list

三、网络连通性诊断

3.1 检查服务端监听状态

在Windows上执行：

cmd

# 查看Ollama进程tasklist | findstr ollama# 查看端口监听状态（关键命令）netstat -an | findstr 11434

期望输出：

text

TCP    0.0.0.0:11434          0.0.0.0:0              LISTENING

如果显示 127.0.0.1:11434，说明Ollama只监听本地，需要修改配置。

3.2 设置Ollama监听所有网络接口

Windows环境下设置环境变量：

cmd

# 管理员权限运行setx OLLAMA_HOST 0.0.0.0:11434 /M# 重启Ollamataskkill /F /IM ollama.exetaskkill /F /IM "ollama app.exe"

3.3 防火墙配置

cmd

# 添加防火墙规则netsh advfirewall firewall add rule name="Ollama API" dir=in action=allow protocol=TCP localport=11434

3.4 客户端测试连通性

在Ubuntu上执行：

bash

# 测试API是否可达（最关键的诊断命令）curl http://10.10.10.103:11434/api/tags# 测试模型调用curl-X POST http://10.10.10.103:11434/api/generate \-H"Content-Type: application/json"\-d'{    "model": "qwen2.5:7b",    "prompt": "Hello",    "stream": false  }'

四、OpenClaw配置的陷阱

4.1 配置结构要求

OpenClaw的模型配置要求每个模型必须有 id 字段，否则会报错：

text

models.providers.ollama.models.0.id: Invalid input: expected string, received undefined

错误配置：

json

"models":[{"name":"qwen2.5:7b"}]

正确配置：

json

"models":[{"id":"qwen2.5:7b","name":"qwen2.5:7b"}]

4.2 完整的OpenClaw配置示例

json

{"models":{"providers":{"ollama":{"baseUrl":"http://10.10.10.103:11434","apiKey":"","api":"ollama","models":[{"id":"qwen2.5:7b","name":"qwen2.5:7b"},{"id":"deepseek-r1:7b","name":"deepseek-r1:7b"}]}}},"agents":{"defaults":{"model":{"primary":"ollama/qwen2.5:7b"}}},"gateway":{"mode":"local","port":18789,"bind":"loopback"}}

五、常用诊断命令大全

5.1 服务端诊断

bash

# 查看模型列表ollama list# 查看服务日志journalctl -u ollama -f# Linux# Windows: 查看 %USERPROFILE%\.ollama\logs\server.log# 测试APIcurl http://localhost:11434/api/tags

5.2 网络诊断

bash

# 测试端口连通性nc-zv10.10.10.103 11434# 或使用telnettelnet 10.10.10.103 11434# 追踪路由traceroute10.10.10.103

5.3 OpenClaw诊断

bash

# 全面诊断配置openclaw doctor# 自动修复配置openclaw doctor --fix# 查看可用模型openclaw models list# 查看网关状态openclaw gateway status# 测试聊天openclaw chat --model ollama/qwen2.5:7b# 查看日志tail-f ~/.openclaw/logs/gateway.log

六、配置文件的JSON格式问题

OpenClaw使用JSON5格式（支持注释和尾随逗号），但仍然需要遵循基本语法：

常见错误及修复

1. 多余逗号

json

{"models":{// 正确},}// ❌ 错误：对象结尾多余逗号

1. 未转义的双引号

json

{"text":"He said "hello""// ❌ 错误"text":"He said \"hello\""// ✅ 正确}

1. 验证JSON格式

bash

# 使用Python验证cat config.json | python3 -m json.tool# 使用jq（更友好）jq . config.json

七、完整部署流程总结

步骤1：服务端准备（Windows）

cmd

# 1. 安装Ollama（从官网下载）# 2. 拉取模型ollama pull qwen2.5:7b# 3. 配置外部访问setx OLLAMA_HOST 0.0.0.0:11434 /M# 重启Ollama# 4. 开放防火墙netsh advfirewall firewall add rule name="Ollama" dir=in action=allow protocol=TCP localport=11434

步骤2：客户端配置（Ubuntu）

bash

# 1. 测试连通性curl http://10.10.10.103:11434/api/tags# 2. 配置OpenClawopenclaw configure# 设置Gateway mode: local# 添加Ollama provider: http://10.10.10.103:11434# 3. 验证配置openclaw doctor# 4. 启动网关openclaw gateway start# 5. 测试模型openclaw models listopenclaw chat --model ollama/qwen2.5:7b

八、常见问题速查表

九、最佳实践建议

1. 使用版本控制：将配置文件纳入Git管理

2. 定期备份：配置修改前执行 cp config.json config.json.bak

3. 善用诊断工具：遇到问题先运行 openclaw doctor

4. 分步验证：先确保API连通，再配置OpenClaw

5. 日志是朋友：遇到问题第一时间查看日志

结语

经过一番折腾，OpenClaw终于能够顺利调用远程Ollama服务了。这个过程虽然坎坷，但让我深入理解了网络配置、API规范、JSON格式等基础知识。

AI应用开发不仅仅是调用API那么简单，基础设施的搭建同样重要。希望这篇文章能帮助你在遇到类似问题时少走弯路，快速找到解决方案。

最后送给大家一个万能命令：

bash

openclaw doctor --fix# 解决80%的配置问题

如果你在配置过程中遇到其他问题，欢迎在评论区留言交流！