OpenClawAI需正确配置Ollama网络暴露、API地址及模型信息方可调用本地推理服务；具体包括启用Ollama网络访问、修改openclaw.json添加Ollama provider、支持命令行参数覆盖、Web UI切换模型及跨主机防火墙校准。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装OpenClawAI并希望将其与本地Ollama模型对接，但无法成功调用推理服务，则可能是由于API地址配置错误、网络暴露未开启或模型未就绪所致。以下是实现OpenClawAI与Ollama生态整合的多种可行方法：
一、启用Ollama网络服务并验证模型可用性
OpenClawAI需通过HTTP请求访问Ollama提供的OpenAI兼容API端点，而默认情况下Ollama仅监听本地回环地址（127.0.0.1），外部应用无法连接。必须显式开启网络暴露功能，并确认目标模型已下载且服务运行正常。
1、启动Ollama服务（若尚未运行）：
在终端中执行 ollama serve 或直接运行Ollama桌面应用。
2、打开Ollama设置界面：点击左上角图标展开菜单，选择 Settings。
3、启用网络访问权限：找到选项 Expose Ollama to the network 并将其开关置为开启状态。
4、验证API可达性：在OpenClaw所在机器上执行命令 curl http://<ollama-host-ip>:11434/v1/models（将<ollama-host-ip>替换为Ollama实际所在机器的局域网IP），返回JSON列表即表示服务已就绪。
二、修改OpenClaw配置文件接入Ollama Provider
OpenClaw通过~/.openclaw/openclaw.json定义模型提供方（provider）及其模型列表，需手动编辑该文件以声明Ollama为可用后端，并指定其基础URL、认证密钥及支持的模型ID。
1、使用文本编辑器打开配置文件：
nano ~/.openclaw/openclaw.json（Linux/macOS）或使用记事本打开对应路径（Windows）。
2、定位到 models.providers 区域，在其中添加 ollama 对象，确保包含 baseUrl（格式为 http://<ip>:11434/v1）、apiKey（任意非空字符串，如 ollama-local）和 api 字段（值为 openai-completions）。
3、在 models.providers.ollama.models 数组中，至少添加一个已下载的模型条目，例如：
{"id":"qwen3:30b","name":"Qwen3 30B","reasoning":true,"contextWindow":32768}。
4、保存文件并重启OpenClaw服务，使新配置生效。
三、使用命令行参数动态指定Ollama服务地址
对于临时测试或CI/CD环境，可绕过配置文件修改，直接通过启动参数注入Ollama连接信息，避免持久化配置变更带来的干扰。
1、停止当前运行的OpenClaw实例（如有）：
openclaw stop。
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
2、使用环境变量覆盖默认provider配置：
OLLAMA_BASE_URL=http://192.168.1.100:11434/v1 OLLAMA_API_KEY=ollama-local openclaw start（将IP替换为实际Ollama主机地址）。
3、确认OpenClaw日志中出现类似 Connected to provider 'ollama' at http://192.168.1.100:11434/v1 的提示信息。
四、在Web UI中切换至Ollama模型并发起推理请求
完成上述任一配置后，OpenClaw Dashboard将识别Ollama模型为可用选项，用户可在交互界面中主动选择该模型执行对话或任务指令，系统会自动路由请求至本地Ollama服务。
1、通过浏览器访问OpenClaw Web UI地址（如 http://localhost:3000）。
2、进入 Settings → Model Provider 页面，下拉选择已配置的 ollama/qwen3:30b 或其他Ollama模型。
3、返回聊天界面，在输入框中键入任意自然语言指令（如 解释量子纠缠的基本原理）。
4、观察响应内容是否由本地Ollama模型生成，并检查浏览器开发者工具Network标签页中请求目标是否为 /v1/chat/completions 且域名指向Ollama主机IP。
五、跨主机部署时校准网络连通性与防火墙策略
当OpenClaw与Ollama分属不同物理设备时，除软件配置外，还需确保局域网层通信畅通，包括IP可达性、端口开放及无中间防火墙拦截。
1、在OpenClaw所在机器上执行 ping <ollama-host-ip>，确认基础ICMP连通。
2、执行端口探测命令：
nc -zv <ollama-host-ip> 11434（Linux/macOS）或 Test-NetConnection <ollama-host-ip> -Port 11434（PowerShell）。
3、若连接被拒，在Ollama主机上检查防火墙规则：
Ubuntu执行 sudo ufw status，确认11434端口处于allow状态；Windows需在“高级安全Windows Defender防火墙”中新增入站规则，放行TCP 11434端口。
4、再次运行curl验证命令，直至返回模型列表为止。
