openclaw连接本机ollama服务是为了让本地大模型直接为ai代理提供推理能力,避免调用远程api带来的延迟、费用和数据外泄风险;关键在于确保ollama监听默认端口11434并正常响应,再将openclaw配置中的base_url设为http://localhost:11434(非容器)或http://host.docker.internal:11434(docker容器内),且model字段须与ollama list输出完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw连接本机Ollama服务,是为了让本地大模型直接为AI代理提供推理能力,避免调用远程API带来的延迟、费用和数据外泄风险。你不需要公网暴露Ollama端口,也不必改模型权重文件,关键在于打通容器网络与服务地址映射。
确认Ollama服务已在本机运行并监听默认端口
打开终端执行:ollama serve 或 sudo systemctl start ollama,确保服务已启动。
验证是否正常响应:curl http://localhost:11434/api/tags。如果返回JSON列表(含models字段),说明Ollama正在监听127.0.0.1:11434——这是后续配置的基准地址。
【注意:若修改过Ollama监听地址(如绑定到0.0.0.0或非11434端口),必须同步更新OpenClaw配置中的URL,否则连接立即失败】
配置OpenClaw指向本地Ollama实例
进入OpenClaw项目根目录,编辑config.yaml或.env(依实际部署方式而定)。
找到LLM相关配置段,将base_url设为http://host.docker.internal:11434(Docker容器内访问宿主机服务的标准写法)。
若OpenClaw以非容器方式运行(如直接Node.js启动),则base_url应填http://localhost:11434。
设置model字段为已拉取的本地模型名,例如deepseek-r1:14b——名称必须与ollama list输出完全一致,包括冒号和版本标签。
启动OpenClaw并验证连通性
方法一:Docker Compose方式
确保docker-compose.yml中OpenClaw服务声明了网络依赖:network_mode: "host" 或显式添加 --add-host host.docker.internal:host-gateway。
运行:docker compose up -d → 等待容器就绪 → 查看日志:docker logs openclaw-app 2>&1 | grep "ollama"。
方法二:本地Node.js直启
执行:npm run dev → 观察控制台输出是否有✅ Connected to Ollama at http://localhost:11434字样。
若出现connect ECONNREFUSED 127.0.0.1:11434,说明Ollama未运行或端口被占用;若提示model not found,检查ollama list输出与配置中model字段是否逐字符匹配。










