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

OpenClaw 集成本地 Llama.cpp 后端

介绍如何在 OpenClaw 中配置本地 llama.cpp 作为后端。通过添加自定义 Provider,设置 baseUrl 和 API 类型(openai-completions),并同步 models.json 与 provider 配置。需注意避免 provider 名称重复及路径一致性。若配置后对话结果异常,应检查模型状态及配置项是否正确加载。

ApiHolic发布于 2026/4/6更新于 2026/8/2376 浏览

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

添加自定义 Provider

参考相关文档为 OpenClaw 增加自定义 Provider。在反复修改后,有时仍无法得到正确的模型状态。

配置文件示例

主配置文件包含以下结构:

{"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\user\.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. 添加自定义 Provider
  2. 配置文件示例
  3. 注意事项
  4. 问题排查
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Whisper-medium.en 模型深度解析与 Python 实现
  • 协作机器人轴孔装配的轨迹优化与智能搜索技术
  • 基于西门子 TIA、PLCSIM Advanced 与 Kepware 的 Fanuc 机器人虚拟仿真调试
  • Gemini 图片无损去水印:基于反向 Alpha 混合的前端方案
  • 主流 AI 编程工具对比与开发者选型指南
  • GitHub Copilot 使用体验与实战场景分析
  • 用两个栈模拟队列:LIFO 到 FIFO 的转换实现与原理分析
  • 免费 Trae 编辑器体验:i18n 任务排队千名及 AI 编程思考
  • Windows 系统安装 MySQL 5.7.44 图文教程
  • LSTM 学生成绩预测系统的实现与界面整理
  • Qwen-Image-2512 文生图模型整合包使用指南(ComfyUI/WebUI)
  • 基于 LLaMA-Factory 的大模型 LoRA 微调实战指南
  • OSCP 实战:获取并破解 Net-NTLMv2 哈希(下)
  • Aurora 8B/10B 配置实战:从物理层到共享逻辑的避坑笔记
  • Python AI 开发环境搭建:Anaconda + PyCharm + Claude Code 配置指南
  • ClawdBot 本地部署指南与核心功能解析
  • AI 编程工具收费模式变革:Token 计费时代的开发者生存指南
  • Python 连接和操作 Elasticsearch 指南
  • OpenClaw 使用 Nginx 反向代理部署及 disconnected (1008) 错误解决
  • Raphael AI:基于 Flux 模型的免费图像生成工具评测

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online