OpenClaw 跨平台安装指南
本指南将带你完成 OpenClaw 的全流程部署，涵盖 Node.js 环境准备到完整配置。无论是 Ubuntu 还是 Windows，均可按步骤快速搭建并运行。
Ubuntu 环境安装
Linux 环境通常是运行服务器和后台服务的首选。若尚未安装 Ubuntu，建议先完成基础系统搭建。
部署 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 需要连接大模型。官方提供交互式配置向导。
启动初始化向导并安装守护进程：
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) 不动。
后续扩展功能配置，为尽快完成基础搭建可暂时略过：
- 选择 Skip for now 跳过渠道配置。
- 搜索引擎服务可选择 Kimi (Moonshot) 启用联网搜索能力。
- 技能配置选择 No。
- 钩子（Hooks）启用选择 Skip for now。
配置完成后，终端会打印 Control UI 的控制台网址及生成的安全访问 Token。
启动网关服务并进入可视化界面
配置完成后需手动启动网关服务，指定监听端口为 18789：
openclaw gateway --port 18789
终端将刷新日志，表明网关已绑定端口。在浏览器地址栏输入 （若是服务器请替换为公网 IP），即可打开聊天页面与 AI 助手交互。
