OpenClaw 跨平台安装指南
本文介绍如何在 Windows 和 Ubuntu 环境下完成 OpenClaw 的部署。从 Node.js 环境准备到完整配置，按照以下步骤操作即可快速运行。
一、Ubuntu 环境安装教程
Linux 是运行服务器服务的首选环境。如果你尚未搭建好基础系统，建议先完成操作系统安装后再继续。
第一步：部署 Node.js 基础运行环境
OpenClaw 依赖 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
将 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)。
后续扩展功能可暂时略过：
- Select channel: 选 Skip for now。
- Search provider: 可选 Kimi (Moonshot) 开启联网搜索。
- Configure skills now?: 选 No。
- Enable hooks?: 选 Skip for now。
配置完成后，终端会打印 Control UI 的控制台网址及安全访问 Token。
第四步：启动网关服务并进入可视化界面
手动启动网关服务，指定监听端口为 18789：
openclaw gateway --port 18789
终端刷新日志表明服务已绑定端口。在浏览器输入 http://127.0.0.1:18789/（服务器环境请替换为公网 IP），即可打开本地 AI 聊天页面。
