OpenClaw Windows 与 Ubuntu 安装配置指南

接下来选择大模型供应商。国内环境推荐使用 Kimi (Moonshot AI)。

认证方式选择标准的 Kimi API key (.ai)，并在提示行粘贴你的 API Key。

默认模型保持选中状态即可。后续扩展功能如搜索渠道、技能配置等，为快速完成基础搭建，可选择跳过或按需设置。

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

4. 启动网关服务

手动启动网关服务，指定监听端口（例如 18789）：

openclaw gateway --port 18789

终端开始刷新日志表示服务已绑定端口。在浏览器访问 http://127.0.0.1:18789/（服务器环境请替换为公网 IP），即可进入聊天界面。

二、Windows 系统环境安装

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

1. 安装 Node.js 运行库

打开 Node.js 官网下载 Windows Installer (.msi) 安装包。

双击运行安装程序，勾选接受许可协议，点击 Next。

安装路径可根据习惯修改，Custom Setup 保持默认组件勾选。

注意： 在 Tools for Native Modules 界面，务必勾选 Automatically install the necessary tools…，否则后续编译原生模块时可能报错。

安装完成后，打开 CMD 输入 node -v 验证环境变量是否生效。

2. 全局安装 OpenClaw

建议以管理员身份运行 PowerShell 或 CMD，执行以下命令：

npm install -g openclaw

等待依赖包拉取完成，出现 added xxx packages 即表示安装成功。

3. 启动交互式配置向导

与 Ubuntu 类似，需配置模型连接。输入初始化命令：

openclaw onboard

阅读风险提示后选择 Yes。模式选择 QuickStart。

本次演示切换为 MiniMax 模型，选择带有国内节点标识的 MiniMax M2.5 (CN)。

同样选择 Paste API key now 粘贴秘钥。高级配置项如接入渠道、搜索引擎等，新手可暂时选择 Skip for now。

配置结束后，向导会询问如何孵化机器人，选择 Open the Web UI。

终端开始输出后台日志，默认浏览器会自动弹出 http://127.0.0.1:18789 页面，此时即可开始使用本地 AI 助手。