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 助手交互。


