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

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

与传统AI（如ChatGPT）仅输出建议不同，OpenClaw实现了从“对话”到“执行”的跨越，具备系统级操作权限，可在个人电脑或企业服务器上自动完成复杂任务。以下是它在不同场景下的核心能力：

1. 个人效率提升
‌文件管理‌：指令“整理桌面文档，按类型分类”→自动创建文件夹并归类文件；
‌邮件处理‌：指令“标记今天收到的未读邮件，并回复‘已收到’”→批量操作收件箱；
‌日程提醒‌：指令“每周五下午3点提醒我提交周报”→自动设置日历提醒；
‌数据整理‌：直接上传Excel，问“按月份看销售趋势”→自动分析并生成图表与洞察。
2. 办公与企业自动化
‌客服响应‌：接入飞书/企业微信，自动回复常见问题（如“如何退货？”），复杂问题转人工；
‌金融风控‌：监控交易数据，指令“若单笔转账超过10万元，发送预警至风控群”→实时拦截风险；
‌研发协作‌：指令“拉取最新代码库，运行单元测试，并将结果发送至团队频道”→自动化CI/CD流程；
‌市场分析‌：指令“分析本月社交媒体数据，生成包含用户画像的PPT”→自动生成报告。
3. 开发者扩展能力
‌自定义技能（Skills）‌：通过低代码平台开发专属功能，如“自动抓取竞品价格并生成对比表”；
‌多模型协同‌：同时调用Claude（逻辑推理）和文心一言（中文理解）完成复杂任务；
‌跨平台集成‌：对接OA、CRM系统，实现“一句话调取客户信息”；
‌浏览器自动化‌：控制Chrome自动填写表单、提取网页数据，处理报销、预约等事务。
4. 智能生活管理
‌智能设备控制‌：通过WhatsApp或Telegram远程控制Philips Hue灯光、Home Assistant等智能家居；
‌健康监测‌：从可穿戴设备拉取健康数据，每日生成体征报告；
‌主动提醒‌：记住你的习惯，主动提示“电池电量低于20%，建议充电”或“会议将在10分钟后开始”。
> 适用：CentOS 7/8/9（含 Rocky/Alma 思路类似）
> 默认项目目录：`/www/wwwroot/openclaw`
> 默认网关端口示例：`3000`（以实际为准）

---

## 0）先决条件

- 已安装宝塔面板
- 域名已解析到服务器（如 `claw.example.com`）
- 你有 root 权限

---

## 1）系统基础环境

```bash
# CentOS 7/8/9 通用基础包
yum install -y epel-release
yum install -y git curl wget vim tar unzip
```

---
OpenClaw 要求 >=22.16.0
可在宝塔JS管理器安装并设置命令行版本

![](/uploads/editor/20260323/img_69c127bb5c18e5.22562917.png)

## 2）安装 Node.js 22 + pnpm

```bash
# 安装 Node.js 22（NodeSource）
# 安装 nvm（若未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
# 安装并启用 Node 22
nvm install 22
nvm use 22
nvm alias default 22
# 检查
node -v
npm -v

# 检查版本
node -v
npm -v

# 启用 corepack 并安装 pnpm
corepack enable
corepack prepare pnpm@latest --activate

# 检查 pnpm
pnpm -v
```

> 如果 `corepack: command not found`，执行：
```bash
npm i -g corepack
corepack enable
corepack prepare pnpm@latest --activate
pnpm -v
```

---

## 3）拉取 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
```

---

## 4）官方初始化（安装 daemon）

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

---

## 5）先本机启动验证（开发热更新）

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

看到启动日志后，先别关终端，另开一个 SSH 窗口测试端口：

```bash
ss -lntp | grep 3000
```

> 如果不是 3000，请记住实际端口，后面宝塔反代要填这个端口。

---

## 6）放行防火墙端口（firewalld）

```bash
systemctl enable firewalld --now

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --permanent --add-port=22/tcp

# 若你临时需要公网直连测试 3000 再放开；正式建议不开放
# firewall-cmd --permanent --add-port=3000/tcp

firewall-cmd --reload
firewall-cmd --list-all
```

---

## 7）SELinux 放行（CentOS 常见 502 根因）

```bash
# 安装 semanage 工具（若未安装）
yum install -y policycoreutils-python-utils || yum install -y policycoreutils-python

# 允许 Nginx 反代回环端口
setsebool -P httpd_can_network_connect 1

# 查看 SELinux 状态
getenforce
```

---

## 8）宝塔里配置站点 + 反向代理

### 8.1 新建站点
- 宝塔面板 -> 网站 -> 添加站点
- 域名：`claw.example.com`
- PHP版本：纯静态即可
- 创建

### 8.2 配置反向代理
- 进入站点设置 -> 反向代理 -> 添加
- 代理名称：`openclaw`
- 目标URL：`http://127.0.0.1:3000`（按你的实际端口改）
- 发送域名（Host）通常默认/开启即可
- 保存并启用

### 8.3 配置 SSL
- 站点设置 -> SSL -> Let’s Encrypt
- 申请证书
- 开启“强制HTTPS”

---

## 9）用 systemd 托管（推荐，避免手工跑）

> 你已经执行过 `onboard --install-daemon`，但如果你想明确可控，这里给你手工 service（最稳）。

### 9.1 创建服务文件
```bash
cat > /etc/systemd/system/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw Gateway Watch
After=network.target

[Service]
Type=simple
WorkingDirectory=/www/wwwroot/openclaw
ExecStart=/usr/bin/pnpm gateway:watch
Restart=always
RestartSec=5
User=root
Environment=NODE_ENV=development

[Install]
WantedBy=multi-user.target
EOF
```

### 9.2 重新加载并启动
```bash
systemctl daemon-reload
systemctl enable openclaw
systemctl start openclaw
systemctl status openclaw --no-pager
```

### 9.3 看日志
```bash
journalctl -u openclaw -f
```

---

## 10）验证访问

1. 本机测试：
```bash
curl -I http://127.0.0.1:3000
```

2. 域名测试（外网）：
```bash
curl -I https://claw.example.com
```

---

## 11）常见问题（复制即用）

### A. 反代 502
```bash
# 1) 服务是否在跑
systemctl status openclaw --no-pager

# 2) 端口是否监听
ss -lntp | grep 3000

# 3) SELinux 放行
setsebool -P httpd_can_network_connect 1
```

### B. pnpm 命令找不到
```bash
npm i -g corepack
corepack enable
corepack prepare pnpm@latest --activate
```

### C. 构建内存不足
```bash
# 临时加 2G swap（低配机常用）
fallocate -l 2G /swapfile || dd if=/dev/zero of=/swapfile bs=1M count=2048
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
free -h
```

### D. Git 拉取慢
可先配置你常用镜像或代理，再重试 `pnpm install`。

---

## 12）生产建议（你这个是开发版，务必注意）

- `gateway:watch` 适合开发，不建议长期生产
- 生产建议跑 build 后产物（`dist`）+ 守护进程
- 不要把 3000 直接暴露公网（只让 Nginx 访问）
- 配置备份、日志轮转、限流、防刷、鉴权

---

上一篇：Embeddings（向量嵌入）下一篇：Ubuntu + 宝塔部署 OpenClaw（源码开发版）完整教程