本文手把手带你在一台 VPS 上用 Docker 部署 OpenClaw，让你的 AI 助手全天候在线，随时通过 WhatsApp、Telegram 等渠道与你对话。
服务器选购建议
OpenClaw 本身是轻量级网关，不运行模型推理，所以对硬件要求不高。以下是推荐配置：
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| CPU | 1 vCPU | 2 vCPU |
| 内存 | 1 GB | 2 GB |
| 硬盘 | 10 GB SSD | 20 GB SSD |
| 带宽 | 1 TB/月 | 不限流量 |
| 系统 | Ubuntu 22.04+ | Ubuntu 24.04 LTS |
热门 VPS 供应商推荐：
- Hetzner（推荐）：CX22 套餐约 €4.15/月，2 vCPU + 4GB RAM，性价比极高，欧洲机房延迟稳定
- DigitalOcean：$6/月起，适合北美用户
- Vultr：$6/月起，全球多机房
- Contabo：€4.99/月起，配置高但网络一般
- 腾讯云/阿里云轻量：国内用户可选，但需注意海外 API 访问问题
💡 提示：如果你主要使用 Anthropic / OpenAI API，选择美国或欧洲机房延迟更低。国内机房可能需要额外配置代理。
Docker 安装
SSH 连接到你的服务器后，执行以下命令安装 Docker：
# 更新系统包sudo apt update && sudo apt upgrade -y # 安装 Docker（官方一键脚本）curl -fsSL https://get.docker.com | sh # 将当前用户加入 docker 组（免 sudo）sudo usermod -aG docker $USER # 重新登录使权限生效exit# 重新 SSH 连接 # 验证安装docker --versiondocker compose version确认 docker compose 命令可用（Docker 新版本自带 Compose V2 插件）。
克隆 OpenClaw 仓库
# 创建工作目录mkdir -p /opt/openclaw && cd /opt/openclaw # 克隆仓库git clone https://github.com/anthropics/openclaw.git .仓库中包含了 docker-compose.yml 和相关配置模板。
docker-compose 配置
OpenClaw 提供了开箱即用的 Docker Compose 配置。查看并根据需要调整：
# docker-compose.ymlversion: "3.8" services: openclaw: image: ghcr.io/anthropics/openclaw:latest container_name: openclaw restart: unless-stopped ports: - "127.0.0.1:4100:4100" # Gateway API（仅本地访问） - "127.0.0.1:4101:4101" # Web UI volumes: - ./data:/root/.openclaw # 持久化数据 - /var/run/docker.sock:/var/run/docker.sock # 沙箱支持 env_file: - .env environment: - TZ=Asia/Shanghai # 时区设置⚠️ 安全提示：端口绑定到
127.0.0.1而不是0.0.0.0，避免直接暴露到公网。通过 SSH 隧道或反向代理访问。
环境变量设置
创建 .env 文件配置关键参数：
# .env 文件 # === AI 模型 API ===ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx# 或使用 OpenAI# OPENAI_API_KEY=sk-xxxxxxxxxxxxx # === 渠道配置 ===# Telegram BotTELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-xxxxx # WhatsApp（使用内置 Baileys 桥接）# 启动后扫码配对，无需额外 token # Discord# DISCORD_BOT_TOKEN=xxxxxxxxxxxxx # === 可选配置 ===# 默认模型# OPENCLAW_DEFAULT_MODEL=claude-sonnet-4-20250514 # Web 搜索# BRAVE_API_KEY=xxxxxxxxxxxxx # TTS 语音# ELEVENLABS_API_KEY=xxxxxxxxxxxxx# 设置文件权限，保护 API 密钥chmod 600 .env持久化存储
Docker 卷映射 ./data:/root/.openclaw 确保以下数据在容器重启后保留：
data/├── workspace/ # Agent 工作空间│ ├── SOUL.md # AI 人格定义│ ├── MEMORY.md # 长期记忆│ ├── memory/ # 每日记忆│ └── ...├── config.yaml # 全局配置├── agents/ # Agent 配置├── channels/ # 渠道状态（WhatsApp session 等）└── skills/ # 已安装的 Skill备份建议：
# 定期备份数据目录tar czf openclaw-backup-$(date +%Y%m%d).tar.gz ./data # 或使用 cron 自动备份crontab -e# 添加：每天凌晨3点备份# 0 3 * * * cd /opt/openclaw && tar czf /backups/openclaw-$(date +\%Y\%m\%d).tar.gz ./data启动与管理
# 启动（后台运行）docker compose up -d # 查看日志docker compose logs -f # 重启docker compose restart # 停止docker compose down # 更新到最新版本docker compose pulldocker compose up -d启动后，OpenClaw Gateway 会在 localhost:4100 运行。
SSH 隧道访问
由于端口仅绑定到本地，你需要通过 SSH 隧道从本机访问 Web UI：
# 在你的本地电脑执行（不是服务器上）ssh -L 4101:localhost:4101 -L 4100:localhost:4100 user@your-server-ip # 然后在浏览器打开# http://localhost:4101使用 VS Code Remote SSH： 如果你用 VS Code 的 Remote SSH 连接服务器，端口会自动转发，更方便。
使用反向代理（进阶）： 如果需要公网访问，可配置 Nginx + Let’s Encrypt：
server { listen 443 ssl; server_name openclaw.yourdomain.com; ssl_certificate /etc/letsencrypt/live/openclaw.yourdomain.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/openclaw.yourdomain.com/privkey.pem; location / { proxy_pass http://127.0.0.1:4101; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; }}渠道配置
Telegram Bot
- 在 Telegram 中找到 @BotFather ，发送
/newbot创建机器人 - 复制获得的 Token 填入
.env的TELEGRAM_BOT_TOKEN - 重启 OpenClaw：
docker compose restart - 向你的 Bot 发送消息即可开始对话
WhatsApp 配对
OpenClaw 内置了 WhatsApp Web 桥接（基于 Baileys）：
- 启动 OpenClaw 后，查看日志中的 QR 码：
docker compose logs -f | grep -A 20 "QR" - 打开手机 WhatsApp → 设置 → 关联设备 → 扫描二维码
- 配对成功后，session 数据会持久化，重启无需重新扫码
💡 注意：WhatsApp 会话可能在 14 天左右失效，需要重新扫码。建议定期检查连接状态。
Discord Bot
- 在 Discord Developer Portal 创建 Application
- 进入 Bot 页面，复制 Token
- 开启 Message Content Intent
- 生成邀请链接，将 Bot 加入你的服务器
- 在
.env中设置DISCORD_BOT_TOKEN
常见问题
Q: 容器启动后立刻退出怎么办？
# 查看退出日志docker compose logs --tail 50 # 常见原因：# 1. .env 文件格式错误（不要有多余空格）# 2. API Key 无效# 3. 端口被占用Q: WhatsApp 扫码后仍无法收发消息？
- 确认手机 WhatsApp 版本是最新的
- 检查服务器能否访问 WhatsApp 的 WebSocket 服务器
- 查看日志中是否有连接错误
Q: 如何设置 AI 人格？
编辑 data/workspace/SOUL.md 文件：
cat > data/workspace/SOUL.md << 'EOF'# 你的名字 你是一个友善、专业的 AI 助手。 ## 性格特点- 温暖亲切，偶尔幽默- 回答简洁但有深度- 主动提供有价值的信息 ## 技能- 中英双语流利- 熟悉技术领域EOFQ: 如何监控 OpenClaw 运行状态？
# 查看容器状态docker compose ps # 查看资源使用docker stats openclaw # 简单的健康检查脚本curl -s http://localhost:4100/health || echo "OpenClaw is down!"Q: 如何升级 OpenClaw？
cd /opt/openclawdocker compose pull # 拉取最新镜像docker compose up -d # 重建容器docker image prune -f # 清理旧镜像数据目录挂载在宿主机上，升级不会丢失配置和记忆。
© 版权声明
文章版权归作者所有，未经允许请勿转载。
相关文章
暂无评论...