base url必须严格填写为http://localhost:11434/v1,结尾/v1不可省略,否则触发404错误;需确保ollama服务已启动并监听该端口,通过浏览器访问http://localhost:11434验证返回“ollama is running”,且模型已通过ollama list确认可用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw接入Ollama时,Base URL必须指向Ollama的API服务端点,填错会导致连接失败、模型无法加载或直接报404/Connection refused错误;这个地址不是Ollama官网链接,也不是模型下载页,而是本地运行的服务接口。
Ollama服务必须先启动并监听默认端口
打开终端,执行ollama serve。如果已设为系统服务,运行sudo systemctl start ollama确保服务处于active状态。
验证服务是否就绪:在浏览器访问 http://localhost:11434,页面应显示“Ollama is running”。若打不开,说明服务未启动或端口被占用——【端口被占用会导致Base URL配置后始终连不上】。
Base URL固定为 http://localhost:11434/v1
在OpenClaw设置界面中,找到“API Provider”选项,选择“OpenAI”协议(Ollama兼容OpenAI API格式)。
在“Base URL”输入框中,**严格填写**:http://localhost:11434/v1。注意结尾必须带/v1,少一个斜杠就会触发404错误。
完整的工作区安全套件:检测未授权修改,扫描提示注入模式,自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
不要加任何路径参数,不要用https,不要替换localhost为127.0.0.1(部分Ollama版本对IPv4地址解析不稳定)。
确认模型已存在且ID正确
执行ollama list,确保至少有一个模型显示为status: available。例如:qwen2.5-coder:7b。
在OpenClaw的Model Name字段中,填入ollama或具体模型名(如qwen2.5-coder:7b),取决于OpenClaw版本对模型路由的支持方式。
API Key可任意填写(如ollama或123),Ollama本身不校验该值——但留空可能触发OpenClaw客户端校验失败。









