Openclaw 私有化部署

OpenClaw 部署流程

一、环境要求

系统：Ubuntu 20.04+/macOS 12+/Windows 10+（64位，支持 WSL2）
Node.js：v22.0.0+（必须）
内存：≥2GB（最低），推荐≥4GB
磁盘：≥10GB 可用空间
网络：可访问外网（国内用户建议使用加速镜像）

二、一键安装（推荐，全自动配置）

2.1 Linux / macOS / WSL2

国际版（海外服务器）

curl -fsSL https://openclaw.ai/install.sh | bash

国内加速版（国内服务器/本地，解决下载慢）

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

2.2 Windows（PowerShell 管理员）

右键开始菜单，选择「终端(管理员)」或「PowerShell(管理员)」，执行：

国际版

iwr -useb https://openclaw.ai/install.ps1 | iex

国内加速版

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

2.3 验证安装

openclaw --version
# 输出版本号（如 v2026.4.1）即成功

三、包管理器手动安装（开发者可选）

适合已自行配置好 Node.js 环境的用户。

3.1 npm 安装

# 国内用户先换源（必做，解决安装慢）
npm config set registry https://registry.npmmirror.com

# 全局安装
npm install -g openclaw@latest

# 如遇 libvips 冲突报错（Sharp 构建错误），加环境变量重试
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

3.2 pnpm 安装

pnpm add -g openclaw@latest
# pnpm 需要显式批准包含构建脚本的包
pnpm approve-builds -g

四、Docker 部署（服务器生产环境推荐）

4.1 使用 Docker Compose（一键启停，推荐）

1. 创建配置文件

mkdir -p ~/openclaw/{config,data}
cd ~/openclaw

# 创建 docker-compose.yml
cat > docker-compose.yml <<EOF
version: &#39;3.8&#39;
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: always
    ports:
      - "18789:18789"
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    environment:
      - ANTHROPIC_API_KEY=sk-ant-xxx  # 替换为你的 API Key
      - OPENAI_API_KEY=sk-xxx         # 可选，其他模型 Key
EOF

2. 启动容器

docker compose up -d

3. 验证状态

docker compose ps
# 显示 Up 10 seconds 即为成功

4.2 传统 Docker Run 方式

docker pull openclaw/openclaw:latest

docker run -d \
  --name openclaw \
  --restart=always \
  -p 18789:18789 \
  -v ~/openclaw/config:/app/config \
  -v ~/openclaw/data:/app/data \
  -e ANTHROPIC_API_KEY=sk-ant-xxx \
  openclaw/openclaw:latest

五、阿里云一键部署（国内新手首选）

无需手动配置环境，开箱即用：

前往阿里云 OpenClaw 专题页
选择轻量应用服务器，镜像选择 OpenClaw(Moltbot)
实例配置：选择 2核2G 及以上配置
购买完成后，在实例详情页：

放行 18789 端口（防火墙一键放通）
配置你的大模型 API Key（如阿里云百炼、通义千问）
生成访问 Token，即可直接访问控制台

六、初始化配置（核心必做步骤）

安装完成后，必须执行初始化向导完成配置：

openclaw onboard --install-daemon

向导步骤（按提示操作）

风险确认：输入 Yes 确认了解权限风险
安装模式：选择 quickstart（快速启动，推荐）
配置处理：首次安装选择默认即可
模型配置：

海外用户：直接输入 Claude/OpenAI 等 API Key
国内用户：可先选 Skip for now，后续在控制台配置文心一言/通义千问/月之暗面等

通道配置：如需对接飞书/企业微信，可在此配置，也可后续跳过
技能配置：按空格选择需要预装的常用技能，回车确认

七、启动与访问

7.1 启动网关服务

openclaw gateway start

7.2 打开 Web 控制台

openclaw dashboard
# 自动打开浏览器访问：http://127.0.0.1:18789
# 服务器部署请替换为服务器公网 IP 访问

7.3 健康检查

# 检查服务状态
openclaw gateway status

# 一键诊断环境问题
openclaw doctor

八、开机自启配置（Linux 服务器）

配置 systemd 服务，实现开机自动启动 OpenClaw：

sudo tee /etc/systemd/system/openclaw.service <<EOF
[Unit]
Description=OpenClaw Gateway Service
After=network.target

[Service]
ExecStart=/usr/bin/openclaw gateway start
Restart=always
User=root
WorkingDirectory=/root

[Install]
WantedBy=multi-user.target
EOF

# 重载配置并启用自启
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

九、常用运维命令

# 服务启停
openclaw gateway start   # 启动
openclaw gateway stop    # 停止
openclaw gateway restart # 重启

# 日志查看
openclaw logs --tail 100 # 查看最近100行日志
openclaw logs -f         # 实时跟踪日志

# 配置管理
openclaw config get      # 查看当前配置
openclaw config set key=value # 修改配置项

# 模型管理
openclaw models status --probe # 检查所有模型连通性

十、常见问题排查

1. Node.js 版本过低

# 升级到 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install nodejs -y

2. 国内安装/下载速度慢

# npm 换源
npm config set registry https://registry.npmmirror.com
# 使用国内一键安装脚本（见第二章）

3. 端口 18789 被占用

# 查看占用进程
lsof -i :18789
# 杀死占用进程
kill -9 <PID>

4. Sharp 构建错误（libvips 冲突）

# 安装时忽略全局 libvips
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

5. 启动后无法访问控制台

检查服务器防火墙是否放行 18789 端口
检查服务状态：openclaw gateway status
查看错误日志：openclaw logs