跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
编程语言AI算法

OpenClaw 集成本地 llama.cpp 后端配置指南

如何在 OpenClaw 中配置本地 llama.cpp 作为后端。主要涉及添加自定义 Provider、修改 models.json 配置文件以及确保路径和 provider 名称一致。文中提供了具体的 JSON 配置示例，并指出了可能遇到的对话返回异常问题及排查方向。

王者发布于 2026/4/5更新于 2026/7/1558 浏览

OpenClaw 集成本地 llama.cpp 后端配置指南

llama.cpp 兼容 OpenAPI 接口，可作为 OpenClaw 的后端。

添加自定义 Provider

参考添加自定义 Provider 的步骤为 OpenClaw 增加支持。

在修改过程中，需确保模型状态正确。

{"meta":{"lastTouchedVersion":"2026.2.3-1", "lastTouchedAt":"2026-02-05T12:16:30.399Z"}, "wizard":{"lastRunAt":"2026-01-30T12:20:58.674Z", "lastRunVersion":"2026.1.29", "lastRunCommand":"onboard", "lastRunMode":"local"}, "models":{"mode":"merge", "providers":{"llamacpp":{"baseUrl":"http://192.168.1.182:8087/v1"
,
"apiKey"
:
"no need key"
,
"api"
:
"openai-completions"
,
"models"
:
[
{
"id"
:
"Qwen3-8B-Q6_K"
,
"name"
:
"Qwen3"
,
"api"
:
"openai-completions"
,
"reasoning"
:
true
,
"input"
:
[
"text"
]
,
"cost"
:
{
"input"
:
0
,
"output"
:
0
,
"cacheRead"
:
0
,
"cacheWrite"
:
0
}
,
"contextWindow"
:
262144
,
"maxTokens"
:
32000
}
]
}
}
}
,
"agents"
:
{
"defaults"
:
{
"model"
:
{
"primary"
:
"llamacpp/Qwen3-8B-Q6_K"
}
,
"models"
:
{
"llamacpp/Qwen3-8B-Q6_K"
:
{
"alias"
:
"Qwen3"
}
}
,
"maxConcurrent"
:
4
,
"subagents"
:
{
"maxConcurrent"
:
8
}
}
}
,
"messages"
:
{
"ackReactionScope"
:
"group-mentions"
}
,
"commands"
:
{
"native"
:
"auto"
,
"nativeSkills"
:
"auto"
}
,
"gateway"
:
{
"port"
:
18789
,
"mode"
:
"local"
,
"bind"
:
"loopback"
,
"auth"
:
{
"mode"
:
"token"
,
"token"
:
"a08c51975f90e3afa566f4af1de977a70b6e9630909cc8c0"
,
"password"
:
"a08c51975f90e3afa566f4af1de977a70b6e9630909cc8c0"
}
,
"tailscale"
:
{
"mode"
:
"off"
,
"resetOnExit"
:
false
}
}
,
"skills"
:
{
"install"
:
{
"nodeManager"
:
"npm"
}
}
}

注意配置文件路径 C:\Users\yusp7.openclaw\agents\main\agent\models.json，需与 config\models\provider 保持一致，且内容中不能有重复的 provider 名：

{"providers":{"llamacpp":{"baseUrl":"http://192.168.1.182:8087/v1", "apiKey":"no need key", "api":"openai-completions", "models":[{"id":"Qwen3-8B-Q6_K", "name":"Qwen3", "api":"openai-completions", "reasoning": true, "input":["text"], "cost":{"input":0, "output":0, "cacheRead":0, "cacheWrite":0}, "contextWindow":262144, "maxTokens":32000}]}}}

（此处应有配置界面截图）

常见问题排查

如果返回的对话结果不正确，请检查以下配置项。

（此处应有错误反馈示例）

目录

  1. OpenClaw 集成本地 llama.cpp 后端配置指南
  2. 添加自定义 Provider
  3. 常见问题排查
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫，关注极客日志

微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

更多推荐文章

查看全部
  • OpenClaw 多机器人团队协作构建指南
  • 基于 UniApp 微信小程序的健身俱乐部课程预订与场地预约系统
  • LRU 缓存机制设计与 JavaScript 实现
  • Python 虚拟环境底层原理及 PyCharm/Anaconda 实战指南
  • OpenClaw 跨平台安装指南：Windows 与 Ubuntu
  • Python 构建 OKX 加密货币量化交易系统实战
  • Spring Cloud Alibaba 集成 SkyWalking 全链路追踪实战
  • 人工智能核心概念速通教程
  • 攻防世界 Web 题解：SQL 注入、文件上传与命令注入
  • Spring Boot 安全认证与授权核心解析
  • Agent-Reach：零 API 费用实现 AI 全网数据访问
  • Java 处理 JSON 编程实用技巧
  • C++ STL list 容器底层实现详解
  • PyGoogleNews 指南：使用 Python 获取 Google 新闻数据
  • 算法实战：位运算解决两数之和、唯一数字及消失数字问题
  • LeetCode 380: O(1) 时间插入、删除和获取随机元素
  • SpringBoot 基于 Java 的诊所管理系统设计与实现
  • SpringBoot 博物馆藏品管理系统设计与实现
  • C++ 模板进阶：特化、类型萃取与可变参数
  • Vue3 中方法调用失效的排查与修复方案

相关免费在线工具

  • 加密/解密文本

    使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

  • 随机西班牙地址生成器

    随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印，支持批量处理与下载。 在线工具，Gemini 图片去水印在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online