OpenClaw 跨平台安装指南
本文分享 OpenClaw 在 Windows 和 Ubuntu 上的完整部署流程。无论是 Linux 服务器还是本地开发机,都能按照本指南快速完成配置并成功运行。
Ubuntu 环境部署
Linux 环境是运行此类服务的首选。如果你尚未搭建好基础系统,建议先确保 Ubuntu 环境就绪,随后再按以下步骤操作。
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
此时会显示安全警告,确认是在个人机器或虚拟机中运行后,选择 Yes 继续。
进入向导模式,为简化配置,直接选择绿色的 QuickStart 模式。
接下来选择大模型供应商。针对国内网络环境,这里以 Kimi 为例,选中 Moonshot AI (Kimi K2.5) 并回车。
认证方式选择第一项标准的 Kimi API key (.ai)。
系统询问如何提供秘钥,选择 Paste API key now,直接在终端粘贴之前申请好的 API Key 并回车。
默认模型保持选中的 Keep current (moonshot/kimi-k2.5) 即可。
后续扩展功能暂时略过:
- 渠道选择 Skip for now。
- 搜索引擎服务选择 Kimi (Moonshot) 以启用联网搜索。
- 技能配置选择 No。
- 钩子启用选择 Skip for now。
配置完成后,终端会打印出 Control UI 的控制台网址及生成的安全访问 Token。
4. 启动网关服务
手动启动网关服务,指定监听端口为 18789:
openclaw gateway --port 18789
终端开始刷新日志即表示服务已绑定端口。在浏览器访问 http://127.0.0.1:18789/(若是远程服务器请替换为公网 IP),即可进入聊天界面。
Windows 系统部署
Windows 下结合图形化安装包与命令行即可完成部署。


