这次我们将 OpenClaw 的完整安装流程逐层拆解并详细说明，从基础 Node.js 环境配置到最终 Web 控制台成功运行，涵盖 Ubuntu 与 Windows 两种主流系统。按照本指南操作，基本不会遇到卡点。

一、Ubuntu 环境安装教程

Linux 环境运行后台服务是许多开发者的首选。若你尚未安装好 Ubuntu，或对命令行尚不熟练，建议先参考《安装篇–Ubuntu24.04.2详细安装教程》一文搭建好系统环境后再继续。以下全程使用命令行操作，简洁高效。

第一步：部署 Node.js 基础运行环境

OpenClaw 对 Node.js 版本有明确要求。为确保兼容性与性能，强烈推荐安装 **Node.js 22.x**。 首先下载并执行 NodeSource 官方配置脚本，该脚本会自动配置软件源：

curl -fsSL https://deb.nodesource.com/setup_22.x | bash -

脚本执行完毕并看到成功提示后，使用 apt 包管理器安装 Node.js：

apt-get install -y nodejs

安装过程通常几十秒到数分钟，取决于网络状况。安装完成后务必验证：

node -v

若终端输出类似 v22.22.1 的版本号，说明最关键的一步已顺利完成。

第二步：全局安装 OpenClaw

接下来将 OpenClaw 安装到全局环境，以便在任何目录下都能直接调用。 执行安装命令：

npm install -g openclaw@latest

当终端提示 added xxx packages 时，表示所有依赖包已下载并安装完成。确认版本：

openclaw --version

第三步：初始化向导与大模型配置

OpenClaw 安装后仅为一个框架，需要连接大模型才能使用。官方提供了交互式配置向导。 启动初始化向导并安装守护进程：

openclaw onboard --install-daemon

此时屏幕会显示一个巨大的字符图标，并弹出一段安全警告。

OpenClaw 具备读取文件和执行命令的权限，系统会确认你是否知悉此风险。若在私人机器或虚拟机中运行，请放心选择 Yes 继续。

接着选择向导模式。为避开复杂配置项，直接选择绿色的 QuickStart。

现在进入最关键步骤：选择大模型供应商。国内网络环境下，性价比高的选项不少，此处以 Kimi 为例。使用键盘方向键选中 Moonshot AI (Kimi K2.5) 并回车。

认证方式选择第一项，标准 Kimi API key (.ai)。

系统询问如何提供密钥，选择 Paste API key now，直接在终端中粘贴。

在提示行 Enter Moonshot API key 后面，鼠标右键或使用快捷键粘贴你事先申请好的 API Key，回车确认。

选择默认模型时，保持选中的 Keep current (moonshot/kimi-k2.5) 不动即可。

后续步骤是扩展功能配置，为尽快搭建运行，可先略过： - 选择 Select channel 时，移至最下方选 Skip for now - 选择 Search provider 时，顺手选 Kimi (Moonshot)，这样便具备联网搜索能力 - 系统问 Configureskills now?，选绿色的 No - Enable hooks?，依然选 Skip for now

完成一系列问答后，配置结束。终端会打印出 Control UI 的控制台地址以及专属的安全访问 Token。

第四步：启动网关服务并进入可视化界面

配置完成后，通常需要手动启动网关服务。使用以下命令启动，并指定监听端口为 18789：

openclaw gateway --port 18789

随后终端会持续刷新日志，表明网关已成功绑定端口并开始监听请求。

在浏览器地址栏输入 https://127.0.0.1:18789/（若在服务器上，请替换为公网 IP）。回车后，聊天页面即刻呈现，现在你可以直接与 AI 助手对话。

二、Windows 系统环境安装

与 Linux 全命令行操作相比，Windows 安装流程更符合普通用户直觉。我们将结合图形化安装包与系统命令共同完成部署。

第一步：下载并安装 Node.js 运行库

无论使用哪种系统，打好 Node.js 基础始终是第一步。 打开浏览器，访问 Node.js 官方网站，点击屏幕中央醒目的绿色按钮 Get Node.js。

页面跳转后，作为 Windows 用户，直接点击左侧的 Windows Installer (.msi) 按钮下载安装包。

找到下载好的 .msi 文件，双击启动。在欢迎界面右下角直接点 Next。

阅读许可协议，勾选 I accept the terms in the License Agreement，继续点 Next。

接下来选择安装路径，可以点 Change 改到 D 盘或 E 盘，然后点 Next。

Custom Setup 界面不需做任何修改，保持默认勾选，直接点 Next。

到达 Tools for Native Modules 界面时，务必勾选 “Automatically install the necessary tools…”。若不勾选，后续安装某些开源库时可能会频繁报错，这一步能避免大量麻烦。勾选完成后点 Next。

一切就绪后，点击 Install，等待进度条走完。

看到 Completed 界面后，点击 Finish 完成安装。

最后验证：按下 Win + R，输入 cmd 回车，在命令行中输入：

node -v

如果能打印出类似 v24.13.0 的版本号，即表示安装成功。

第二步：在 Windows 终端全局安装 OpenClaw

打开 PowerShell 或 CMD 终端（建议右键选择“以管理员身份运行”），输入：

npm i -g openclaw

此过程会从远程拉取大量代码包，等待一到两分钟，直到出现 added xxx packages 字样，安装即完成。

第三步：启动交互式配置向导

与 Ubuntu 流程类似，需要告知 Windows 上的 OpenClaw 应连接哪款大模型。 在终端中输入初始化命令：

openclaw onboard

阅读安全风险提示，确认并选择绿色的 Yes 继续。

选择配置模式时，直接选第一项 QuickStart 快速模式。

这次我们换另一个模型供应商演示。使用方向键找到并选中 MiniMax，该模型在长文本和逻辑推理方面表现同样出色。

进入认证方式选择，为提升稳定性，选带有国内节点标识的 MiniMax M2.5 (CN)。

系统询问如何输入 API 密钥，选 Paste API key now。

将之前在 MiniMax 开放平台申请的密钥复制过来，在终端中右键点击即可粘贴，然后回车。

默认模型设置，保持高亮的 Keep current (minimax-cn/MiniMax-M2.5) 并回车。

后续高级配置，新手可全部跳过： - 接入渠道选 Skip for now - 搜索引擎服务选 Skip for now - 是否配置技能选 No - 是否启用自动化钩子选 Skip for now

稍等片刻，你会看到 Gateway 网关服务已成功安装，并列出本地存储路径。

第四步：一键孵化并访问 Web 控制台

向导最后会询问你打算如何孵化机器人。选择中间那一项 Open the Web UI。

选择之后，终端开始输出大量后台日志，表明你的私有大模型网关正在全力运行。

与此同时，Windows 默认浏览器会自动弹出一个新标签页，指向 https://127.0.0.1:18789。一个本地 AI 聊天控制台便呈现在眼前。打个招呼，开始探索 OpenClaw 带来的无限自动化潜能吧！