OpenClaw本地部署怎么使用本地模型?

冰火之心

冰火之心

2026-07-30

423人浏览

原创

必须先启动本地模型服务再启动openclaw容器;通过环境变量或挂载config.yaml配置llm_provider、llm_model和llm_base_url,使用host.docker.internal访问宿主机服务,最后在web界面验证模型响应。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

openclaw本地部署怎么使用本地模型?

让OpenClaw本地部署真正用上你自己的大模型,而不是依赖远程API或默认空配置,必须绕过官方默认的云端模型路由,手动注入本地模型服务地址和认证参数。

确认本地模型服务已就绪

先确保Ollama、vLLM或Text Generation Inference等本地模型服务已在本机运行,并监听http://localhost:11434(Ollama)或http://localhost:8080(vLLM)等可访问端口。用curl http://localhost:11434/api/tags能返回模型列表才算通过验证。

如果返回Connection refused或超时,说明服务没起来,OpenClaw后续无法连接——【必须先启动本地模型服务,再启动OpenClaw容器】

修改OpenClaw启动命令,注入本地模型地址

原始启动命令默认走OpenAI兼容接口且无模型配置,需强制覆盖环境变量:

方法一:直接指定Ollama模型(推荐新手)
docker run命令中加入:
-e LLM_PROVIDER=ollama-e LLM_MODEL=deepseek-r1:14b-e LLM_BASE_URL=http://host.docker.internal:11434/v1

注意:这里用host.docker.internal而非localhost,因为Docker容器内localhost指向自身,无法访问宿主机服务。

方法二:对接vLLM或TGI服务
替换为:
-e LLM_PROVIDER=openai-e LLM_MODEL=Qwen2.5-7B-Instruct-e LLM_BASE_URL=http://host.docker.internal:8080/v1-e LLM_API_KEY=dummy

vLLM/TGI默认不校验key,填dummy即可;若启用auth,需同步配置对应密钥。

DeepSeek
DeepSeek

DeepSeek是一款由深度求索公司开发的免费AI助手,支持Web端和移动端使用。它拥有强大的自然语言处理能力,可进行文本对话、内容创作、代码编写、文件处理(支持图像、PDF、Word、Excel、PPT等格式)以及联网搜索。DeepSeek上下文长度达1M tokens,能一次性处理海量信息(如《三体》三部曲)。其核心优势在于完全免费、响应迅速、支持语音输入,并提供API服务,适合学习、办公和开发等多种场景。

下载

挂载配置文件实现持久化设置

第一步:创建本地配置目录
mkdir -p ~/.openclaw/config

第二步:生成config.yaml并写入模型参数
用文本编辑器新建~/.openclaw/config/config.yaml,内容如下:

llm:
  provider: ollama
  model: deepseek-r1:14b
  base_url: http://host.docker.internal:11434/v1

第三步:启动时挂载该配置
docker run命令末尾添加:
-v ~/.openclaw/config:/app/config

这比硬编码环境变量更稳定,重启容器后配置不会丢失。

验证本地模型是否生效

容器启动成功后,打开浏览器访问http://localhost:3000,进入设置页(齿轮图标)→ 查看“LLM Provider”是否显示为ollamaopenai,模型名是否与你指定的一致。

输入测试提示词:“输出‘Hello from local model!’”,若响应内容由你本地加载的模型生成(非报错或超时),说明已成功接管。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
OpenClaw如何卸载
OpenClaw如何卸载

《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安

2026.03.19

60

11

OpenClaw安装部署教程
OpenClaw安装部署教程

本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!

2026.03.19

81

11

OpenClaw初学者教程:如何使用和设置
OpenClaw初学者教程:如何使用和设置

《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。

2026.03.19

41

13

OpenClawAI技能系统基础介绍:OpenClawAISkills是什么
OpenClawAI技能系统基础介绍:OpenClawAISkills是什么

OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。

2026.03.20

297

20

龙虾OpenClaw安全使用指南
龙虾OpenClaw安全使用指南

围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。

2026.03.20

87

11

openclaw养虾硬件指南最新版
openclaw养虾硬件指南最新版

《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。

2026.03.20

243

28

OpenClaw从新手到中级完整教程
OpenClaw从新手到中级完整教程

本专题专为零基础用户设计,带你从环境搭建到实战应用,系统掌握开源AI Agent OpenClaw。内容涵盖Node.js/Docker安装、API配置、Skills技能扩展及多平台集成,通过整理文件、自动化办公等真实案例,助你快速上手。无论你是想提升效率的职场人还是技术爱好者,都能在此找到从入门到精通的完整路径,打造专属的本地化AI助手。

2026.05.06

160

32

OpenClaw免费大模型调用指南
OpenClaw免费大模型调用指南

PHP中文网特设OpenClaw免费大模型专区,提供详尽调用指南。涵盖免费API申请、模型配置及本地部署教程,助您零成本畅享AI智能体验。无论是新手入门还是进阶应用,这里都有实用干货,轻松跨越创作门槛,开启高效智能办公新方式。

2026.06.29

33

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程