🐳 VPS 上 Docker 部署 OpenClaw 完整指南 私有 AI 助手一键搭建

OpenClaw 是一款个人 AI 助手框架，运行在你自己的设备上。本教程详细介绍如何在 VPS 上使用 Docker 部署 OpenClaw，包括环境配置、频道配对、常用维护命令和安全加固，助你轻松搭建私有 AI 助手。

🎤 引言：为什么要在 VPS 上部署 OpenClaw？

你有没有想过拥有一个完全私有的 AI 助手？

• 数据完全掌控在自己手中，无需担心隐私泄露
• 24 小时在线，随时响应你的请求
• 支持 Telegram、WhatsApp、Discord 等多个聊天平台
• 可自定义技能，扩展无限可能

OpenClaw 就是这样一款个人 AI 助手框架。今天给大家带来一份详细的 VPS Docker 部署指南，从零开始搭建属于你的私有 AI 助手。

📱 OpenClaw 是什么？

OpenClaw 是一款个人 AI 助手框架，运行在你自己的设备上。

项目地址：https://github.com/openclaw/openclaw

GitHub 数据：

• ⭐ Stars: 高人气开源项目
• 📜 许可证：MIT
• 🐳 Docker 支持：完整容器化部署
• 📅 持续维护：活跃开发中

核心特性：

1. 多平台支持 - Telegram、WhatsApp、Discord、Slack 等
2. Docker 部署 - 一键容器化，隔离运行
3. 技能扩展 - 自定义技能，无限扩展
4. 本地优先 - 数据本地存储，隐私安全
5. 多代理路由 - 隔离会话，独立上下文

一句话总结：如果你需要一个完全私有、可定制、多平台的 AI 助手，OpenClaw 是目前最佳选择。

🔥 VPS 选择与准备

1️⃣ VPS 推荐配置

推荐服务商：

• Hetzner（欧洲，性价比高）
• DigitalOcean（全球，易用）
• Vultr（全球，按需付费）
• AWS Lightsail（稳定，生态好）

2️⃣ 系统初始化

SSH 登录 VPS：

ssh root@your-vps-ip

更新系统：

apt update && apt upgrade -y

安装必要工具：

apt install -y curl wget git ufw

配置防火墙：

# 允许 SSH
ufw allow 22/tcp

# 允许 OpenClaw 控制 UI（可选）
ufw allow 18789/tcp

# 启用防火墙
ufw enable

🐳 Docker 环境安装

第一步：安装 Docker

一键安装脚本：

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

验证安装：

docker --version
docker compose version

第二步：配置 Docker 权限

添加当前用户到 docker 组：

usermod -aG docker $USER
newgrp docker

验证权限：

docker run hello-world

第三步：配置 Docker 镜像加速（可选）

编辑 Docker 配置：

cat > /etc/docker/daemon.json << EOF
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com"
  ]
}
EOF

重启 Docker：

systemctl restart docker

🚀 OpenClaw 部署流程

第一步：克隆项目

cd ~
git clone https://github.com/openclaw/openclaw.git
cd openclaw

第二步：运行部署脚本

一键部署（推荐）：

./docker-setup.sh

部署脚本会自动：

• 构建 OpenClaw 网关镜像
• 运行配置向导
• 生成网关令牌
• 启动 Docker Compose 服务

第三步：配置环境变量（可选）

安装额外 apt 包：

export OPENCLAW_DOCKER_APT_PACKAGES="ffmpeg build-essential"
./docker-setup.sh

挂载额外目录：

export OPENCLAW_EXTRA_MOUNTS="$HOME/.codex:/home/node/.codex:ro"
./docker-setup.sh

持久化容器家目录：

export OPENCLAW_HOME_VOLUME="openclaw_home"
./docker-setup.sh

第四步：获取访问令牌

生成仪表盘链接：

docker compose run --rm openclaw-cli dashboard --no-open

输出示例：

Dashboard URL: http://127.0.0.1:18789/
Token: abc123xyz789

在浏览器中打开 http://your-vps-ip:18789/，粘贴令牌即可访问控制 UI。

⚙️ 频道配置

Telegram 机器人配置

获取 Bot Token：

1. 在 Telegram 搜索 @BotFather
2. 发送 /newbot 创建机器人
3. 复制 Bot Token

配置 Telegram：

docker compose run --rm openclaw-cli channels add --channel telegram --token "YOUR_BOT_TOKEN"

WhatsApp 配置（二维码登录）

docker compose run --rm openclaw-cli channels login

扫描二维码即可完成配对。

Discord 机器人配置

获取 Bot Token：

1. 访问 Discord Developer Portal
2. 创建应用并获取 Bot Token

配置 Discord：

docker compose run --rm openclaw-cli channels add --channel discord --token "YOUR_BOT_TOKEN"

🛠️ 常用维护命令

查看服务状态

# 查看容器状态
docker compose ps

# 查看网关日志
docker compose logs -f openclaw-gateway

# 查看 CLI 日志
docker compose logs -f openclaw-cli

启动/停止服务

# 启动所有服务
docker compose up -d

# 停止所有服务
docker compose down

# 重启网关
docker compose restart openclaw-gateway

进入容器

# 进入网关容器
docker compose exec openclaw-gateway bash

# 进入 CLI 容器
docker compose exec openclaw-cli bash

更新 OpenClaw

# 拉取最新代码
cd ~/openclaw && git pull

# 重新构建并重启
docker compose down
docker build -t openclaw:local -f Dockerfile .
docker compose up -d

备份配置

# 备份配置文件
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# 备份到本地
scp root@your-vps-ip:~/openclaw-backup-*.tar.gz ./

健康检查

docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN"

查看设备列表

docker compose run --rm openclaw-cli devices list

批准设备配对

docker compose run --rm openclaw-cli devices approve <requestId>

清理无用资源

# 清理停止的容器
docker compose down --remove-orphans

# 清理未使用的镜像
docker image prune -f

# 清理未使用的卷
docker volume prune -f

查看资源使用

# 查看容器资源使用
docker stats

# 查看磁盘使用
docker system df

📊 性能优化

1️⃣ 内存优化

限制容器内存：

# docker-compose.yml
services:
  openclaw-gateway:
    deploy:
      resources:
        limits:
          memory: 2G

2️⃣ 日志轮转

配置 Docker 日志轮转：

# docker-compose.yml
services:
  openclaw-gateway:
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

3️⃣ 数据库优化

定期清理会话：

# 清理 30 天前的会话
docker compose run --rm openclaw-cli sessions prune --older-than 30d

🔒 安全加固

1️⃣ 配置 HTTPS（推荐）

使用 Nginx 反向代理：

apt install -y nginx certbot python3-certbot-nginx

Nginx 配置：

server {
    listen 80;
    server_name your-domain.com;
    
    location / {
        proxy_pass http://127.0.0.1:18789;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

申请 SSL 证书：

certbot --nginx -d your-domain.com

2️⃣ 配置 Tailscale（私有访问）

安装 Tailscale：

curl -fsSL https://tailscale.com/install.sh | sh

配置 Tailscale Serve：

export OPENCLAW_TAILSCALE_MODE="serve"
./docker-setup.sh

3️⃣ 令牌安全

定期更换网关令牌：

# 生成新令牌
docker compose run --rm openclaw-cli gateway token --rotate

# 更新 .env 文件

🎯 适用场景

强烈推荐：

• 🔒 隐私倡导者 - 不希望数据存储在第三方服务器
• 🤖 AI 爱好者 - 想要定制自己的 AI 助手
• 🏢 小团队 - 需要内部 AI 助手
• 🐍 Python 开发者 - 需要自动化助手

可以考虑：

• 📱 多平台用户 - 统一管理多个聊天平台
• 📊 数据分析师 - 自动化数据报告
• 🛠️ 运维工程师 - 自动化运维任务

📥 相关资源

官方渠道：

• GitHub：https://github.com/openclaw/openclaw
• 文档：https://docs.openclaw.ai
• Discord 社区：https://discord.gg/clawd

相关文档：

• Docker 部署指南
• VPS 部署（Hetzner）
• 安全指南
• 故障排除

📝 总结

OpenClaw 是一款功能强大的个人 AI 助手框架，通过 Docker 部署可以实现完全私有、隔离运行、易于维护。

优点：

• ✅ 完全私有，数据本地存储
• ✅ Docker 容器化，隔离运行
• ✅ 支持多平台（Telegram、WhatsApp、Discord 等）
• ✅ 技能扩展，无限可能
• ✅ 活跃的开源社区
• ✅ 详细的文档和示例

不足：

• ⚠️ 初次配置需要一定学习成本
• ⚠️ 需要自备 VPS 或服务器
• ⚠️ 部分功能需要额外配置

推荐指数：⭐⭐⭐⭐⭐（5/5）

如果你正在寻找一款完全私有、可定制、多平台的 AI 助手，OpenClaw 绝对值得一试。

下载链接：https://github.com/openclaw/openclaw

官方文档：https://docs.openclaw.ai

免责声明：本教程仅供教育和研究用途。请遵守当地法律和服务条款。