OpenClaw 安装超详细教程(新手友好,避坑指南)

OpenClaw是什么？前边已经专门编写了一篇文章来详细讲解过，可阅读之前文章

很多新手在Linux 系统上安装OpenClaw时，总会走很多弯路——环境冲突，网络问题等各种报错。

今天这篇教程，我会基于全新安装的Anolis OS 8.10（x86_64架构），带你完成OpenClaw的完整安装与初始化，全程标注新手易踩的坑和解决方案，确保你跟着做就能成功。

一、安装前必看：环境准备与系统要求

在开始安装前，我们先明确OpenClaw的核心系统要求，避免安装过程中反复踩坑。

1、OpenClaw系统要求

2、 环境检查（新手必做）

以 Anolis OS 8.10 为例：

先登录你的Linux服务器（推荐使用普通用户，避免全程root操作），执行以下命令检查基础环境：

# 1. 检查系统架构（确认是x86_64，与你的环境匹配）uname -m# 2. 检查系统版本cat /etc/os-release

3、更新系统

运行如下命令更新系统

sudo yum update -y

等待系统更新完毕。

二、分步实操：安装器部署OpenClaw

步骤1：确保系统有curl或wget

官方安装器需要通过curl或wget下载脚本，先检查是否已安装：

# 检查curl或wgetifcommand -v curl &> /dev/null; thenecho"[OK] curl已安装"elifcommand -v wget &> /dev/null; thenecho"[OK] wget已安装"elseecho"[!] 正在安装curl..."    sudo yum install -y curlfi

步骤2：安装Node(nodejs22.x+)

采用Node.js官方二进制包安装，完全绕开NodeSource脚本适配问题，步骤简单，且版本符合官方要求，以下命令均为实测成功命令，直接复制执行即可：

# 1. 下载Node.js 23.9.0官方二进制包（x86_64架构，适配Anolis 8.10）wget https://nodejs.org/dist/v23.9.0/node-v23.9.0-linux-x64.tar.xz# 2. 解压二进制包到系统目录（/usr/local/，默认系统级目录，所有用户可访问）sudo tar -xJf node-v23.9.0-linux-x64.tar.xz -C /usr/local/# 3. 配置环境变量，让系统识别node和npm命令echo'export PATH=/usr/local/node-v23.9.0-linux-x64/bin:$PATH' >> ~/.bashrc# 4. 刷新环境变量，立即生效source ~/.bashrc# 5. 验证安装结果（关键！必须显示以下版本）node -vnpm -v

✅ 成功输出：

[openclaw@localhost ~]$ node -vv23.9.0[openclaw@localhost ~]$ npm -v10.9.2

注意：若执行node -v未显示v23.9.0，关闭当前终端，重新打开一个终端再验证（环境变量需新终端完全生效）。

步骤3：安装（核心步骤！）

npm install -g openclaw@latest

查看OpenClaw版本

openclaw --version

无报错，看到上图版本，证明已经安装成功。

步骤4：完成新手引导

运行新手引导命令

openclaw onboard --install-daemon

选择 Yes 回车继续。

回车继续。

这里如果有相关平台的API，可以直接选择对应模型，绑定API即可。没有的话，可以直接选择千问Qwen。

OpenClaw 内置了Qwen Portal OAuth 免费通道，登录就是完成了官方授权(官方免费额度,新人快速安装体验使用)。

回车继续。

这时候会提示，进行Qwen认证，同时浏览器会打开千问Qwen认证页面，登录即可完整认证。

没有账号注册一个即可。

认证成功后，会自动调整至下一步，回车继续。

后续很多配置我们都跳过，如果需要使用相关配置，都可以进行二次配置。

键盘方向键上下选中 Skip for now 回车继续。

跳过，继续。

no，继续。

上下键移动，空格选中 继续。

选中 Open the Web UI 回车继续。

初始化完毕，就会自动打开OpenClaw的WEB UI浏览器界面。

可以看到，已经可以正常聊天了。

到这里OpenClaw就安装部署好了。

三、常用命令

以下是 OpenClaw 最常用的核心命令，按场景分类整理，方便快速查阅：

1、Gateway 网关管理（核心后台）

2、Channels 渠道管理（对接飞书/WhatsApp/Telegram等）

3、配置管理（改设置、加API Key）

4、健康检查与诊断（出问题时用）

5、工具与技能（扩展功能）

6、安全审计（定期检查）

7、其他实用命令

8、新手必记 Top 5 命令

1. openclaw gateway
    —— 启动核心后台
2. openclaw configure
    —— 改设置（加API、换模型）
3. openclaw status
    —— 快速看状态
4. openclaw doctor
    —— 出问题先跑这个
5. openclaw logs --follow
    —— 实时看日志找错

文 / 零距技术仓记录每一次真实的折腾 (#^.^#)🚀 想看到更多实用折腾技巧？👉 先关注💬 评论区说说你的经历或想看的内容👍 点赞表示支持🔁 顺手分享给也在折腾的人，让大家都少踩坑 😎