讲师中心 微信公众号
AI工具推荐 视频效率加速

OpenClaw本地模型Base URL怎么配置?

夏明君_5642

夏明君_5642

发布时间:2026-07-30 13:17:25

|

318人浏览过

|

来源于php中文网

原创

必须正确填写Base URL为http://localhost:8000/v1(末尾含/v1且无多余斜杠),并确保本地模型服务已启用OpenAI兼容接口且监听0.0.0.0,否则OpenClaw将超时或返回404导致Agent无法启动。

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

openclaw本地模型base url怎么配置?

要在OpenClaw中成功调用本地运行的大语言模型,必须正确填写Base URL,否则请求会直接超时或返回404错误,整个Agent流程无法启动。

确认本地模型服务已暴露OpenAI兼容接口

OpenClaw只接受符合OpenAI REST API规范的后端。先验证你的本地模型服务是否已启用/v1路径:在浏览器或curl中访问 http://localhost:8000/v1/models。如果返回JSON格式的模型列表(含"object": "list"),说明服务就绪;若显示“Cannot GET /v1/models”或连接被拒绝,需回退检查vLLM、SGLang或Ollama是否已开启OpenAI兼容模式并监听0.0.0.0。

这一步不能跳过——OpenClaw不会自动探测端口或协议,它严格依赖你填入的URL发起POST请求。

在OpenClaw配置文件中设置Base URL

打开OpenClaw项目根目录下的 config.yaml(或 config.toml,取决于你使用的版本分支)。

定位到 llm: 区块,在其下添加或修改 base_url 字段:

Pkuhb Openclaw Skill
Pkuhb Openclaw Skill

提供OpenClaw平台入门指南,含产品定位、技术架构、部署配置、Skills开发与安全实践。

下载

llm:
  model: "deepreinforce-ai/Ornith-1.0-35B"
  base_url: "http://localhost:8000/v1"
  api_key: "EMPTY"

【base_url末尾必须包含/v1,且不能有多余斜杠如/v1/】。错写成 http://localhost:8000 或 http://localhost:8000/v1/ 都会导致OpenClaw构造出错误的请求路径,例如 POST /v1//chat/completions,从而触发404。

针对Docker容器内运行OpenClaw的特殊处理

方法一:使用host.docker.internal(推荐)
如果你的本地模型服务运行在宿主机上,而OpenClaw运行在Docker容器中,不能填localhost。此时需将base_url改为:
base_url: "http://host.docker.internal:8000/v1"
Docker会自动将该域名解析为宿主机网关IP,这是跨容器通信最稳定的方式。

方法二:改用宿主机真实IP
在Linux/macOS执行 ip route | grep default | awk '{print $3}' 获取宿主机IP(如172.17.0.1),然后填入:
base_url: "http://172.17.0.1:8000/v1"

注意:Windows Docker Desktop用户也支持host.docker.internal,但旧版WSL2可能存在DNS缓存问题,首次失败可尝试重启Docker Desktop。

验证配置是否生效

第一步:保存config.yaml后,重启OpenClaw服务进程(或重新运行python main.py)。

第二步:观察控制台日志。成功加载配置后会出现类似提示:
[INFO] LLM client initialized with base_url=http://localhost:8000/v1, model=Ornith-1.0-35B

第三步:向OpenClaw提交一个简单指令,例如“输出hello”。如果右侧响应区返回文本而非报错(如“Connection refused”或“Invalid URL”),说明Base URL已正确打通。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

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

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

140

2026.03.19

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

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

201

2026.03.19

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

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

161

2026.03.19

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

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

938

2026.03.20

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

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

149

2026.03.20

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

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

448

2026.03.20

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

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

1062

2026.05.06

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

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

139

2026.06.29

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn