需配置OLLAMA_API_KEY环境变量、确保Ollama服务运行并暴露11434端口、拉取支持tools的模型（如qwen3:8b）、清除OpenClaw中冗余Ollama配置以启用自动发现，并通过onboard向导或ollama launch openclaw命令完成绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在本地运行OpenClaw并接入Ollama托管的大模型，但无法识别或调用本地模型，则可能是由于API密钥未配置、服务端口未暴露、模型缺少tools能力或自动发现机制被禁用。以下是解决此问题的步骤：
一、验证Ollama服务状态与模型可用性
确保Ollama服务正在监听默认端口11434，并已下载具备tools能力的模型（如qwen3:8b、qwen2.5-coder:32b），否则OpenClaw将无法自动发现该模型。
1、以管理员权限打开PowerShell或CMD，执行命令检查Ollama是否运行：curl http://localhost:11434/api/tags
2、若返回JSON格式的模型列表（含name、modified_at、details.tools字段为true），说明服务正常且模型支持工具调用；若报错“Connection refused”，请先运行ollama serve
3、确认所选模型已明确支持tools：访问Ollama官网Models页面，点击左侧“Tools”筛选标签，仅从此列表中选择并拉取模型，例如：ollama pull qwen3:8b
二、配置OLLAMA_API_KEY环境变量
OpenClaw通过环境变量OLLAMA_API_KEY识别本地Ollama实例，该值可为任意非空字符串，但不能为空，否则自动发现逻辑将跳过Ollama提供者。
1、在Windows中，按Win+R输入“sysdm.cpl”，切换至“高级”选项卡，点击“环境变量”
2、在“系统变量”区域点击“新建”，输入变量名：OLLAMA_API_KEY，变量值：ollama-local
3、重启所有终端和PowerShell窗口，执行命令验证：echo $env:OLLAMA_API_KEY，应输出ollama-local
三、禁用显式Ollama配置以启用自动发现
若已在OpenClaw中手动设置过Ollama完整配置（含baseUrl、models等字段），则自动发现功能会被关闭，导致本地模型不显示。必须清除冗余字段，仅保留apiKey。
1、执行命令查看当前Ollama配置：openclaw config get models.providers.ollama
2、若输出中包含baseUrl、models、maxTokens等字段，说明自动发现已被覆盖
3、执行命令重置为最小化配置：openclaw config set models.providers.ollama.apiKey "ollama-local"
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...
4、再次运行上一步命令，确认输出仅为：apiKey: "ollama-local"
四、运行OpenClaw初始化向导并选择Ollama模型
OpenClaw onboard命令会主动探测本地Ollama服务，并在模型选择阶段列出所有tools-enabled模型。若首次未出现Ollama选项，需多次跳过再重试，或卸载重装以刷新插件缓存。
1、在终端中执行：openclaw onboard --install-daemon
2、当出现Model/auth provider选项时，若未见Ollama条目，先选择Skip for now
3、进入下一屏后，再次返回该选项——此时Ollama通常已动态加载，选择它
4、在Ollama配置页中，Base URL填写本机IPv4地址（如192.168.1.100）加端口11434，或直接使用http://127.0.0.1:11434，Mode选择Cloud+Local
5、回车后等待几秒，模型列表将刷新，从中选择已拉取的tools模型（如qwen3:8b），按回车确认
五、通过ollama launch openclaw命令直连
绕过图形化向导，使用Ollama原生命令直接注册OpenClaw为客户端，适用于向导失败或配置冲突场景，该方式强制触发模型绑定流程。
1、确保Ollama服务正在运行，且已拉取目标模型
2、执行命令启动集成：ollama launch openclaw
3、终端将提示选择模型，使用方向键高亮已安装的tools模型（如qwen2.5-coder:32b），按回车
4、成功后终端显示Web UI地址（如http://127.0.0.1:18789），浏览器打开即可使用本地模型
