如果你是第一次听说 OpenClaw,只需要记住一句话就够了:

OpenClaw 是一个可以跑在你自己电脑或服务器上的 AI 助手程序。

它和网页里的 ChatGPT 不一样:
它是一个长期运行的程序,可以一直开着,等你用、帮你做事。


这篇教程的目标只有一个:
👉 不报错、不理解原理也没关系,先把 OpenClaw 跑起来。

一、在开始之前,你需要准备什么?

你需要的只有 3 样东西

  1. 一台 Linux 服务器(推荐 Ubuntu)

    • 阿里云 / 腾讯云 / 国外 VPS 都行

    • 配置不用高:2 核 CPU + 4G 内存即可

  2. SSH 连接服务器

    • 用 Xshell / FinalShell / Termius 都可以

  3. 有耐心,一步一步照着来

⚠️ 不推荐 Windows,本教程以 Ubuntu 为例
⚠️ 不要跳步骤,OpenClaw 很“轴”


二、第一步:连上服务器

成功连上后,你会看到类似这样的界面:


root@server:~#

看到这个,就说明你已经可以开始了。


三、第二步:更新系统(必须做)

在服务器里输入:


sudo apt update

看到很多文字滚动是正常的,不要中断
完成后继续。


四、第三步:安装基础工具

OpenClaw 安装过程中会用到一些系统工具,直接一次装好:


sudo apt install -y git curl unzip

如果中途问你 Y/n,直接按 回车


五、第四步:安装 Node.js(非常关键)

👉 这一步没装对,后面一定会失败

1️⃣ 安装 nvm(Node 管理工具)

复制粘贴执行:


curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

执行完成后,运行:


source ~/.bashrc


2️⃣ 用 nvm 安装 Node 18


nvm install 18
nvm use 18


3️⃣ 检查是否安装成功


node -v
npm -v

如果你看到类似:


v18.x.x
9.x.x

✅ 恭喜,这一步完成
❌ 如果不是 18,请重新来一遍


六、第五步:安装 OpenClaw(最简单方式)

这里我们用最适合小白的方式:直接安装官方 CLI。

1️⃣ 安装 OpenClaw


npm install -g openclaw

等待安装完成(可能需要 1~2 分钟)。


2️⃣ 检查是否安装成功


openclaw --version

如果能看到版本号,说明 OpenClaw 已经装好了


七、第六步:初始化 OpenClaw(最容易卡的一步)

⚠️ 非常重要的一步,很多人失败都是因为跳过或中断这里

执行初始化命令:


openclaw onboard --install-daemon

这一步会发生什么?

  • 创建 OpenClaw 的运行配置

  • 启动核心服务(Gateway)

  • 把 OpenClaw 设置为后台常驻程序

中途如果有提示,直接按回车即可


八、第七步:检查 OpenClaw 是否真的跑起来了

1️⃣ 查看核心服务状态


openclaw gateway status

如果你看到类似:


status: running

✅ 恭喜,OpenClaw 已经在后台运行了


2️⃣ 如果不是 running,怎么办?

看日志:


openclaw gateway logs

一般小白最常见的原因是:

  • Node 版本不对

  • 上一步没执行完

  • 中途 Ctrl + C 了

👉 回到 第六步 重来一次即可


九、第八步:打开 OpenClaw 控制台(Dashboard)

OpenClaw 自带一个网页控制台,可以用来管理它。

启动 Dashboard:


openclaw dashboard

如果你看到类似提示:


Dashboard running on http://localhost:xxxx

说明 Dashboard 已启动。


如果你用的是服务器

你需要在浏览器里访问:


http://服务器IP:端口

如果打不开,记得:

  • 云服务器 安全组放行端口

  • 防火墙未拦截


十、第九步:你现在已经完成了什么?

到这里,你已经完成了:

  • ✅ 安装 Node.js

  • ✅ 安装 OpenClaw

  • ✅ 初始化 Agent

  • ✅ 启动核心服务

  • ✅ 打开管理界面

哪怕你完全不懂 Agent,这一步已经超过很多人了。


十一、什么是 Skill?小白怎么理解?

你可以这样理解:

Skill 就是 OpenClaw “能做的事列表”

比如:

  • 查信息

  • 发消息

  • 调用接口

  • 读取数据

OpenClaw 不会乱做事
它只能做你允许的 Skill。

刚开始,不用自己写 Skill
先学会“跑起来”就够了。


十二、常见错误合集(小白必看)

❌ 1. 提示 command not found

说明:

  • Node 没装好

  • npm 没生效

👉 回到 第五步


❌ 2. gateway status 不是 running

说明:

  • onboard 没跑完

  • 中途被打断

👉 回到 第六步


❌ 3. dashboard 打不开

检查:

  • 端口是否放行

  • 命令是否还在运行


十三、到这里,你已经是“会用 OpenClaw”的人了

你现在至少已经:

  • 知道 OpenClaw 是一个本地运行的 AI 程序

  • 知道怎么安装、启动、查看状态

  • 知道哪里出问题该看哪里

接下来才是进阶内容,比如:

  • 接入 Telegram

  • 添加 Skill

  • 自动执行任务

但这些都建立在 “你已经跑起来” 的基础上。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐