OpenClaw宝塔面板安装：小白也能轻松上手

本地部署AI助手正在成为越来越多企业和开发者的选择，数据安全和定制灵活是主要驱动力。今天系统讲解OpenClaw的本地部署方案。

为什么要本地部署？

核心优势

• 数据隐私：所有数据存储在自己的服务器，不会经过第三方云服务
• 定制灵活：可以根据业务需求修改源码、添加自定义功能
• 成本可控：一次部署完成后，除了服务器成本外没有其他费用
• 离线可用：不依赖外部网络，在内网环境也能正常工作
• 性能稳定：不受云服务波动影响，响应速度稳定

适用场景

• 企业内部使用，有数据合规要求
• 对数据安全有较高要求的团队
• 开发者个人使用，需要定制化能力
• 需要在隔离网络环境运行的场景

部署方式对比

方式一：Docker 部署（推荐）

Docker 是最简单的部署方式，一条命令搞定：

# 基础部署
docker run -d -p 18789:18789 openclaw/openclaw

# 挂载数据卷（数据持久化）
docker run -d -p 18789:18789   -v /data/openclaw:/workspace   openclaw/openclaw

# 指定模型服务商
docker run -d -p 18789:18789   -e OPENAI_API_KEY=your_key   -v /data/openclaw:/workspace   openclaw/openclaw

方式二：宝塔面板一键部署

适合不熟悉命令行的用户：

1. 登录宝塔面板
2. 搜索「OpenClaw」或通过 Docker 管理器部署
3. 配置反向代理（可选，用于域名访问）
4. 配置 SSL 证书（推荐）

方式三：源码部署

# Node.js 环境（需要 Node.js >= 18）
npm install -g openclaw
openclaw gateway start

# 或从源码编译
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install && npm run build
npm start

详细部署步骤（Docker + 宝塔）

第一步：安装 Docker

# 宝塔面板 → 商店 → 搜索 Docker → 安装
# 安装完成后，启动 Docker 服务

第二步：拉取镜像

docker pull openclaw/openclaw:latest

第三步：创建容器

docker run -d   --name openclaw   -p 18789:18789   -v /www/openclaw:/workspace   --restart unless-stopped   openclaw/openclaw:latest

第四步：配置反向代理（可选）

通过域名访问，而不是IP:端口：

# 宝塔面板 → 网站 → 反向代理 → 添加反向代理
# 目标URL: http://127.0.0.1:18789
# 建议开启 SSL（Let's Encrypt 免费证书）

配置与优化

环境变量配置

OPENAI_API_KEY=sk-xxx        # OpenAI API Key
MINIMAX_API_KEY=sk-cp-xxx    # MiniMax API Key
WEB_SECRET=your_secret       # Web 管理界面密码
LOG_LEVEL=info               # 日志级别

资源规划建议

安全加固

• 修改默认端口：不要使用默认的18789，改用其他端口
• 配置防火墙：只开放必要端口，限制IP访问
• 启用 SSL：通过Let’s Encrypt免费申请证书
• 定期更新：关注安全公告，及时打补丁
• 备份配置：定期备份重要配置文件

常见问题排查

• 启动失败：检查端口是否被占用，netstat -tlnp | grep 18789
• 无法访问：检查防火墙规则，ufw status
• 内存不足：增加 swap 或升级服务器配置
• 数据丢失：检查数据卷挂载是否正确

本地部署让数据完全自主可控，是企业级使用的首选方案。官方部署文档 →

整理自 OpenClaw 官方文档 | 2026年05月06日