OpenClaw 跨平台安装指南：Windows 与 Ubuntu

OpenClaw 跨平台安装指南：Windows 与 Ubuntu

本文介绍如何在 Windows 和 Ubuntu 环境下部署 OpenClaw。从 Node.js 环境准备到完整配置，按照以下步骤操作即可快速运行。

Ubuntu 环境部署

Linux 是运行服务器和后台服务的首选环境。如果你尚未安装 Ubuntu，建议先完成基础系统搭建。

1. 部署 Node.js 运行环境

OpenClaw 依赖 Node.js，为了保证兼容性和性能，推荐安装 Node.js 22.x 版本。

首先执行官方安装脚本配置软件源：

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

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

apt-get install -y nodejs

安装耗时视网络情况而定。完成后验证版本：

node -v

若输出类似 v22.22.1 的版本号，说明环境已就绪。

2. 全局安装 OpenClaw

将工具安装到全局环境，以便在任何目录下调用：

npm install -g openclaw@latest

当终端提示 added xxx packages 时，表示依赖下载解压完毕。检查版本确认可用：

openclaw --version

3. 初始化向导与大模型配置

安装后的 OpenClaw 需要连接大模型才能工作。启动交互式配置向导：

openclaw onboard --install-daemon

屏幕会显示安全警告。由于该工具拥有读取文件和执行命令的权限，请确保在私人机器或虚拟机中运行。选择 Yes 继续。

接着选择 QuickStart 模式以简化配置流程。

模型选择

国内环境推荐使用 Kimi (Moonshot AI)。

1. 选中 Moonshot AI (Kimi K2.5) 并回车。
2. 认证方式选择第一项标准的 Kimi API key (.ai)。
3. 输入方式选择 Paste API key now。
4. 在提示行粘贴你的 API Key 并回车。
5. 默认模型保持 Keep current (moonshot/kimi-k2.5)。

扩展功能

为快速完成基础搭建，后续选项可暂时跳过：

• Select channel: 选择 Skip for now。
• Search provider: 可选 Kimi (Moonshot) 开启联网搜索。
• Configure skills now?: 选择 No。
• Enable hooks?: 选择 Skip for now。

配置完成后，终端会打印 Control UI 的控制台网址及安全访问 Token。

4. 启动网关服务

手动启动网关服务，指定监听端口为 18789：

openclaw gateway --port 18789

终端开始刷新日志，表示网关已绑定端口。在浏览器访问：

http://127.0.0.1:18789/

如果是远程服务器，请将 IP 替换为公网地址。回车后即可进入聊天界面。

Windows 系统环境安装

Windows 下结合图形化安装包和命令行即可完成部署。

1. 安装 Node.js 运行库

打开 Node.js 官网，点击绿色按钮 Get Node.js。

页面跳转后，点击左侧 Windows Installer (.msi) 下载对应安装包。

双击 .msi 文件启动安装：

1. 欢迎界面点击 Next。
2. 勾选 I accept the terms in the License Agreement，点击 Next。
3. 选择安装路径（建议 D 盘或 E 盘），点击 Next。
4. Custom Setup 保持默认勾选，点击 Next。
5. 重要：在 Tools for Native Modules 界面，务必勾选 Automatically install the necessary tools…，否则后续安装复杂开源库可能报错。
6. 点击 Install 等待进度条完成。
7. 点击 Finish 结束安装。

验证环境变量：按 Win + R，输入 cmd 回车，执行：

node -v

若输出版本号如 v24.13.0，则安装成功。

2. 全局安装 OpenClaw

打开 PowerShell 或 CMD（建议右键以管理员身份运行）：

npm i -g openclaw

等待拉取代码包，出现 added xxx packages 即完成。

3. 启动交互式配置向导

与 Ubuntu 类似，需配置大模型连接：

openclaw onboard

阅读风险提示后选择 Yes。

选择 QuickStart 快速模式。

模型选择演示

此处演示使用 MiniMax：

1. 选中 MiniMax。
2. 认证方式选择带有国内节点标识的 MiniMax M2.5 (CN)。
3. 输入方式选择 Paste API key now。
4. 复制秘钥文本，在终端右键粘贴并回车。
5. 默认模型保持高亮选项并回车。

高级配置

新手建议全部跳过：

• 接入渠道：Skip for now
• 搜索引擎：Skip for now
• 是否配置技能：No
• 是否启用自动化钩子：Skip for now

等待网关服务安装完成，列出本地存储路径。

4. 访问 Web 控制台

向导最后询问如何孵化机器人，选择 Open the Web UI。

终端开始输出后台日志，表明私有大模型网关正在运转。同时默认浏览器会自动弹出新标签页，指向 http://127.0.0.1:18789。

此时即可在本地 AI 聊天控制台开始探索 OpenClaw 的自动化潜能。