Ollama 启动项目中新增OpenClaw：深度揭秘背后技术逻辑项

📚 资源信息

关键词讲解

• OpenClaw：见文中解释
• openclaw：见文中解释
• Ollama：见文中解释
• ollama：见文中解释
• 大模型：见文中解释
• DeepSeek：见文中解释
• 模型：见文中解释
• API：见文中解释

本文内容源自今日头条网友分享，由 AI 整理发布。

本文涉及的Ollama+deepseek-r1:1.5b环境是先安装好的，需要特别提醒的是：Ollama一定要注意使用高版本版本：0.17.4+，当我在安装完OpenClaw后，无意中看到在启动Ollama时出现了OpenClaw启动项，整个过程中我并没有做任何操作，很是奇怪！今天刚好有时间，就给家人们拆解这一关联过程的底层逻辑、核心配置与实现路径，剖析其中的原理。

Ollama(deepseek)&OpenClaw联动

在本地部署大模型的场景中，Ollama 凭借轻量化的模型管理能力成为主流选择，而 OpenClaw 作为具备多技能的 AI助手工具，常云端大模型或本地 Ollama 配合使用。不少用户在 Windows 环境下安装 OpenClaw 后，执行ollama命令时发现 OpenClaw 被自动加入启动项列表，且关联了已部署的deepseek-r1:1.5b模型 (如下图所示)。这一集成效果并非我手动配置所致，而是 OpenClaw 安装流程与 Ollama 扩展机制协同的结果。事实上，这里我们还可以通过执行 ollama launch 命令启动下图选项。

ollama命令执行

一、核心原理：Ollama 的集成扩展机制

Ollama 设计了灵活的第三方集成扩展体系，其核心是通过自身配置文件识别并注册外部工具（如 OpenClaw），并在交互界面中展示对应的启动项。该机制的核心逻辑为：
1、外部工具向 Ollama 的核心配置文件写入集成信息（包括关联模型、集成状态）；
2、Ollama 启动或执行命令时，读取配置文件中的integrations字段，解析已注册的外部工具；
3、若工具已完成初始化（标记onboarded: true），则在ollama命令交互界面渲染对应的启动项，并展示关联的模型信息。
OpenClaw 正是基于这一机制，在安装过程中自动完成向 Ollama 的 “注册”，从而被纳入 Ollama 的启动项列表。

二、关键配置文件：集成关联的 “数据载体”

OpenClaw 与 Ollama 的关联依赖两份核心配置文件，二者的字段联动是实现集成的核心 “数据载体”。

1. Ollama 的核心配置文件（config.json）
   Ollama 的config.json配置文件是集成信息的存储核心，其中integrations字段专门用于管理第三方工具的注册信息。我的配置内容如下：

{ “integrations”: { “openclaw”: { “models”: [ “deepseek-r1:1.5b” ], “onboarded”: true } }, “last_selection”: “openclaw”}
integrations.openclaw：标记 OpenClaw 为已注册的集成工具；
models：明确 OpenClaw 关联的 Ollama 本地模型（即deepseek-r1:1.5b），这也是ollama命令中启动项后括号内模型信息的来源；
onboarded: true：确认 OpenClaw 已完成初始化，Ollama 据此在交互界面展示其启动项。

2. OpenClaw 的配置文件（openclaw.json）
   OpenClaw 的openclaw.json则定义了自身与 Ollama 模型的绑定关系，为集成提供 “模型匹配依据”：

{ “agents”: { “defaults”: { “model”: { “primary”: “ollama/deepseek-r1:1.5b” } } }, “models”: { “providers”: { “ollama”: { “api”: “ollama”, “baseUrl”: “http://0.0.0.0:11434/v1“, “models”: [ { “id”: “deepseek-r1:1.5b”, “name”: “deepseek-r1:1.5b” } ] } } }}
agents.defaults.model.primary：指定 OpenClaw 默认调用的 Ollama 模型；
models.providers.ollama.models：声明支持的 Ollama 模型列表，与 Ollama 的config.json中models字段形成精准匹配，确保集成时模型信息的一致性。
三、安装脚本（install.ps1）：自动关联的 “执行引擎”

OpenClaw 的安装脚本install.ps1是实现自动关联的核心 “执行引擎”，其通过参数控制、环境检查、初始化触发三个环节，完成向 Ollama 配置文件的信息写入。

1. 参数控制：Onboard 流程的触发开关
   脚本定义了-NoOnboard参数，默认不启用该参数时，会触发openclaw onboard初始化流程：

if (-not $NoOnboard) { Write-Host “Starting setup…” -ForegroundColor Cyan Write-Host “” Invoke-OpenClawCommand onboard # 执行onboard初始化}

该参数是控制集成是否自动完成的关键 —— 若手动指定-NoOnboard，则不会触发后续的注册流程，OpenClaw 也不会被加入 Ollama 启动项列表。
2. 环境检查：集成的前置条件保障
脚本先完成 Node.js（22 + 版本）、Git 等依赖的检查与自动安装：

检查 Node.js 版本，若低于 22 则通过 winget/choco/scoop 等包管理器自动安装；
若未检测到 Git，自动下载并配置便携版 Git，确保openclaw onboard命令可正常执行。

这些依赖是onboard流程的基础，保障了后续配置写入操作的顺利完成。
3. Onboard 流程：向 Ollama 写入集成配置

Invoke-OpenClawCommand onboard是核心动作，其底层逻辑为：

读取 OpenClaw 的openclaw.json配置，提取关联的 Ollama 模型信息；
向 Ollama 的config.json写入integrations.openclaw字段，包括模型列表与onboarded: true状态；
标记last_selection: “openclaw”，使 Ollama 默认展示 OpenClaw 启动项。

至此，OpenClaw 完成向 Ollama 的注册，执行ollama命令时即可看到对应的启动项与模型信息。

四、总结与实操拓展

1. 关联流程总结

OpenClaw 被加入 Ollama 启动项列表的完整链路为：安装脚本执行→检查并安装依赖→触发onboard流程→向Ollama config.json写入集成配置→Ollama读取配置并展示启动项。

2. 实操拓展：修改 / 移除关联

2.1 若需移除 OpenClaw 在 Ollama 中的启动项，只需编辑 Ollama 的config.json

删除integrations.openclaw字段；
重启终端后执行ollama命令，OpenClaw 启动项即消失。

2.2 若需修改关联的模型，可同时调整

Ollamaconfig.json中integrations.openclaw.models列表；
OpenClawopenclaw.json中agents.defaults.model.primary与models.providers.ollama.models的模型 ID。

OpenClaw 与 Ollama 的自动集成设计，本质是通过配置标准化与流程自动化降低用户的使用成本。理解这一机制后，可灵活调整二者的集成关系，适配不同的本地模型部署场景。好了，今天就分享到这里，希望内容能给家人们解惑，并带来一丢丢帮助，评论区见！！

#人工智能##AI技术##大模型##openclaw##deepseek##ollama#

本文为网络资源整理分享，仅供学习交流使用。