Ubuntu 环境安装
对于开发者而言,Linux 往往是运行后台服务的首选。如果你尚未搭建好 Ubuntu 系统,建议先完成基础环境配置后再继续。
部署 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 的版本号,说明地基已打好。
全局安装 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) 即可。
后续扩展功能配置可暂时略过:
- 渠道选择 Skip for now。
- 搜索引擎服务选择 Kimi (Moonshot) 以启用联网搜索。
- 技能配置选择 No。
- 钩子功能选择 Skip for now。
配置完成后,终端会打印出 Control UI 的控制台网址及生成的安全访问 Token。
启动网关服务并进入可视化界面
通常需手动启动网关服务,指定监听端口为 18789:
openclaw gateway --port 18789
终端会刷新日志,表明网关已绑定端口。在浏览器地址栏输入 http://127.0.0.1:18789/(若是服务器请替换为公网 IP),即可打开本地 AI 聊天控制台。




