openclaw不原生支持本地模型,需通过配置config.toml对接ollama等本地llm服务:修改[llm]区块的base_url和model字段,确保地址可达、模型名精确匹配,api_key留空,重启服务后日志显示模型名即生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让OpenClaw识别并加载新版本的本地模型,而不是继续使用旧配置中指向的已失效或过时的模型路径。
确认OpenClaw是否实际支持本地模型配置
OpenClaw本身【不原生支持本地模型】,它是一个面向Web端自动化测试与交互的开源Agent框架,核心依赖外部LLM API服务。所谓“本地模型配置”实为对接Ollama、vLLM或本地API服务(如FastChat)的中间层配置,本质是修改其LLM调用入口。
修改config.toml中的LLM服务地址与模型名
打开项目根目录下的config.toml文件,定位到[llm]区块:
将base_url改为本地服务监听地址,例如Ollama默认为http://host.docker.internal:11434/v1;若容器内访问宿主机Ollama,请确保Docker网络配置正确,host.docker.internal能解析成功。
把model字段更新为Ollama中实际存在的模型标签,比如ollama/qwen2.5-coder:7b——注意必须与ollama list输出完全一致,大小写和冒号后版本号都不能错。
【api_key字段可留空】,Ollama等本地服务通常无需密钥,但若填了非空值,OpenClaw仍会携带该header发送请求,可能导致401错误。
验证本地模型服务是否就绪
在终端执行:curl http://localhost:11434/api/tags(假设Ollama运行在宿主机11434端口),确认返回包含目标模型的JSON列表。
若使用Docker部署OpenClaw,且Ollama在宿主机运行,则容器内需通过host.docker.internal访问,不能用localhost——否则连接被拒绝。
这一步失败会导致OpenClaw启动时卡在“Waiting for LLM…”状态,无报错日志但任务无法提交。
重启OpenClaw服务使配置生效
方法一:若以docker run方式启动,先docker stop openclaw-app,再重新运行完整命令,确保挂载的config.toml是最新版。
方法二:若通过poetry run openclaw --config config.toml启动,直接终止进程后重执行即可。
启动后观察控制台日志,出现LLM initialized with model 'ollama/qwen2.5-coder:7b'字样即表示配置已加载成功。










