夜雨聆风一、Ubuntu 环境安装教程
对于很多开发者来说，Linux 环境是运行服务器和后台服务的首选。
在 Ubuntu 中，我将全程使用命令行 来完成安装。
第一步：部署 Node.js 基础运行环境
OpenClaw 对 Node.js 的版本有一定要求，为了保证最佳的兼容性和性能，我们这里强烈推荐安装 Node.js 22.x 版本。
首先，我们需要下载并执行 NodeSource 提供的官方安装配置脚本，它会自动帮我们配置好软件源：
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt-get install -y nodejs
node -v
如果你在屏幕上看到了类似于 v22.22.1 这样的版本号输出，那么恭喜你，最关键的地基已经打好了。
第二步：全局安装 OpenClaw
接着我们需要把 OpenClaw 安装到全局环境中，这样你在任何目录下都可以直接用它。
在终端中执行以下安装命令：
npm install -g openclaw@latest
added xxx packages 时，说明所有的依赖包都已经下载并解压完毕。为了确认程序可用，我们检查一下 OpenClaw 的版本信息：openclaw --version
第三步：初始化向导与大模型配置
OpenClaw 安装好之后还只是一个空壳，我们需要给它连接大模型 。官方提供了一个交互式配置向导。
启动初始化向导并安装守护进程：
openclaw onboard --install-daemon
认证方式我们选择第一项，即标准的 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。
询问是否启用 Enable hooks?，依然选择 Skip for now。
经过这一系列问答，配置终于完成。终端会打印出 Control UI 的控制台网址以及专门为你生成的安全访问 Token。
第四步：启动网关服务并进入可视化界面
openclaw gateway --port 18789随后，你会在终端看到不断刷新的日志，这意味着网关已经成功绑定端口并开始监听请求了。
http://服务器IP:18789在地址栏输入 http://127.0.0.1:18789/（如果是在服务器上，请把 IP 换成你服务器的公网 IP）。
回车之后，一个聊天页面就会呈现在你眼前。你现在可以直接在输入框里跟你的 AI 助手聊天。
二、Windows 系统环境安装
相对于 Linux 的纯命令行，Windows 的安装过程会更加符合普通用户的直觉，我们将结合图形化安装包和系统命令行来共同完成部署。
第一步：下载并安装 Node.js 运行库
不管是在什么系统上，打好 Node.js 这个地基永远是第一步。
首先，打开你的浏览器，访问 Node.js 的官方网站主页，点击屏幕中央非常醒目的绿色大按钮 Get Node.js。
.msi 后缀的安装文件，双击启动它。在欢迎界面的右下角，直接点击 Next。
阅读最终用户许可协议，勾选左下角的 I accept the terms in the License Agreement，然后继续点击 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
在选择配置模式时，为了节省时间，我们依然选择第一项 QuickStart 快速模式。
这一次，我们换一个模型供应商来演示。使用方向键找到并选中 MiniMax，这款模型在处理长文本和逻辑推理方面也有着不俗的表现
系统询问如何输入 API 秘钥，选择 Paste API key now 准备直接粘贴。
此时把你在 MiniMax 开放平台申请的秘钥文本复制过来，在终端里右键点击即可粘贴，然后按下回车。
默认模型设置这一步，不需要修改，保持高亮的 Keep current (minimax-cn/MiniMax-M2.5) 选项并回车。
后续的高级配置选项，针对新手我们先全部跳过，等熟悉了之后再回来研究：
接入渠道选择 Skip for now。
是否配置技能选择 No。
第四步：一键孵化并访问 Web 控制台
向导进行到最后，会问你打算如何孵化你的机器人。请选择中间那一项 Open the Web UI。
http://127.0.0.1:18789。展现在你面前的便是一个本地 AI 聊天控制台。打个招呼，开始探索 OpenClaw 带来的无限自动化潜能吧！
版权声明：本文为CSDN博主「IvanCodes」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/2401_83830408/article/details/158889031
