OpenClaw 跨平台安装指南
这次我们来聊聊 OpenClaw 的安装全流程,从 Node.js 环境准备到完整配置。无论是 Ubuntu 还是 Windows,只要跟着步骤走,都能快速完成部署并成功运行。
Ubuntu 环境安装
对于开发者来说,Linux 环境往往是运行服务器和后台服务的首选。如果你还没有搭建好 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 的版本信息:
openclaw --version
初始化向导与大模型配置
OpenClaw 安装好之后还只是一个空壳,我们需要给它连接大模型。官方提供了一个交互式配置向导。
启动初始化向导并安装守护进程:
openclaw onboard --install-daemon
此时屏幕上会刷出一个巨大的由字符拼成的 OPENCLAW 图标,并且会弹出一段安全警告。
因为 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) 不动即可。
接下来的几个步骤是一些扩展功能的配置,为了尽快完成基础搭建,我们可以暂时略过: 在选择 Select channel 时,移动到最下方选择 Skip for now。
在选择 Search provider 时,我们可以顺手选择 ,让它具备联网搜索的能力。


