02B. OpenClaw 本地安装一键命令指南（Linux Ubuntu/Debian 版）

适用对象：第一次在 Ubuntu/Debian 上安装 OpenClaw 的新手 | 文档版本：V1.1 更新日期：2026 年 3 月 11 日 | 文档定位：OpenClaw Linux 最短安装路径，复制粘贴即可

---

其他安装方式

除了下面的手动脚本，社区还有这些一键安装工具：

• OpenClaw 官方一键脚本 — curl -fsSL https://openclaw.ai/install.sh | bash，macOS/Linux/WSL2 通用
• OpenClawInstaller (GUI) — 跨平台图形安装器，支持 npm 和 Docker 两种模式
• OpenClawInstaller by miaoxworld — 多平台多模型一键部署工具
• ClawHost — 一键云端部署，自动配置 VPS + DNS + SSL
• openclaw-deploy — Fly.io 免费部署，3 分钟上线
• install-openclaw-on-termux — 在 Android Termux 上部署 OpenClaw

---

先说结论

7 个步骤，全部复制粘贴，约 10 分钟完成。

---

一键安装脚本

打开终端，把下面整段复制粘贴进去，按回车执行：

#!/bin/bash
set -e

# 1. 安装基础依赖
sudo apt-get update
sudo apt-get install -y curl git build-essential ca-certificates

# 2. 安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 3. 配置 npm 镜像 + 全局目录
npm config set registry https://registry.npmmirror.com
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
grep -q 'npm-global' ~/.bashrc || echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
export PATH="$HOME/.npm-global/bin:$PATH"

# 4. 安装 OpenClaw
npm install -g openclaw@latest

# 5. 启动配置向导
openclaw onboard

提示：过程中需要输入 sudo 密码。onboard 完成后会给你一个 Web 控制台地址，在浏览器里打开测试即可。

---

如果你更习惯逐步操作，以下是分步说明：

---

第一步：安装基础依赖

sudo apt-get update
sudo apt-get install -y curl git build-essential ca-certificates

---

第二步：安装 Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

验证：

node --version

显示 v22.x.x 或更高就对了。

---

第三步：配置 npm

npm config set registry https://registry.npmmirror.com
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

---

第四步：安装 OpenClaw

npm install -g openclaw@latest

验证：

openclaw --version

---

第五步：运行配置向导

openclaw onboard

• 模型：先选 MiniMax M2.5 或 DeepSeek
• 聊天渠道：先跳过
• Skills：先跳过
• 网关服务：建议安装

---

第六步：安装推荐 Skills

推荐 Skills 请参考 09-OpenClaw-Skills-安装与推荐-通用说明.md

---

第七步：验证

在浏览器打开 onboard 给出的 Web 控制台地址，输入：

你好，你是谁？

收到回复，恭喜，安装成功！

---

最常见问题

Q1：安装时提示 permission denied 或 EACCES

配置用户级 npm 目录（第三步已包含），或参考 10-排障与维护。

Q2：openclaw: command not found

关掉终端重新打开。如果仍然报错，执行 source ~/.bashrc 后重试。

Q3：其他问题

参考 10-OpenClaw-排障与维护-通用说明。

---

装完了，接下来看哪里

你想做什么	看哪份文档
想比较不同模型	06-模型配置通用说明
想接飞书、Discord 等	08-聊天渠道通用说明
装好了但出错	10-排障与维护