OpenClaw 下载安装教程（详细版）

最近不少朋友在问：OpenClaw 怎么安装？难不难？会不会一顿操作猛如虎，结果报错两小时？

放心，这篇文章就是给“想快速上手”和“喜欢折腾源码”的朋友准备的完整教程。步骤不绕弯子，按顺序来，基本不会踩坑。

一、OpenClaw 是什么？

OpenClaw 是一个开源工具，主打轻量、可扩展、支持多种安装方式。不论你是普通用户，还是喜欢研究源码的开发者，它都准备了对应的安装姿势。

简单一句话：
懒人有懒人装法，技术流有技术流装法。

二、安装前准备

在开始之前，请确认：

• 系统为 macOS / Linux / Windows（支持 WSL）

• 已安装 curl

• 如果用 npm 安装，需要提前安装 Node.js（建议 LTS 版本）

不知道自己有没有安装？终端输入：

node -v

能看到版本号说明没问题。

三、方式一：一行命令安装（推荐）

适合人群：

想最快用起来，不想折腾。

直接在终端运行：

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

特点：

• 自动完成安装

• 适配大多数系统

• 基本不用管细节

执行完成后，测试是否安装成功：

openclaw --version

有输出版本号，就说明安装成功。

说白了，这就是“闭眼装法”。

四、方式二：使用 npm 安装

适合人群：

• 已安装 Node.js

• 熟悉 npm 环境

• 想用全局命令方式管理

第一步：安装 OpenClaw

npm i -g openclaw

第二步：初始化

openclaw onboard

官方把这个步骤叫“Meet your lobster”，名字挺可爱，意思就是初始化环境。

如果命令能正常执行，说明安装成功。

五、方式三：源码安装（开发者专用）

适合人群：

• 喜欢看源码

• 想自己控制安装过程

• 需要定制版本

使用：

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

这个参数会使用 git 方式安装。

优点：

• 可自行修改源码

• 更适合开发环境

• 可参与项目贡献

如果你平时没事就爱翻代码，那这一种会更对胃口。

六、macOS 用户安装方式

macOS 用户也可以直接通过 GitHub 下载最新版本：

官方地址：https://github.com/openclaw

GitHub 上的 OpenClaw Releases 页面

访问：https://github.com/openclaw/openclaw/releases

OpenClaw 官方仓库 Releases

选择最新版本下载安装即可。

下载后根据系统提示完成安装。

七、常见问题排查

1️⃣ 提示 curl 不存在

解决方法：

sudo apt install curl

或者 macOS 使用：

brew install curl

2️⃣ npm 权限错误

尝试：

npm config set prefix ~/.npm-global

或者使用：

sudo npm i -g openclaw

（不推荐长期使用 sudo）

3️⃣ 命令找不到

检查 PATH 是否包含 npm 全局目录：

npm root -g

确认该路径已加入环境变量。

八、哪种安装方式最合适？

说句实在话：
如果不是要改源码，一行命令那种真的省心。

九、总结

OpenClaw 的安装并不复杂，关键是选对方式。

• 想省事：一行命令

• 想用 npm：全局安装

• 想折腾源码：git 方式

• 想图形界面：GitHub Release 下载

别拖延，直接装起来试试。
工具这种东西，不用永远只是“听说很好用”。

如果过程中遇到报错，先别慌，大部分问题都和权限或环境变量有关。冷静排查，基本都能解决。

—— 家兴网络