Ubuntu 环境安装
对于开发者而言，Linux 往往是运行后台服务的首选。如果你尚未搭建好 Ubuntu 系统，建议先完成基础环境配置后再继续。
部署 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 的版本号，说明地基已打好。
全局安装 OpenClaw
将工具安装到全局环境，以便在任何目录下调用：
npm install -g openclaw@latest
当终端提示 added xxx packages 时，依赖包已就绪。检查版本确认可用性：
openclaw --version
初始化向导与大模型配置
安装后的 OpenClaw 需要连接大模型才能工作。启动交互式配置向导并安装守护进程：
openclaw onboard --install-daemon
屏幕会显示安全警告，因为该工具拥有读取文件和执行命令的权限。如果在个人机器或虚拟机中运行，选择 Yes 继续。
进入向导模式，为简化配置，直接选择绿色的 QuickStart 模式。
接下来选择大模型供应商。针对国内网络环境，这里以 Kimi 为例。使用方向键选中 Moonshot AI (Kimi K2.5) 并回车。
认证方式选择第一项标准的 Kimi API key (.ai)。
系统询问如何提供秘钥，选择 Paste API key now，直接在终端粘贴你申请好的 API Key 并回车。
默认模型保持选中的 Keep current (moonshot/kimi-k2.5) 即可。
后续扩展功能配置可暂时略过：
- 渠道选择 Skip for now。
- 搜索引擎服务选择 Kimi (Moonshot) 以启用联网搜索。
- 技能配置选择 No。
- 钩子功能选择 Skip for now。
配置完成后，终端会打印出 Control UI 的控制台网址及生成的安全访问 Token。
启动网关服务并进入可视化界面
通常需手动启动网关服务，指定监听端口为 18789：
openclaw gateway --port 18789
终端会刷新日志，表明网关已绑定端口。在浏览器地址栏输入 http://127.0.0.1:18789/（若是服务器请替换为公网 IP），即可打开本地 AI 聊天控制台。
Windows 系统环境安装
Windows 下结合图形化安装包和命令行即可完成部署。
下载并安装 Node.js 运行库
Node.js 是基础，务必先安装。
访问 Node.js 官网，点击绿色按钮 Get Node.js。页面跳转后，点击左侧 Windows Installer (.msi) 下载对应安装包。
双击 .msi 文件启动安装，点击 Next。
勾选 I accept the terms in the License Agreement，继续点击 Next。
选择安装路径，可修改至 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 类似，需指定连接的大模型。
输入初始化命令：
openclaw onboard
阅读安全风险提示，选择绿色的 Yes 继续。
配置模式选择 QuickStart 快速模式。
此处演示更换模型供应商，选中 MiniMax，其在长文本处理上表现不错。
认证方式选择带有国内节点标识的 MiniMax M2.5 (CN)。
输入秘钥方式选择 Paste API key now，在终端右键粘贴秘钥并回车。
默认模型保持高亮的 Keep current (minimax-cn/MiniMax-M2.5) 并回车。
高级配置选项新手可全部跳过：
- 接入渠道选择 Skip for now。
- 搜索引擎服务选择 Skip for now。
- 是否配置技能选择 No。
- 是否启用自动化钩子选择 Skip for now。
等待片刻，你会看到 Gateway 网关服务安装成功，并列出本地存储路径。
一键孵化并访问 Web 控制台
向导最后询问如何孵化机器人，选择中间项 Open the Web UI。
终端开始吐出后台运行日志，表明私有大模型网关正在运转。同时浏览器自动弹出新标签页，指向 http://127.0.0.1:18789，即可开始体验本地 AI 助手。
