OpenClaw保姆级安装教程：基于ubuntu系统

本文整理了一份完整的 OpenClaw 安装教程，从 Node.js 环境搭建到 OpenClaw 的全面配置一应俱全。按照本指南操作，Ubuntu 用户可以轻松完成安装并顺利运行。

💨环境准备

在 Ubuntu 系统中，全程通过命令行完成安装。

第一步：配置 Node.js 运行环境为确保 OpenClaw 的兼容性与性能，建议使用Node.js 22.x版本。请获取并执行 NodeSource 提供的官方安装配置脚本，该脚本会自动完成所需软件源的设置：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

使用 apt 包管理器来安装最新版 nodejs（最新版openclaw需要安装v24，如果之前安装过旧版本的升级一下）

#安装nodejs apt-get install -y nodejs #安装之后，设置镜像为国内镜像 npm config set registry https://registry.npmmirror.com npm cache clean --force

安装完成后，我们必须验证一下环境是否真的搭建成功。在终端中输入查看版本的命令：

node -v

如果屏幕上看到了类似于v24.14.1这样的版本号输出，就ok了。

🍢OpenClaw安装与配置

我们需要把 OpenClaw 安装到全局环境中，这样你在任何目录下都可以直接用它。

在终端中执行以下安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后查看版本号

openclaw --version

初始化向导与大模型配置

因为 OpenClaw 拥有读取文件和执行命令的权限，系统会询问你是否了解这是一款默认面向个人的高权限工具。如果你是在自己的私人机器或虚拟机里运行，请放心地选择Yes继续。

接着选择向导模式，为了不被复杂的配置项淹没，我们直接选择绿色的QuickStart模式。

现在到了最核心的一步：选择大模型供应商。针对国内的网络环境和性价比考量，这里我们以 DeepSeek为例。使用键盘的上下方向键，选中Moonshot AI (Kimi K2.5)并回车。

在出现的提示行 Enter DeepSeek API key 后面，鼠标右键或者使用快捷键粘贴你之前申请好的 API Key，然后按下回车键确认。

在选择默认模型时，直接保持选中的Keep current (deepseek/deepseek-chat)不动即可。

接下来的几个步骤是一些扩展功能的配置，为了尽快完成基础搭建，我们可以暂时略过：在选择 Select channel 时，移动到最下方选择Skip for now。

在选择 Search provider 时，我们可以顺手选择Kimi (Moonshot)，让它具备联网搜索的能力。

系统询问是否现在配置 Configure skills now?，选择绿色的No。

询问是否启用 Enable hooks?，依然选择Skip for now。

经过这一系列问答，配置终于完成。终端会打印出 Control UI 的控制台网址以及专门为你生成的安全访问 Token。

🔨启动网关服务并进入可视化界面

通常配置完成后，我们需要手动把网关服务跑起来。使用以下命令启动服务，并指定监听端口为 18789：

openclaw gateway --port 18789

随后，你会在终端看到不断刷新的日志，这意味着网关已经成功绑定端口并开始监听请求了。

另外，如果不想日志输出，可以使用以下命令

pkill -9 -f openclaw sleep 2 nohup openclaw gateway > ~/openclaw.log 2>&1 & sleep 3 && openclaw dashboard --no-open

重启完成后，会得到一个新的地址，记住这个

如果是在本地，浏览器打开以上的网址

如果openclaw部署在远程服务器，

http://这里替换为你的服务器的ip:18789/#token=76ad1fb56.......