CentOS系统 + 宝塔面板部署 OpenClaw源码开发版完整教程

OpenClaw是一款开源AI智能体平台，主打"用自然语言指挥电脑"，能作为你的私有化"数字员工"完成真实任务‌。它不仅能聊天，更能动手操作------读写文件、控制浏览器、处理邮件、自动化办公流程，所有操作均支持本地部署，保障隐私安全。

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

个人效率提升
‌文件管理‌：指令"整理桌面文档，按类型分类"→自动创建文件夹并归类文件；
‌邮件处理‌：指令"标记今天收到的未读邮件，并回复'已收到'"→批量操作收件箱；
‌日程提醒‌：指令"每周五下午3点提醒我提交周报"→自动设置日历提醒；
‌数据整理‌：直接上传Excel，问"按月份看销售趋势"→自动分析并生成图表与洞察。
办公与企业自动化
‌客服响应‌：接入飞书/企业微信，自动回复常见问题（如"如何退货？"），复杂问题转人工；
‌金融风控‌：监控交易数据，指令"若单笔转账超过10万元，发送预警至风控群"→实时拦截风险；
‌研发协作‌：指令"拉取最新代码库，运行单元测试，并将结果发送至团队频道"→自动化CI/CD流程；
‌市场分析‌：指令"分析本月社交媒体数据，生成包含用户画像的PPT"→自动生成报告。
开发者扩展能力
‌自定义技能（Skills）‌：通过低代码平台开发专属功能，如"自动抓取竞品价格并生成对比表"；
‌多模型协同‌：同时调用Claude（逻辑推理）和文心一言（中文理解）完成复杂任务；
‌跨平台集成‌：对接OA、CRM系统，实现"一句话调取客户信息"；
‌浏览器自动化‌：控制Chrome自动填写表单、提取网页数据，处理报销、预约等事务。
智能生活管理
‌智能设备控制‌：通过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

2）安装 Node.js 20 + pnpm

复制代码

bash 复制代码

# 安装 Node.js 20（NodeSource）
curl -fsSL https://rpm.nodesource.com/setup_20.x | bash -
yum install -y nodejs
# 检查版本
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）Linux 放行（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）验证访问

本机测试：
bash 复制代码
```
curl -I http://127.0.0.1:3000
```
域名测试（外网）：
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 访问）
配置备份、日志轮转、限流、防刷、鉴权

数字先锋 API 是一站式大模型云服务平台，聚合了 OpenAI、Claude、Gemini、DeepSeek、Grok、Qwen 等主流模型。如何在 OpenClaw 中接入数字先锋 API，统一调用平台模型能力可自己实战。

CentOS系统 + 宝塔面板 部署 OpenClaw源码开发版完整教程

0）先决条件

1）系统基础环境

2）安装 Node.js 20 + pnpm

3）拉取 OpenClaw 源码并构建

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

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

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

7）Linux 放行（CentOS 常见 502 根因）

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

8.1 新建站点

8.2 配置反向代理

8.3 配置 SSL

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

9.1 创建服务文件

9.2 重新加载并启动

9.3 看日志

10）验证访问

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

A. 反代 502

B. pnpm 命令找不到

C. 构建内存不足

D. Git 拉取慢

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

CentOS系统 + 宝塔面板部署 OpenClaw源码开发版完整教程