OpenClaw 跨平台安装指南
本文介绍如何在 Windows 和 Ubuntu 环境下部署 OpenClaw，从 Node.js 基础环境准备到完整的大模型配置。无论是服务器端还是本地开发机，都能按照以下步骤快速完成搭建。
Ubuntu 环境安装
Linux 环境是运行后台服务的首选。如果你尚未安装 Ubuntu 或对 Linux 操作较陌生，建议先确保系统基础环境已就绪，再参考本指南进行后续配置。
1. 部署 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 的版本号，说明地基已打好。
2. 全局安装 OpenClaw
将工具安装到全局环境，方便在任何目录下直接调用：
npm install -g openclaw@latest
当终端提示 added xxx packages 时，表示依赖包已下载解压完毕。接着检查版本信息确认程序可用：
openclaw --version
3. 初始化向导与大模型配置
安装后的 OpenClaw 尚需连接大模型才能工作。官方提供了交互式配置向导来简化流程。
启动初始化向导并安装守护进程：
openclaw onboard --install-daemon
此时屏幕会显示 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。
4. 启动网关服务并进入可视化界面
配置完成后，手动启动网关服务，指定监听端口为 18789：
