OpenClaw 跨平台安装指南：Windows 与 Ubuntu
本文介绍如何在 Windows 和 Ubuntu 系统上部署 OpenClaw，从 Node.js 环境准备到完整配置。无论是 Linux 服务器还是本地开发机，都能按照本指南快速完成安装并运行。
Ubuntu 环境安装教程
在 Linux 环境下，命令行操作是主流。如果你尚未安装 Ubuntu 或对 Linux 环境不熟悉，建议先搭建好基础操作系统环境后再继续。
部署 Node.js 基础运行环境
OpenClaw 依赖 Node.js，为了保证最佳兼容性，推荐使用 Node.js 22.x 版本。
首先，下载并执行 NodeSource 提供的官方安装配置脚本，它会自动配置软件源：
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
等待脚本执行完毕并看到成功提示后，使用 apt 包管理器安装 Node.js：
apt-get install -y nodejs
安装时间视网络情况而定。完成后，验证环境是否就绪：
node -v
如果输出类似 v22.22.1 的版本号，说明环境已就绪。
全局安装 OpenClaw
将 OpenClaw 安装到全局环境中，以便在任何目录下调用。
npm install -g openclaw@latest
当终端提示 added xxx packages 时，表示依赖包已下载解压。检查版本确认程序可用：
openclaw --version
初始化向导与大模型配置
安装完成后需连接大模型。官方提供交互式配置向导。
启动初始化向导并安装守护进程：
openclaw onboard --install-daemon
此时会显示 OPENCLAW 图标及安全警告。由于 OpenClaw 拥有读取文件和执行命令的权限，系统会询问你是否了解这是一款默认面向个人的高权限工具。如果在私人机器或虚拟机中运行，选择 Yes 继续。
接着选择向导模式，为避免复杂配置项干扰，直接选择绿色的 QuickStart 模式。
进入核心步骤：选择大模型供应商。针对国内网络环境和性价比，以 Kimi 为例。使用方向键选中 Moonshot AI (Kimi K2.5) 并回车。
认证方式选择第一项，即标准的 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。
- 在选择 Search provider 时，可选择 Kimi (Moonshot) 赋予联网搜索能力。
- 询问是否现在配置 Configure skills now?，选择绿色的 No。
- 询问是否启用 Enable hooks?，依然选择 Skip for now。
配置完成后，终端会打印出 Control UI 的控制台网址及生成的安全访问 Token。
