如何在Ubuntu上从源代码安装OpenClaw，对接本地Ollama大模型

一、部署前须知：前置环境核验与准备工作

在正式部署OpenClaw之前，务必先完成基础环境的核验与优化，避免后续安装出现依赖缺失、版本不兼容等问题。本教程基于VMware虚拟机内的Ubuntu系统开展，前期已完成NodeJS、Git环境配置以及Windows端Ollama部署，这是OpenClaw运行的核心前提，直接决定后续部署成败。

首先要确认基础软件版本达标，OpenClaw对NodeJS和Git有明确版本要求，过低版本会导致编译失败；其次优化虚拟机显示分辨率，方便后续操作命令行、查看源码文件，提升实操体验；最后提前规划文件存储路径，新建专属文件夹存放OpenClaw源码，避免文件混乱难以查找。

1. 步骤1：核验NodeJS与Git版本：打开终端，输入node -v和git -v，确保NodeJS版本≥v22.22.1、Git版本≥2.51.0，版本不达标需先升级对应软件。
2. 步骤2：优化虚拟机分辨率：进入Ubuntu系统设置，调整屏幕分辨率，放大字体显示，避免操作时看不清命令和文件信息。
3. 步骤3：新建源码存储目录：在用户主文件夹下新建名为work的文件夹，专门用于存放解压后的OpenClaw源码，方便后续终端定位路径。
4. 步骤4：确认Windows Ollama就绪：提前开启Ollama网络暴露功能，记录Windows主机IP地址，为后续跨端联动做准备。

二、源码精准获取：GitHub下载稳定版OpenClaw

OpenClaw源码获取是部署的第一步，选择合适的版本至关重要——最新提交版可能存在未修复BUG，建议优先下载官方Release稳定版，保障运行稳定性。本教程选用2026.3.13版本，兼容性和稳定性经过验证，适合新手实操。

若GitHub访问失败或下载卡顿，无需反复尝试，可留言获取已下载好的源码包，节省时间成本。下载完成后需及时解压，避免安装过程中网络中断导致源码丢失，全程操作无需复杂配置，跟着步骤点击即可完成。

1. 步骤1：打开浏览器访问GitHub：启动Ubuntu自带Firefox浏览器，输入GitHub官网地址，回车访问，确认网络可正常连通。
2. 步骤2：搜索OpenClaw项目：在GitHub搜索框输入openclaw，回车检索，找到官方项目openclaw/openclaw并点击进入。
3. 步骤3：选择Release稳定版：在项目页面找到Releases板块，点击最新Release版本（2026.3.13），进入版本详情页。
4. 步骤4：下载源码压缩包：在版本详情页底部找到Source code，点击下载ZIP格式源码包，等待下载完成。
5. 步骤5：解压源码文件：进入下载目录，右键单击ZIP压缩包，选择提取，将解压后的文件夹移动至提前新建的work目录下。

三、依赖环境搭建：安装pnpm包管理工具

OpenClaw编译安装依赖pnpm包管理工具，系统默认未安装，需通过npm全局部署。这一步是衔接源码与编译的关键环节，安装过程需输入管理员密码，安装后需核验版本，确保工具正常生效，避免后续执行编译命令报错。

部分用户安装后可能出现环境变量未生效的问题，无需慌张，按照教程执行source命令即可刷新配置，保证pnpm命令可全局调用。整个安装过程耗时短，只需两行命令即可完成，新手也能轻松操作。

1. 步骤1：打开终端窗口：右键单击Ubuntu桌面，选择在终端中打开，启动命令行工具。
2. 步骤2：执行pnpm安装命令：在终端输入sudo npm install -g pnpm，回车后输入Ubuntu管理员密码，等待工具自动安装。
3. 步骤3：核验pnpm安装状态：安装完成后，依次输入npm -v和pnpm -v，查看版本号（npm≥10.9.4、pnpm≥10.32.1），确认安装成功。
4. 步骤4：修复全局路径报错（可选）：若后续出现link报错，先执行pnpm setup，再执行source /home/hello/.bashrc，刷新环境变量配置

四、核心编译安装：三步完成OpenClaw部署

这是OpenClaw部署的核心环节，通过三条pnpm命令依次完成依赖安装、UI构建、项目编译，全程无需手动配置文件，终端自动执行操作。每一步命令执行完毕后，需查看终端反馈信息，确认无报错后再进行下一步，避免中途出错导致部署失败。

编译完成后，需将OpenClaw注册为全局CLI命令，实现终端直接调用，提升使用便捷性。针对注册过程中可能出现的路径报错，教程已提前给出解决方案，按步骤修复即可快速解决，保障命令全局生效。

1. 步骤1：定位源码目录：在终端输入cd命令，切换至work目录下的OpenClaw源码文件夹，可通过拷贝路径快速定位，避免手动输入出错。
2. 步骤2：安装项目依赖：执行pnpm install，回车后等待终端自动下载并安装所有依赖包，出现完成提示后代表依赖安装成功。
3. 步骤3：构建UI界面：依赖安装完毕后，执行pnpm ui:build，该命令执行速度较快，等待终端反馈完成信息即可。
4. 步骤4：编译项目源码：执行pnpm build，等待编译流程结束，此时OpenClaw主体已安装完成。
5. 步骤5：注册全局命令：执行pnpm link –global，将OpenClaw注册为全局CLI命令；若报错则先执行修复命令，再重新注册。

五、跨端联动配置：对接Windows Ollama大模型

OpenClaw需依托大语言模型实现AI功能，本教程采用Windows本地Ollama提供模型支持，需完成网络配置、URL填写、模型选择三大核心操作。这一步是实现OpenClaw正常交互的关键，配置不当会导致模型无法调用，需严格按照步骤核对参数。

首先要开启Ollama网络暴露权限，让Ubuntu虚拟机可访问Windows主机的Ollama服务；其次准确填写Ollama访问URL，选择合适的运行模式；最后完成云端登录和模型选择，跳过无需配置的插件和API项，简化部署流程。

1. 步骤1：启动OpenClaw配置向导：在终端执行openclaw onboard –install-daemon，启动配置界面并安装后台守护进程。
2. 步骤2：基础配置确认：通过键盘方向键选择Yes确认继续，选择QuickStart快速启动模式，回车确认。
3. 步骤3：选择Ollama模型源：在模型选择界面，选中Ollama选项，回车进入URL配置页面。
4. 步骤4：配置Ollama访问URL：填写Windows主机Ollama地址（格式：http://主机IP:11434），回车确认；提前在Windows通过ipconfig查询主机IP。
5. 步骤5：选择Ollama运行模式：选中Cloud + Local模式，回车后复制登录链接，在浏览器打开完成Ollama云端连接。
6. 步骤6：完成后续配置：返回终端选择Yes确认登录，选用默认Kimi 2.5模型，跳过聊天渠道、API密钥、技能插件等无需配置项。

六、收尾验证：确认OpenClaw正常运行

所有配置完成后，需验证OpenClaw是否正常启动、Web UI是否可访问、AI交互是否流畅，这是判断部署成败的最终标准。同时建议保存核心访问链接，方便后续快速打开管理界面，无需重复执行配置命令。

若Web UI正常打开、可与AI助手正常对话，说明部署全程成功；若出现访问失败、无响应等问题，可回溯步骤检查源码、依赖、模型配置是否有误，针对性修复即可。部署完成后，OpenClaw会以守护进程形式后台运行，开机自动启动，无需手动开启。

1. 步骤1：选择交互方式：在配置收尾界面，选中Open the Web UI选项，回车启动网页交互界面。
2. 步骤2：访问管理控制台：复制终端给出的Control UI链接，在Firefox浏览器粘贴访问，打开OpenClaw管理界面。
3. 步骤3：测试AI交互功能：在控制台输入简单指令（如“你好”“你能做什么”），查看AI是否正常回复，确认功能生效。
4. 步骤4：保存核心信息：将Control UI链接、Ollama访问地址等重要信息存档，方便后续维护和二次配置。

七、视频演示

你可以通过选择自己喜欢的字幕语言来观看以下的演示视频。