Ubuntu + 宝塔部署 OpenClaw（源码开发版）完整教程

# OpenClaw 源码开发版宝塔部署教程（Ubuntu + 宝塔）
![](https://img.cxhao.com/2026/03/20260322163131923.jpeg)
OpenClaw是一款开源AI智能体平台，主打“用自然语言指挥电脑”，能作为你的私有化“数字员工”完成真实任务‌。它不仅能聊天，更能动手操作——读写文件、控制浏览器、处理邮件、自动化办公流程，所有操作均支持本地部署，保障隐私安全。

## 一、准备条件

- 服务器：2核4G起步（推荐4核8G）
- 系统：Ubuntu 22.04
- 宝塔面板已安装
- 域名已解析到服务器（可选但推荐）

---

## 二、在宝塔安装基础软件

在宝塔软件商店安装：
1. **Nginx**
2. **PM2管理器**（可选，后面我们主要用 OpenClaw daemon）
3. **Node.js管理器**（如果有）

> 若宝塔里 Node 版本太旧，建议命令行手动装 Node 20 LTS。

---

## 三、命令行安装 Node.js / pnpm /（可选）bun

SSH 登录服务器（宝塔终端也可以）：

```bash
# 1) Node.js 20 LTS
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs

# 2) pnpm
corepack enable
corepack prepare pnpm@latest --activate
pnpm -v

# 3) 可选 bun（仅你要直接运行TS时可能用到）
curl -fsSL https://bun.sh/install | bash
```

---

## 四、拉取 OpenClaw 源码并构建

建议放在固定目录，例如 `/www/wwwroot/openclaw`：

```bash
mkdir -p /www/wwwroot
cd /www/wwwroot
git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build
pnpm build
```

---

## 五、初始化并安装守护进程（官方方式）

```bash
cd /www/wwwroot/openclaw
pnpm openclaw onboard --install-daemon
```

这一步通常会做：
- 初始配置生成
- 安装 daemon（守护进程）
- 让 OpenClaw 具备后台运行能力

---

## 六、启动开发热更新模式（开发环境）

```bash
cd /www/wwwroot/openclaw
pnpm gateway:watch
```

> 这是开发循环模式，源码/配置改动会自动重载。
> **注意**：生产对外不建议长期用 watch 模式，建议使用 `pnpm build` 后的稳定运行方式。

---

## 七、宝塔配置反向代理（对外访问）

### 1）在宝塔新建站点
- 网站 -> 添加站点
- 域名填：`claw.yourdomain.com`
- PHP 版本可选“纯静态”/不使用

### 2）设置反向代理
在站点设置里添加反向代理：
- 代理名称：`openclaw`
- 目标 URL：`http://127.0.0.1:3000`（按 OpenClaw 实际端口修改）
- 保留 Host：开启

### 3）申请 SSL
- 宝塔站点 -> SSL -> Let’s Encrypt -> 一键申请
- 开启“强制HTTPS”

---

## 八、放行端口与防火墙

确保已放行：
- 22（SSH）
- 80（HTTP）
- 443（HTTPS）
- 3000（仅本机调试可开放；正式建议仅走 Nginx，不对公网开放 3000）

---

## 九、开机自启（两种方式）

### 方式A（推荐）：用官方 daemon
你已经执行了：
```bash
pnpm openclaw onboard --install-daemon
```
通常已自动注册服务。可用以下检查：

```bash
systemctl list-unit-files | grep -i openclaw
systemctl status openclaw --no-pager
```

### 方式B：用 PM2（备选）
如果你想用 PM2 托管 watch：

```bash
npm i -g pm2
cd /www/wwwroot/openclaw
pm2 start "pnpm gateway:watch" --name openclaw-watch
pm2 save
pm2 startup
```

---

## 十、生产建议（非常重要）

你给的是“官方开发版部署”，若要正式对外：
1. 不建议长期跑 `gateway:watch`
2. 使用 `pnpm build` 后跑 `dist`（更稳、资源更低）
3. 配置日志轮转与监控
4. 做数据库/配置备份
5. 做限流、防刷、鉴权和管理员权限分离

---

## 十一、常见问题排查

### 1）`pnpm: command not found`
```bash
corepack enable
corepack prepare pnpm@latest --activate
```

### 2）`ui:build` 失败
- 网络拉包慢：配置 npm/pnpm 镜像
- 内存不足：加 swap 或升级配置

### 3）反代后 502
- OpenClaw 没监听到 127.0.0.1:3000
- 端口填错
- 进程没启动

先查：
```bash
ss -lntp | grep 3000
```

### 4）权限问题
```bash
chown -R www:www /www/wwwroot/openclaw
```
（如果你用 root 跑服务则按实际用户调整）

---

上一篇：CentOS + 宝塔部署 OpenClaw（源码开发版）完整教程下一篇：OpenClaw 对接数字先锋 API模型实战教程