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

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

• 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 的自动化潜能。